docs: update skill counts to 233 and fix typos in descriptions

2026-01-21 18:09:38 +01:00
parent 1bd7db87b9
commit 57ce2dd084
6 changed files with 81 additions and 23 deletions
--- a/FAQ.md
+++ b/FAQ.md
@@ -14,7 +14,7 @@ Skills are specialized instruction files that teach AI assistants how to handle

 ---

-### Do I need to install all 179 skills?
+### Do I need to install all 233 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` or `/skill-name`.

@@ -39,6 +39,7 @@ These skills work with any AI coding assistant that supports the `SKILL.md` form
 ### Are these skills free to use?

 **Yes!** This repository is licensed under MIT License, which means:
+
 - ✅ Free for personal use
 - ✅ Free for commercial use
 - ✅ You can modify them
@@ -49,6 +50,7 @@ These skills work with any AI coding assistant that supports the `SKILL.md` form
 ### Do skills work offline?

 The skill files themselves are stored locally on your computer, but your AI assistant needs an internet connection to function. So:
+
 - ✅ Skills are local files
 - ❌ AI assistant needs internet

@@ -65,6 +67,7 @@ git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skill
 ```

 **Tool-specific paths:**
+
 - Claude Code: `.claude/skills/` or `.agent/skills/`
 - Gemini CLI: `.gemini/skills/` or `.agent/skills/`
 - Cursor: `.cursor/skills/` or project root
@@ -78,6 +81,7 @@ git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skill

 **Option 1: Global Installation** (recommended)
 Install once in your home directory, works for all projects:
+
 ```bash
 cd ~
 git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
@@ -85,6 +89,7 @@ git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skill

 **Option 2: Per-Project Installation**
 Install in each project directory:
+
 ```bash
 cd /path/to/your/project
 git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
@@ -133,6 +138,7 @@ Use the `@` symbol followed by the skill name:
 ```

 **Examples:**
+
 ```
@brainstorming help me design a todo app
@stripe-integration add subscription billing
@@ -146,14 +152,16 @@ Some tools also support `/skill-name` syntax.
 ### How do I know which skill to use?

 **Method 1: Browse the README**
-Check the [Full Skill Registry](README.md#full-skill-registry-179179) organized by category
+Check the [Full Skill Registry](README.md#full-skill-registry-233233) organized by category

 **Method 2: Search by keyword**
+
 ```bash
 ls skills/ | grep "keyword"
 ```

 **Method 3: Ask your AI**
+
 ```
 What skills are available for [topic]?
 ```
@@ -179,16 +187,19 @@ What skills are available for [topic]?
 **Troubleshooting steps:**

 1. **Check installation path**
+
   ```bash
   ls .agent/skills/
   ```

 2. **Verify skill exists**
+
   ```bash
   ls .agent/skills/skill-name/
   ```

 3. **Check SKILL.md exists**
+
   ```bash
   cat .agent/skills/skill-name/SKILL.md
   ```
@@ -247,6 +258,7 @@ Check out [CONTRIBUTING.md](CONTRIBUTING.md) for step-by-step instructions.
 ### What makes a good skill?

 A good skill:
+
 - ✅ Solves a specific problem
 - ✅ Has clear, actionable instructions
 - ✅ Includes examples
@@ -260,11 +272,13 @@ See [SKILL_ANATOMY.md](docs/SKILL_ANATOMY.md) for details.
 ### How long does it take for my contribution to be reviewed?

 Review times vary, but typically:
+
 - **Simple fixes** (typos, docs): 1-3 days
 - **New skills**: 3-7 days
 - **Major changes**: 1-2 weeks

 You can speed this up by:
+
 - Following the contribution guidelines
 - Writing clear commit messages
 - Testing your changes
@@ -286,12 +300,14 @@ The AI primarily uses `SKILL.md`, while developers read `README.md`.
 ### Can I use scripts or code in my skill?

 **Yes!** Skills can include:
+
 - `scripts/` - Helper scripts
 - `examples/` - Example code
 - `templates/` - Code templates
 - `references/` - Documentation

 Reference them in your `SKILL.md`:
+
 ```markdown
 Run the setup script:
 \`\`\`bash
@@ -304,6 +320,7 @@ bash scripts/setup.sh
 ### What programming languages can skills cover?

 **Any language!** Current skills cover:
+
 - JavaScript/TypeScript
 - Python
 - Go
@@ -338,6 +355,7 @@ python3 scripts/validate_skills.py
 ```

 This checks:
