docs: sync walkthrough for release 8.1.0

2026-03-17 12:32:20 +01:00
parent e8a0250687
commit 428432a789
1 changed files with 28 additions and 171 deletions
--- a/docs/users/walkthrough.md
+++ b/docs/users/walkthrough.md
@@ -1,185 +1,42 @@
-# Walkthrough: Integration of PRs 35 & 36 (Release v3.5.0)
+# Walkthrough: Release v8.1.0 Maintenance Sweep

 ## Overview

-Integrated **PR #35** (Translation) and **PR #36** (New Community Contributors), enhancing documentation and expanding the skill registry.
+This walkthrough captures the maintainer-side documentation and release preparation work for **v8.1.0** after the 2026-03-17 PR merge batch.

 ## Changes Verified

-### 1. New Skills / Content
+### 1. Community PR batch integrated

- **PR #35**: Translated `daily-news-report` description to English.
- **PR #36**: Added `infinite-gratitude` and `claude-api-cost-optimization` to Community Contributors.
+- **PR #324**: Added `progressive-web-app`
+- **PR #325**: Added `vibers-code-review`
+- **PR #326**: Repaired invalid YAML frontmatter in existing skills
+- **PR #329**: Added `trpc-fullstack`
+- **PR #330**: Aligned FAQ risk labels and documented the active `skill-review` check
+- **PR #331**: Removed a broken reference from `skills/data-scientist/SKILL.md`

-### 2. Documentation Updates
+### 2. Release-facing docs refreshed

 - **README.md**:
-  - Updated generic skill count to **256+**.
-  - Updated `## Repo Contributors` list (synced with `git shortlog`).
-  - Bumped version to **v3.5.0**.
- **CHANGELOG.md**: Added release notes for v3.5.0.
+  - Current release updated to **v8.1.0**
+  - Release summary text aligned with the merged PR batch
+  - Contributor acknowledgements kept in sync with the latest merge set
+- **docs/users/getting-started.md**:
+  - Version header updated to **v8.1.0**
+- **docs/users/faq.md**:
+  - Active `skill-review` workflow guidance retained as the current contributor check
+- **CHANGELOG.md**:
+  - Added the release notes section for **8.1.0**

-### 3. Maintenance Protocols
+### 3. Release protocol to run

- **Validation Chain**:
-  - `validate_skills.py`: Verified (Note: Strict mode warns on legacy skills).
-  - `generate_index.py`: Regenerated `skills_index.json`.
-  - `update_readme.py`: Synced registry table.
- **Stats Check**: Confirmed 256 skills across `README.md` and `docs/GETTING_STARTED.md`.
+- `npm run release:preflight`
+- `npm run security:docs`
+- `npm run validate:strict` (diagnostic, optional blocker)
+- `npm run release:prepare -- 8.1.0`
+- `npm run release:publish -- 8.1.0`

-## Verification Results
+## Expected Outcome

