diff --git a/FAQ.md b/FAQ.md index 30738a5f..52db779a 100644 --- 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! 🙌 diff --git a/GETTING_STARTED.md b/GETTING_STARTED.md index ab777880..483f6888 100644 --- 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. --- diff --git a/README.md b/README.md index 281b7ce6..7b984f9b 100644 --- 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) | diff --git a/skills/cc-skill-continuous-learning/SKILL.md b/skills/cc-skill-continuous-learning/SKILL.md index dff53202..d8e11d19 100644 --- 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. \ No newline at end of file +Development skill skill. diff --git a/skills/cc-skill-strategic-compact/SKILL.md b/skills/cc-skill-strategic-compact/SKILL.md index 956c3a45..a128e02b 100644 --- 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. \ No newline at end of file +Development skill skill. diff --git a/skills_index.json b/skills_index.json index bbe437f7..c15efe14 100644 --- 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",