+
 - ✅ SKILL.md exists
 - ✅ Frontmatter is valid
 - ✅ Name matches folder name
@@ -350,16 +368,19 @@ This checks:
 ### Which skills should I try first?

 **For beginners:**
+
 - `@brainstorming` - Design before coding
 - `@systematic-debugging` - Fix bugs methodically
 - `@git-pushing` - Commit with good messages

 **For developers:**
+
 - `@test-driven-development` - Write tests first
 - `@react-best-practices` - Modern React patterns
 - `@senior-fullstack` - Full-stack development

 **For security:**
+
 - `@ethical-hacking-methodology` - Security basics
 - `@burp-suite-testing` - Web app testing

@@ -377,6 +398,7 @@ This checks:
 6. **Iterate** - Improve based on feedback

 **Recommended skills to study:**
+
 - `skills/brainstorming/SKILL.md` - Clear structure
 - `skills/systematic-debugging/SKILL.md` - Comprehensive
 - `skills/git-pushing/SKILL.md` - Simple and focused
@@ -386,6 +408,7 @@ This checks:
 ### Are there any skills for learning AI/ML?

 **Yes!** Check out:
+
 - `@rag-engineer` - RAG systems
 - `@prompt-engineering` - Prompt design
 - `@langgraph` - Multi-agent systems
@@ -435,11 +458,13 @@ We'll update it quickly!
 ### Can I modify skills for my own use?

 **Yes!** The MIT License allows you to:
+
 - ✅ Modify skills for your needs
 - ✅ Create private versions
 - ✅ Customize for your team

 **To modify:**
+
 1. Copy the skill to a new location
 2. Edit the SKILL.md file
 3. Use your modified version
@@ -452,7 +477,7 @@ We'll update it quickly!

 ### How many skills are there?

-**179 skills** across 10+ categories as of the latest update.
+**233 skills** across 10+ categories as of the latest update.

 ---

@@ -463,6 +488,7 @@ We'll update it quickly!
 - **Updates**: When best practices change

 **Stay updated:**
+
 ```bash
 cd .agent/skills
 git pull origin main
@@ -473,6 +499,7 @@ git pull origin main
 ### Who maintains this repository?

 This is a community-driven project with contributions from:
+
 - Original creators
 - Open source contributors
 - AI coding assistant users worldwide
@@ -504,6 +531,7 @@ See [Credits & Sources](README.md#credits--sources) for attribution.
 ### Can I use these skills commercially?

 **Yes!** The MIT License permits commercial use. You can:
+
 - ✅ Use in commercial projects
 - ✅ Use in client work
 - ✅ Include in paid products
@@ -523,6 +551,6 @@ See [Credits & Sources](README.md#credits--sources) for attribution.

 ---

-**Question not answered?** 
+**Question not answered?**

 [Open a discussion](https://github.com/sickn33/antigravity-awesome-skills/discussions) and we'll help you out! 🙌
--- a/GETTING_STARTED.md
+++ b/GETTING_STARTED.md
@@ -6,7 +6,7 @@

 ## 🤔 What Are "Skills"?

-Think of skills as **specialized instruction manuals** for AI coding assistants. 
+Think of skills as **specialized instruction manuals** for AI coding assistants.

 **Simple analogy:** Just like you might hire different experts (a designer, a security expert, a marketer), these skills let your AI assistant become an expert in specific areas when you need them.

@@ -14,7 +14,7 @@ Think of skills as **specialized instruction manuals** for AI coding assistants.

 ## 📦 What's Inside This Repository?

-This repo contains **179 ready-to-use skills** organized in the `skills/` folder. Each skill is a folder with at least one file: `SKILL.md`
+This repo contains **233 ready-to-use skills** organized in the `skills/` folder. Each skill is a folder with at least one file: `SKILL.md`

 ```
 skills/
@@ -32,6 +32,7 @@ skills/
 ## How Do Skills Work?

 ### Step 1: Install Skills
+
 Copy the skills to your AI tool's directory:

 ```bash
@@ -40,6 +41,7 @@ git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skill
 ```

 ### Step 2: Use a Skill
+
 In your AI chat, mention the skill:

 ```
@@ -53,50 +55,65 @@ or
 ```

 ### Step 3: The AI Becomes an Expert