- **Functional**: Skills are indexed and visible.
- **Protocol**: `MAINTENANCE.md` followed (Validation + Sync + Release).
-
-## Next Steps
-
- Release v3.5.0 is ready for deployment (`git push` & `git tag`).
-
---
-
-## Update 2026-01-28: Documentation Counts Sync
-
-## Overview
-
-Aligned documentation skill counts with the latest catalog total.
-
-## Changes Verified
-
-### 1. Documentation Updates
-
- **README.md**: Updated headline/intro counts to **552+** and synced the browse section label.
- **docs/GETTING_STARTED.md**: Updated references to **552** skills and pointed the registry link to `CATALOG.md`.
-
-### 2. Consistency Checks
-
- **TOC anchors**: Updated the browse anchor to match the new header.
-
---
-
-## Update 2026-01-28: Features Table & Repo Cleanup
-
-## Overview
-
-Added a precise category table in the README and reduced top-level clutter by moving onboarding docs into `docs/`.
-
-## Changes Verified
-
-### 1. Documentation Updates
-
- **README.md**: Replaced the category bullet list with a detailed table and updated the Getting Started link path.
- **docs/FAQ.md**: Updated skill counts and catalog links.
-
-### 2. Repository Organization
-
- Moved onboarding docs into `docs/`:
-  - `GETTING_STARTED.md` → `docs/GETTING_STARTED.md`
-  - `FAQ.md` → `docs/FAQ.md`
-  - `WALKTHROUGH.md` → `docs/WALKTHROUGH.md`
-# Walkthrough: SEO Optimization for Multi-IDE Visibility
-
-## Obiettivo
-
-Ottimizzare il posizionamento SEO del repository `antigravity-awesome-skills` per apparire nelle ricerche di tutti i principali strumenti di AI coding.
-
-## Strumenti Target
-
-| Strumento       | Badge | Status      |
-| --------------- | ----- | ----------- |
-| Claude Code     | 🟣    | ✅ Aggiunto |
-| Gemini CLI      | 🔵    | ✅ Aggiunto |
-| Codex CLI       | 🟢    | ✅ Aggiunto |
-| Antigravity IDE | 🔴    | ✅ Aggiunto |
-| GitHub Copilot  | 🩵    | ✅ Aggiunto |
-| Cursor          | 🟠    | ✅ Aggiunto |
-| OpenCode        | ⚪    | ✅ Aggiunto |
-
-## Modifiche Effettuate
-
-### 1. Titolo Aggiornato
-
-**Prima:**
-
-```
-# 🌌 Antigravity Awesome Skills: The Ultimate Claude Code Skills Collection
-```
-
-**Dopo:**
-
-```
-# 🌌 Antigravity Awesome Skills: 130+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More
-```
-
-### 2. Badge Aggiunti (7 totali)
-
-![Badges Preview](https://img.shields.io/badge/Claude%20Code-Anthropic-purple)
-![Badges Preview](https://img.shields.io/badge/Gemini%20CLI-Google-blue)
-![Badges Preview](https://img.shields.io/badge/Codex%20CLI-OpenAI-green)
-![Badges Preview](https://img.shields.io/badge/Cursor-AI%20IDE-orange)
-![Badges Preview](https://img.shields.io/badge/GitHub%20Copilot-VSCode-lightblue)
-![Badges Preview](https://img.shields.io/badge/OpenCode-CLI-gray)
-![Badges Preview](https://img.shields.io/badge/Antigravity-DeepMind-red)
-
-### 3. Nuova Sezione Compatibility
-
-Aggiunta tabella con percorsi di installazione per ogni strumento:
-
-| Tool            | Type      | Compatibility | Installation Path   |
-| --------------- | --------- | ------------- | ------------------- |
-| Claude Code     | CLI       | ✅ Full       | `.claude/skills/`   |
-| Gemini CLI      | CLI       | ✅ Full       | `.gemini/skills/`   |
-| Codex CLI       | CLI       | ✅ Full       | `.codex/skills/`    |
-| Antigravity IDE | IDE       | ✅ Full       | `.agent/skills/`    |
-| Cursor          | IDE       | ✅ Full       | `.cursor/skills/`   |
-| GitHub Copilot  | Extension | ⚠️ Partial    | `.github/copilot/`  |
-| OpenCode        | CLI       | ✅ Full       | `.opencode/skills/` |
-
-### 4. Keywords Ampliate
-
-**Prima:**
-
-```
-Claude Code, Antigravity, Agentic Skills, MCT, AI Agents, Autonomous Coding, Security Auditing, React Patterns.
-```
-
-**Dopo:**
-
-```
-Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode, Agentic Skills, AI Coding Assistant, AI Agent Skills, MCP, MCT, AI Agents, Autonomous Coding, Security Auditing, React Patterns, LLM Tools, AI IDE, Coding AI, AI Pair Programming, Vibe Coding, Agentic Coding, AI Developer Tools.
-```
-
-## Validazione
-
-```bash
-✅ Found and checked 132 skills.
-✨ All skills passed basic validation!
-```
-
-## GitHub Topics (Azione Manuale)
-
-Vai su https://github.com/sickn33/antigravity-awesome-skills e aggiungi questi topics:
-
-```text
-claude-code, gemini-cli, codex-cli, antigravity, cursor, github-copilot, opencode,
-agentic-skills, ai-coding, llm-tools, ai-agents, autonomous-coding, mcp,
-ai-developer-tools, ai-pair-programming, vibe-coding
-```
-
-## Commit
-
-```
-feat(SEO): optimize README for all AI coding tools (02fab35)
-```
-
-## Risultato Atteso
-
-Il repository dovrebbe ora apparire nelle ricerche GitHub per:
-
- "gemini cli skills"
- "claude code skills"
- "cursor skills"
- "codex cli skills"
- "copilot skills"
- "opencode skills"
- "agentic skills"
- "ai coding tools"
+- Documentation, changelog, and generated metadata all agree on the release state.
+- The repository is ready for the `v8.1.0` tag and GitHub release.