From 86ef921aeec5d3bb76ab33baded3ebb4b14929af Mon Sep 17 00:00:00 2001 From: sck_0 Date: Thu, 12 Mar 2026 13:00:38 +0100 Subject: [PATCH] docs: align evergreen docs with release state --- CHANGELOG.md | 1 + README.md | 4 ++-- docs/maintainers/audit.md | 2 +- docs/maintainers/skills-update-guide.md | 4 ++-- docs/users/bundles.md | 18 +++++++------- docs/users/faq.md | 22 ++++++++--------- docs/users/getting-started.md | 18 +++++++------- docs/users/kiro-integration.md | 2 +- docs/users/usage.md | 32 ++++++++++++------------- docs/users/visual-guide.md | 12 +++++----- walkthrough.md | 1 + 11 files changed, 59 insertions(+), 57 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 76460e94..55e9e9bd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## Documentation - Refreshed `README.md` release copy, star milestone badge, and TOC heading alignment so the top-level docs match the current `7.6.0` repository state. +- Aligned the evergreen English docs with the current `7.6.0` / `1,250+ skills` repository state and removed emoji from active H2 headers to keep anchors stable under the maintenance rules. ## [7.6.0] - 2026-03-12 - "Maintenance Sweep" diff --git a/README.md b/README.md index 876339e9..61a05ac1 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ - + # 🌌 Antigravity Awesome Skills: 1,250+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More > **The Ultimate Collection of 1,250+ Universal Agentic Skills for AI Coding Assistants β€” Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode, AdaL** @@ -209,7 +209,7 @@ Use @security-auditor to review this API endpoint for auth and validation risks. **Bundles** are curated groups of skills for a specific role or goal (for example: `Web Wizard`, `Security Engineer`, `OSS Maintainer`). -They help you avoid picking from 1,236+ skills one by one. +They help you avoid picking from 1,250+ skills one by one. ### ⚠️ Important: Bundles Are NOT Separate Installations! diff --git a/docs/maintainers/audit.md b/docs/maintainers/audit.md index f24b6d68..9737c8ff 100644 --- a/docs/maintainers/audit.md +++ b/docs/maintainers/audit.md @@ -15,7 +15,7 @@ This document summarizes the repository coherence audit performed after the `app ### 1. Conteggi -- `README.md`, `package.json`, and generated artifacts are aligned to the current collection size (`1,204+` skills). +- `README.md`, `package.json`, and generated artifacts are aligned to the current collection size (`1,250+` skills). - `npm run sync:all` and `npm run catalog` are the canonical commands for keeping counts and generated files synchronized. ### 2. Validazione skill diff --git a/docs/maintainers/skills-update-guide.md b/docs/maintainers/skills-update-guide.md index 236e015c..b556ddce 100644 --- a/docs/maintainers/skills-update-guide.md +++ b/docs/maintainers/skills-update-guide.md @@ -69,7 +69,7 @@ For manual updates, you need: The update process refreshes: - Skills index (`skills_index.json`) - Web app skills data (`apps\web-app\public\skills.json`) -- All 1,204+ skills from the skills directory +- All 1,250+ skills from the skills directory ## When to Update @@ -86,4 +86,4 @@ git pull origin main npm run update:skills ``` -This pulls the latest code and updates the skills data. \ No newline at end of file +This pulls the latest code and updates the skills data. diff --git a/docs/users/bundles.md b/docs/users/bundles.md index c794cf78..41d3be8e 100644 --- a/docs/users/bundles.md +++ b/docs/users/bundles.md @@ -1,8 +1,8 @@ -# πŸ“¦ Antigravity Skill Bundles +# Antigravity Skill Bundles > **Curated collections of skills organized by role and expertise level.** Don't know where to start? Pick a bundle below to get a curated set of skills for your role. -## πŸš€ Quick Start +## Quick Start 1. **Install the repository:** @@ -22,7 +22,7 @@ --- -## 🎯 Essentials & Core +## Essentials & Core ### πŸš€ The "Essentials" Starter Pack @@ -36,7 +36,7 @@ _For everyone. Install these first._ --- -## πŸ›‘οΈ Security & Compliance +## Security & Compliance ### πŸ›‘οΈ The "Security Engineer" Pack @@ -213,7 +213,7 @@ _For driving user acquisition and retention._ --- -## 🌧️ DevOps & Infrastructure +## DevOps & Infrastructure ### 🌧️ The "DevOps & Cloud" Pack @@ -417,7 +417,7 @@ Keep a small list of high-frequency skills and reuse it across tasks to reduce c --- -## πŸŽ“ Learning Paths +## Learning Paths ### Beginner β†’ Intermediate β†’ Advanced @@ -447,13 +447,13 @@ Keep a small list of high-frequency skills and reuse it across tasks to reduce c --- -## 🀝 Contributing +## Contributing Found a skill that should be in a bundle? Or want to create a new bundle? [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues) or submit a PR! --- -## πŸ“– Related Documentation +## Related Documentation - [Getting Started Guide](getting-started.md) - [Full Skill Catalog](../../CATALOG.md) @@ -461,4 +461,4 @@ Found a skill that should be in a bundle? Or want to create a new bundle? [Open --- -_Last updated: March 2026 | Total Skills: 1,204+ | Total Bundles: 26_ +_Last updated: March 2026 | Total Skills: 1,250+ | Total Bundles: 26_ diff --git a/docs/users/faq.md b/docs/users/faq.md index c9ca985a..2ce90085 100644 --- a/docs/users/faq.md +++ b/docs/users/faq.md @@ -1,21 +1,21 @@ -# ❓ Frequently Asked Questions (FAQ) +# Frequently Asked Questions (FAQ) **Got questions?** You're not alone! Here are answers to the most common questions about Antigravity Awesome Skills. --- -## 🎯 General Questions +## General Questions ### What are "skills" exactly? Skills are specialized instruction files that teach AI assistants how to handle specific tasks. Think of them as expert knowledge modules that your AI can load on-demand. **Simple analogy:** Just like you might consult different experts (a lawyer, a doctor, a mechanic), these skills let your AI become an expert in different areas when you need them. -### Do I need to install all 1,204+ skills? +### Do I need to install all 1,250+ skills? **No!** When you clone the repository, all skills are available, but your AI only loads them when you explicitly invoke them with `@skill-name`. It's like having a library - all books are there, but you only read the ones you need. -**Pro Tip:** Use [Starter Packs](bundles.md) to install only what matches your role. +**Pro Tip:** Use [Starter Packs](bundles.md) to focus on the skills that match your role first. ### What is the difference between Bundles and Workflows? @@ -67,7 +67,7 @@ The skill files themselves are stored locally on your computer, but your AI assi --- -## πŸ”’ Security & Trust (V4 Update) +## Security & Trust ### What do the Risk Labels mean? @@ -84,7 +84,7 @@ _Always check the Risk label and review the code._ --- -## πŸ“¦ Installation & Setup +## Installation & Setup ### Where should I install the skills? @@ -143,7 +143,7 @@ git pull origin main --- -## πŸ› οΈ Using Skills +## Using Skills > **πŸ’‘ For a complete guide with examples, see [usage.md](usage.md)** @@ -171,7 +171,7 @@ Use the `@` symbol followed by the skill name: --- -## πŸ—οΈ Troubleshooting +## Troubleshooting ### My AI assistant doesn't recognize skills @@ -192,7 +192,7 @@ Include: --- -## 🀝 Contribution +## Contribution ### I'm new to open source. Can I contribute? @@ -205,7 +205,7 @@ Include: ### My PR failed "Quality Bar" check. Why? -V4 introduces automated quality control. Your skill might be missing: +The repository enforces automated quality control. Your skill might be missing: 1. A valid `description`. 2. Usage examples. @@ -217,7 +217,7 @@ V4 introduces automated quality control. Your skill might be missing: --- -## πŸ’‘ Pro Tips +## Pro Tips - Start with `@brainstorming` before building anything new - Use `@systematic-debugging` when stuck on bugs diff --git a/docs/users/getting-started.md b/docs/users/getting-started.md index e346a30b..5fc98e8b 100644 --- a/docs/users/getting-started.md +++ b/docs/users/getting-started.md @@ -1,4 +1,4 @@ -# Getting Started with Antigravity Awesome Skills (V7.0.0) +# Getting Started with Antigravity Awesome Skills (V7.6.0) **New here? This guide will help you supercharge your AI Agent in 5 minutes.** @@ -6,7 +6,7 @@ --- -## πŸ€” What Are "Skills"? +## What Are "Skills"? AI Agents (like **Claude Code**, **Gemini**, **Cursor**) are smart, but they lack specific knowledge about your tools. **Skills** are specialized instruction manuals (markdown files) that teach your AI how to perform specific tasks perfectly, every time. @@ -15,7 +15,7 @@ AI Agents (like **Claude Code**, **Gemini**, **Cursor**) are smart, but they lac --- -## ⚑️ Quick Start: The "Starter Packs" +## Quick Start: The "Starter Packs" Don't panic about the 1,200+ skills. You don't need them all at once. We have curated **Starter Packs** to get you running immediately. @@ -54,7 +54,7 @@ Find the bundle that matches your role (see [bundles.md](bundles.md)): --- -## 🧭 Bundles vs Workflows +## Bundles vs Workflows Bundles and workflows solve different problems: @@ -69,7 +69,7 @@ Example: --- -## πŸš€ How to Use a Skill +## How to Use a Skill Once installed, just talk to your AI naturally. @@ -110,7 +110,7 @@ Once installed, just talk to your AI naturally. --- -## πŸ›‘οΈ Trust & Safety (New in V4) +## Trust & Safety We classify skills so you know what you're running: @@ -122,9 +122,9 @@ _Check the [Skill Catalog](../../CATALOG.md) for the full list._ --- -## ❓ FAQ +## FAQ -**Q: Do I need to install all 1,204+ skills?** +**Q: Do I need to install all 1,250+ skills?** A: You clone the whole repo once; your AI only _reads_ the skills you invoke (or that are relevant), so it stays lightweight. **Starter Packs** in [bundles.md](bundles.md) are curated lists to help you discover the right skills for your roleβ€”they don't change how you install. **Q: Can I make my own skills?** @@ -138,7 +138,7 @@ A: Yes, MIT License. Open Source forever. --- -## ⏭️ Next Steps +## Next Steps 1. [Browse the Bundles](bundles.md) 2. [See Real-World Examples](../contributors/examples.md) diff --git a/docs/users/kiro-integration.md b/docs/users/kiro-integration.md index 64dba313..1ff711f1 100644 --- a/docs/users/kiro-integration.md +++ b/docs/users/kiro-integration.md @@ -18,7 +18,7 @@ Kiro is AWS's agentic AI IDE that combines: Kiro's agentic capabilities are enhanced by skills that provide: -- **Domain expertise** across 1,204+ specialized areas +- **Domain expertise** across 1,250+ specialized areas - **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS - **Workflow automation** for common development tasks - **AWS-specific patterns** for serverless, infrastructure, and cloud architecture diff --git a/docs/users/usage.md b/docs/users/usage.md index d5cb6a5b..873daf71 100644 --- a/docs/users/usage.md +++ b/docs/users/usage.md @@ -1,10 +1,10 @@ -# πŸ“– Usage Guide: How to Actually Use These Skills +# Usage Guide: How to Actually Use These Skills > **Confused after installation?** This guide walks you through exactly what to do next, step by step. --- -## πŸ€” "I just installed the repository. Now what?" +## "I just installed the repository. Now what?" Great question! Here's what just happened and what to do next: @@ -12,7 +12,7 @@ Great question! Here's what just happened and what to do next: When you ran `npx antigravity-awesome-skills` or cloned the repository, you: -βœ… **Downloaded 1,204+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or `~/.agent/skills/` if you used `--path`) +βœ… **Downloaded 1,250+ skill files** to your computer (default: `~/.gemini/antigravity/skills/`; or `~/.agent/skills/` if you used `--path`) βœ… **Made them available** to your AI assistant ❌ **Did NOT enable them all automatically** (they're just sitting there, waiting) @@ -20,7 +20,7 @@ Think of it like installing a toolbox. You have all the tools now, but you need --- -## 🎯 Step 1: Understanding "Bundles" (This is NOT Another Install!) +## Step 1: Understanding "Bundles" (This is NOT Another Install!) **Common confusion:** "Do I need to download each skill separately?" @@ -32,7 +32,7 @@ Bundles are **recommended lists** of skills grouped by role. They help you decid **Analogy:** -- You installed a toolbox with 1,204+ tools (βœ… done) +- You installed a toolbox with 1,250+ tools (βœ… done) - Bundles are like **labeled organizer trays** saying: "If you're a carpenter, start with these 10 tools" - You don't install bundlesβ€”you **pick skills from them** @@ -55,7 +55,7 @@ These are **recommendations** for which skills a web developer should try first. --- -## πŸš€ Step 2: How to Actually Execute/Use a Skill +## Step 2: How to Actually Execute/Use a Skill This is the part that should have been explained better! Here's how to use skills: @@ -106,7 +106,7 @@ Use @brainstorming to plan this feature --- -## πŸ’¬ Step 3: What Should My Prompts Look Like? +## Step 3: What Should My Prompts Look Like? Here are **real-world examples** of good prompts: @@ -162,7 +162,7 @@ Here are **real-world examples** of good prompts: --- -## πŸŽ“ Step 4: Your First Skill (Hands-On Tutorial) +## Step 4: Your First Skill (Hands-On Tutorial) Let's actually use a skill right now. Follow these steps: @@ -190,9 +190,9 @@ Let's actually use a skill right now. Follow these steps: --- -## πŸ—‚οΈ Step 5: Picking Your First Skills (Practical Advice) +## Step 5: Picking Your First Skills (Practical Advice) -Don't try to use all 1,204+ skills at once. Here's a sensible approach: +Don't try to use all 1,250+ skills at once. Here's a sensible approach: ### Start with "The Essentials" (5 skills, everyone needs these) @@ -235,7 +235,7 @@ Keep the [CATALOG.md](../../CATALOG.md) open as reference. When you need somethi --- -## πŸ”„ Complete Example: Building a Feature End-to-End +## Complete Example: Building a Feature End-to-End Let's walk through a realistic scenario: @@ -287,7 +287,7 @@ AI: [Creates tests, sets up CI/CD, deploys to Vercel] --- -## πŸ†˜ Common Questions +## Common Questions ### "Which tool should I use? Claude Code, Cursor, Gemini?" @@ -343,7 +343,7 @@ Use @skill-creator to help me build a custom skill for [your task] --- -## 🎯 Quick Reference Card +## Quick Reference Card **Save this for quick lookup:** @@ -359,7 +359,7 @@ Use @skill-creator to help me build a custom skill for [your task] --- -## 🚦 Next Steps +## Next Steps Now that you understand how to use skills: @@ -370,7 +370,7 @@ Now that you understand how to use skills: --- -## πŸ’‘ Pro Tips for Maximum Effectiveness +## Pro Tips for Maximum Effectiveness ### Tip 1: Start Every Feature with @brainstorming @@ -395,7 +395,7 @@ Now that you understand how to use skills: --- -## πŸ“ž Still Confused? +## Still Confused? If something still doesn't make sense: diff --git a/docs/users/visual-guide.md b/docs/users/visual-guide.md index cbf78f66..d8715a35 100644 --- a/docs/users/visual-guide.md +++ b/docs/users/visual-guide.md @@ -25,7 +25,7 @@ --- -## πŸ“¦ Repository Structure (Visual) +## Repository Structure (Visual) ``` antigravity-awesome-skills/ @@ -34,7 +34,7 @@ antigravity-awesome-skills/ β”œβ”€β”€ πŸ“„ CONTRIBUTING.md ← Contributor workflow β”œβ”€β”€ πŸ“„ CATALOG.md ← Full generated catalog β”‚ -β”œβ”€β”€ πŸ“ skills/ ← 1,204+ skills live here +β”œβ”€β”€ πŸ“ skills/ ← 1,250+ skills live here β”‚ β”‚ β”‚ β”œβ”€β”€ πŸ“ brainstorming/ β”‚ β”‚ └── πŸ“„ SKILL.md ← Skill definition @@ -96,11 +96,11 @@ antigravity-awesome-skills/ --- -## 🎯 Skill Categories (Visual Map) +## Skill Categories (Visual Map) ``` β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” - β”‚ 1,204+ SKILLS β”‚ + β”‚ 1,250+ SKILLS β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” @@ -351,7 +351,7 @@ Open skills_index.json β†’ Search for keyword β†’ Find skill path --- -## 🎯 Contribution Impact (Visual) +## Contribution Impact (Visual) ``` Your Contribution @@ -427,7 +427,7 @@ START HERE --- -## πŸ’‘ Quick Tips (Visual Cheatsheet) +## Quick Tips (Visual Cheatsheet) ``` β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” diff --git a/walkthrough.md b/walkthrough.md index f4e48443..ce55f1c0 100644 --- a/walkthrough.md +++ b/walkthrough.md @@ -5,6 +5,7 @@ - Added a user-facing Windows truncation recovery guide at `docs/users/windows-truncation-recovery.md`, linked it from `README.md`, `docs/users/faq.md`, `docs/users/getting-started.md`, and `docs/integrations/jetski-cortex.md`, and credited the workflow to issue `#274`. - Updated `skills/metasploit-framework/SKILL.md` to remove the remote installer flow, require an existing Metasploit installation, and add the required offensive-skill warning. - Refreshed `README.md` to remove stale `7.2.0` / `7.4.0` onboarding copy, align the star badge with the current milestone, and fix the TOC link for `## Contributing`. +- Normalized the active English docs (`README.md`, user guides, Kiro guide, and evergreen maintainer docs) to the current `7.6.0` / `1,250+ skills` state and removed emoji from H2 headers where maintenance rules require clean anchors. - Ran the required maintenance validations after the direct fixes: - `npm run validate` - `npm run validate:references`