+
 The AI loads that skill's knowledge and helps you with specialized expertise!

 ---

 ## Which AI Tools Work With This?

-| Tool | Works? | Installation Path |
-|------|--------|-------------------|
-| **Claude Code** | ✅ Yes | `.claude/skills/` or `.agent/skills/` |
-| **Gemini CLI** | ✅ Yes | `.gemini/skills/` or `.agent/skills/` |
-| **Cursor** | ✅ Yes | `.cursor/skills/` |
-| **GitHub Copilot** | ⚠️ Partial | Copy to `.github/copilot/` |
-| **Antigravity IDE** | ✅ Yes | `.agent/skills/` |
+| Tool                | Works?     | Installation Path                     |
+| ------------------- | ---------- | ------------------------------------- |
+| **Claude Code**     | ✅ Yes     | `.claude/skills/` or `.agent/skills/` |
+| **Gemini CLI**      | ✅ Yes     | `.gemini/skills/` or `.agent/skills/` |
+| **Cursor**          | ✅ Yes     | `.cursor/skills/`                     |
+| **GitHub Copilot**  | ⚠️ Partial | Copy to `.github/copilot/`            |
+| **Antigravity IDE** | ✅ Yes     | `.agent/skills/`                      |

 ---

 ## Skill Categories (Simplified)

 ### **Creative & Design** (10 skills)
+
 Make beautiful things: UI design, art, themes, web components
+
 - Try: `@frontend-design`, `@canvas-design`, `@ui-ux-pro-max`

 ### **Development** (25 skills)
+
 Write better code: testing, debugging, React patterns, architecture
+
 - Try: `@test-driven-development`, `@systematic-debugging`, `@react-best-practices`

 ### **Security** (50 skills)
+
 Ethical hacking and penetration testing tools
+
 - Try: `@ethical-hacking-methodology`, `@burp-suite-testing`

 ### **AI & Agents** (30 skills)
+
 Build AI apps: RAG, LangGraph, prompt engineering, voice agents
+
 - Try: `@rag-engineer`, `@prompt-engineering`, `@langgraph`

 ### **Documents** (4 skills)
+
 Work with Word, Excel, PowerPoint, PDF files
+
 - Try: `@docx-official`, `@xlsx-official`, `@pdf-official`

 ### **Marketing** (23 skills)
+
 Grow your product: SEO, copywriting, ads, email campaigns
+
 - Try: `@copywriting`, `@seo-audit`, `@page-cro`

 ### **Integrations** (25 skills)
+
 Connect to services: Stripe, Firebase, Twilio, Discord, Slack
+
 - Try: `@stripe-integration`, `@firebase`, `@clerk-auth`

 ---
@@ -108,6 +125,7 @@ Let's try the **brainstorming** skill:
 1. **Open your AI assistant** (Claude Code, Cursor, etc.)

 2. **Type this:**
+
   ```
   @brainstorming I want to build a simple weather app
   ```
@@ -125,10 +143,13 @@ Let's try the **brainstorming** skill:
 ## How to Find the Right Skill

 ### Method 1: Browse by Category
-Check the [Full Skill Registry](README.md#full-skill-registry-179179) in the main README
+
+Check the [Full Skill Registry](README.md#full-skill-registry-233233) in the main README

 ### Method 2: Search by Keyword
+
 Use your file explorer or terminal:
+
 ```bash
 # Find skills related to "testing"
 ls skills/ | grep test
@@ -138,6 +159,7 @@ ls skills/ | grep auth
 ```

 ### Method 3: Look at the Index
+
 Check `skills_index.json` for a machine-readable list

 ---
@@ -147,33 +169,41 @@ Check `skills_index.json` for a machine-readable list
 Great! Here's how:

 ### Option 1: Improve Documentation
+
 - Make READMEs clearer
 - Add more examples
 - Fix typos or confusing parts

 ### Option 2: Create a New Skill
+
 See our [CONTRIBUTING.md](CONTRIBUTING.md) for step-by-step instructions

 ### Option 3: Report Issues
+
 Found something confusing? [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues)

 ---

 ## ❓ Common Questions

-### Q: Do I need to install all 179 skills?
+### Q: Do I need to install all 233 skills?
+
 **A:** No! Clone the whole repo, and your AI will only load skills when you use them.

 ### Q: Can I create my own skills?
+
 **A:** Yes! Check out the `@skill-creator` skill or read [CONTRIBUTING.md](CONTRIBUTING.md)

 ### Q: What if my AI tool isn't listed?
+
 **A:** If it supports the `SKILL.md` format, try `.agent/skills/` - it's the universal path.

 ### Q: Are these skills free?
+
 **A:** Yes! MIT License. Use them however you want.

 ### Q: Do skills work offline?
+
 **A:** The skill files are local, but your AI assistant needs internet to function.

 ---
--- a/README.md
+++ b/README.md
@@ -95,9 +95,9 @@ The repository is organized into several key areas of expertise:
 | :-------------------------- | :----------- | :--------------------------------------------------------------------------------------------------------------------------- |
 | **🛸 Autonomous & Agentic** | **~8**       | Loki Mode (Startup-in-a-box), Subagent Driven Dev, Dispatching Parallel Agents, Planning With Files, Skill Creator/Developer |
 | **🔌 Integrations & APIs**  | **~25**      | Stripe, Firebase, Supabase, Vercel, Clerk Auth, Twilio, Discord Bot, Slack Bot, GraphQL, AWS Serverless                      |
-| **🛡️ Cybersecurity**        | **~50**      | Ethical Hacking, Metasploit, Burp Suite, SQLMap, Active Directory, AWS/Cloud Pentesting, OWASP Top 100, Red Team Tools       |
+| **🛡️ Cybersecurity**        | **~51**      | Ethical Hacking, Metasploit, Burp Suite, SQLMap, Active Directory, AWS/Cloud Pentesting, OWASP Top 100, Red Team Tools       |
 | **🎨 Creative & Design**    | **~10**      | UI/UX Pro Max, Frontend Design, Canvas, Algorithmic Art, Theme Factory, D3 Viz, Web Artifacts                                |
-| **🛠️ Development**          | **~25**      | TDD, Systematic Debugging, React Patterns, Backend/Frontend Guidelines, Senior Fullstack, Software Architecture              |
+| **🛠️ Development**          | **~33**      | TDD, Systematic Debugging, React Patterns, Backend/Frontend Guidelines, Senior Fullstack, Software Architecture              |
 | **🏗️ Infrastructure & Git** | **~8**       | Linux Shell Scripting, Git Worktrees, Git Pushing, Conventional Commits, File Organization, GitHub Workflow Automation       |
 | **🤖 AI Agents & LLM**      | **~30**      | LangGraph, CrewAI, Langfuse, RAG Engineer, Prompt Engineer, Voice Agents, Browser Automation, Agent Memory Systems           |
 | **🔄 Workflow & Planning**  | **~6**       | Writing Plans, Executing Plans, Concise Planning, Verification Before Completion, Code Review (Requesting/Receiving)         |
--- a/skills/cc-skill-continuous-learning/SKILL.md
+++ b/skills/cc-skill-continuous-learning/SKILL.md
@@ -1,10 +1,10 @@
 ---
 name: cc-skill-continuous-learning
-description: Development skill skill from everything-claude-code
+description: Development skill from everything-claude-code
 author: affaan-m
 version: "1.0"
 ---

 # cc-skill-continuous-learning

-Development skill skill.
+Development skill skill.
--- a/skills/cc-skill-strategic-compact/SKILL.md
+++ b/skills/cc-skill-strategic-compact/SKILL.md
@@ -1,10 +1,10 @@
 ---
 name: cc-skill-strategic-compact
-description: Development skill skill from everything-claude-code
+description: Development skill from everything-claude-code
 author: affaan-m
 version: "1.0"
 ---

 # cc-skill-strategic-compact

-Development skill skill.
+Development skill skill.
--- a/skills_index.json
+++ b/skills_index.json
@@ -399,7 +399,7 @@
    "id": "cc-skill-continuous-learning",
    "path": "skills/cc-skill-continuous-learning",
    "name": "cc-skill-continuous-learning",
-    "description": "Development skill skill from everything-claude-code"
+    "description": "Development skill from everything-claude-code"
  },
  {
    "id": "cc-skill-project-guidelines-example",
@@ -411,7 +411,7 @@
    "id": "cc-skill-strategic-compact",
    "path": "skills/cc-skill-strategic-compact",
    "name": "cc-skill-strategic-compact",
-    "description": "Development skill skill from everything-claude-code"
+    "description": "Development skill from everything-claude-code"
  },
  {
    "id": "clean-code",