diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 77022dd8..a43b0252 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,21 +1,6 @@ -# ๐Ÿค Contributing Guide - V4 Enterprise Edition +# ๐Ÿค Contributing Guide - Make It Easy for Everyone! **Thank you for wanting to make this repo better!** This guide shows you exactly how to contribute, even if you're new to open source. -With V4, we raised the bar for quality. Please read the **new Quality Standards** below carefully. - ---- - -## ๐Ÿง The "Quality Bar" (V4 Standard) - -**Critical for new skills:** Every skill submitted must pass our **5-Point Quality Check** (see `docs/QUALITY_BAR.md` for details): - -1. **Metadata**: Correct Frontmatter (`name`, `description`). - - The `name` MUST exactly match the folder name. - - The `description` MUST be concise (under 200 characters) and focus on WHEN to trigger the skill. -2. **Safety**: No harmful commands without "Risk" labels. -3. **Clarity**: Clear "When to use" section. -4. **Examples**: At least one copy-paste usage example. -5. **Actions**: Must define concrete steps, not just "thoughts". --- @@ -24,77 +9,104 @@ With V4, we raised the bar for quality. Please read the **new Quality Standards* You don't need to be an expert! Here are ways anyone can help: ### 1. Improve Documentation (Easiest!) - - Fix typos or grammar - Make explanations clearer - Add examples to existing skills - Translate documentation to other languages ### 2. Report Issues - - Found something confusing? Tell us! - Skill not working? Let us know! - Have suggestions? We want to hear them! ### 3. Create New Skills - - Share your expertise as a skill - Fill gaps in the current collection - Improve existing skills ### 4. Test and Validate - - Try skills and report what works/doesn't work - Test on different AI tools - Suggest improvements --- -## Local development setup +## How to Improve Documentation -To run validation, index generation, and README updates locally: +### Super Easy Method (No Git Knowledge Needed!) -1. **Node.js** (for catalog and installer): `npm ci` -2. **Python 3** (for validate, index, readme scripts): install dependencies with - ```bash - pip install -r requirements.txt - ``` - Then you can run `npm run chain` (validate โ†’ index โ†’ readme) and `npm run catalog`. +1. **Find the file** you want to improve on GitHub +2. **Click the pencil icon** (โœ๏ธ) to edit +3. **Make your changes** in the browser +4. **Click "Propose changes"** at the bottom +5. **Done!** We'll review and merge it -**Validation:** The canonical validator is **Python** (`scripts/validate_skills.py`). Use `npm run validate` (or `npm run validate:strict` for CI-style checks). The JavaScript validator (`scripts/validate-skills.js`) is legacy/optional and uses a different schema; CI and PR checks rely on the Python validator only. +### Using Git (If You Know How) -**npm audit:** CI runs `npm audit --audit-level=high`. To fix issues locally: run `npm audit`, then `npm update` or `npm audit fix` as appropriate; for breaking changes, update dependencies manually and run tests. +```bash +# 1. Fork the repo on GitHub (click the Fork button) + +# 2. Clone your fork +git clone https://github.com/YOUR-USERNAME/antigravity-awesome-skills.git +cd antigravity-awesome-skills + +# 3. Create a branch +git checkout -b improve-docs + +# 4. Make your changes +# Edit files in your favorite editor + +# 5. Commit and push +git add . +git commit -m "docs: make XYZ clearer" +git push origin improve-docs + +# 6. Open a Pull Request on GitHub +``` --- ## How to Create a New Skill -### Step-by-Step Guide +### What Makes a Good Skill? + +A skill should: +- โœ… Solve a specific problem +- โœ… Be reusable across projects +- โœ… Have clear instructions +- โœ… Include examples when possible + +### Step-by-Step: Create Your First Skill #### Step 1: Choose Your Skill Topic -Ask yourself: "What do I wish my AI assistant knew better?". -Example: "I'm good at Docker, let me create a Docker skill". +Ask yourself: +- What am I good at? +- What do I wish my AI assistant knew better? +- What task do I do repeatedly? + +**Examples:** +- "I'm good at Docker, let me create a Docker skill" +- "I wish AI understood Tailwind better" +- "I keep setting up the same testing patterns" #### Step 2: Create the Folder Structure -Skills live in the `skills/` directory. Use `kebab-case` for folder names. - ```bash -# Navigate to skills +# Navigate to the skills directory cd skills/ -# Create your skill folder +# Create your skill folder (use lowercase with hyphens) mkdir my-awesome-skill -cd my-awesome-skill # Create the SKILL.md file +cd my-awesome-skill touch SKILL.md ``` #### Step 3: Write Your SKILL.md -Every skill needs this basic structure. **Copy this template:** +Every skill needs this basic structure: ```markdown --- @@ -112,47 +124,90 @@ Explain what this skill does and when to use it. - Use when [scenario 1] - Use when [scenario 2] +- Use when [scenario 3] ## How It Works -Detailed step-by-step instructions for the AI... +### Step 1: [First Step] +Explain what to do first... + +### Step 2: [Second Step] +Explain the next step... + +### Step 3: [Final Step] +Explain how to finish... ## Examples -### Example 1 - +### Example 1: [Common Use Case] \`\`\` -code example here +Show example code or commands here +\`\`\` + +### Example 2: [Another Use Case] +\`\`\` +More examples... \`\`\` ## Best Practices - โœ… Do this +- โœ… Also do this - โŒ Don't do this +- โŒ Avoid this + +## Common Pitfalls + +- **Problem:** Description of common issue + **Solution:** How to fix it + +## Additional Resources + +- [Link to documentation](https://example.com) +- [Tutorial](https://example.com) ``` -#### Step 4: Validate (CRITICAL V4 STEP) +#### Step 4: Test Your Skill -Use the canonical validator `scripts/validate_skills.py` via `npm run validate`. **We will not merge PRs that fail this check.** +1. **Copy it to your AI tool's skills directory:** + ```bash + cp -r skills/my-awesome-skill ~/.agent/skills/ + ``` + +2. **Try using it:** + ``` + @my-awesome-skill help me with [task] + ``` + +3. **Does it work?** Great! If not, refine it. + +#### Step 5: Validate Your Skill + +Run the validation script: ```bash -npm run validate # soft mode (warnings only) -npm run validate:strict # strict mode (what CI runs) +python3 scripts/validate_skills.py ``` This checks: - -- โœ… `SKILL.md` exists +- โœ… SKILL.md exists - โœ… Frontmatter is correct - โœ… Name matches folder name -- โœ… Quality Bar checks passed +- โœ… Description exists -#### Step 5: Submit Your Skill +#### Step 6: Submit Your Skill ```bash +# 1. Add your skill git add skills/my-awesome-skill/ -git commit -m "feat: add my-awesome-skill" + +# 2. Commit with a clear message +git commit -m "feat: add my-awesome-skill for [purpose]" + +# 3. Push to your fork git push origin my-branch + +# 4. Open a Pull Request on GitHub ``` --- @@ -177,34 +232,110 @@ description: "One sentence describing what this skill does and when to use it" - Use when you need to [scenario 1] - Use when you want to [scenario 2] +- Use when working with [scenario 3] + +## Core Concepts + +### Concept 1 +[Explain key concept] + +### Concept 2 +[Explain another key concept] ## Step-by-Step Guide ### 1. [First Step Name] +[Detailed instructions] +### 2. [Second Step Name] +[Detailed instructions] + +### 3. [Third Step Name] [Detailed instructions] ## Examples ### Example 1: [Use Case Name] - \`\`\`language // Example code here \`\`\` +**Explanation:** [What this example demonstrates] + +### Example 2: [Another Use Case] +\`\`\`language +// More example code +\`\`\` + +**Explanation:** [What this example demonstrates] + ## Best Practices - โœ… **Do:** [Good practice] +- โœ… **Do:** [Another good practice] - โŒ **Don't:** [What to avoid] +- โŒ **Don't:** [Another thing to avoid] ## Troubleshooting -**Problem:** [Common Issue] +### Problem: [Common Issue] +**Symptoms:** [How you know this is the problem] **Solution:** [How to fix it] + +### Problem: [Another Issue] +**Symptoms:** [How you know this is the problem] +**Solution:** [How to fix it] + +## Related Skills + +- `@related-skill-1` - [When to use this instead] +- `@related-skill-2` - [How this complements your skill] + +## Additional Resources + +- [Official Documentation](https://example.com) +- [Tutorial](https://example.com) +- [Community Guide](https://example.com) ``` --- +## How to Report Issues + +### Found a Bug? + +1. **Check existing issues** - Maybe it's already reported +2. **Open a new issue** with this info: + - What skill has the problem? + - What AI tool are you using? + - What did you expect to happen? + - What actually happened? + - Steps to reproduce + +### Found Something Confusing? + +1. **Open an issue** titled: "Documentation unclear: [topic]" +2. **Explain:** + - What part is confusing? + - What did you expect to find? + - How could it be clearer? + +--- + +## Contribution Checklist + +Before submitting your contribution: + +- [ ] My skill has a clear, descriptive name +- [ ] The `SKILL.md` has proper frontmatter (name + description) +- [ ] I've included examples +- [ ] I've tested the skill with an AI assistant +- [ ] I've run `python3 scripts/validate_skills.py` +- [ ] My commit message is clear (e.g., "feat: add docker-compose skill") +- [ ] I've checked for typos and grammar + +--- + ## Commit Message Guidelines Use these prefixes: @@ -217,11 +348,11 @@ Use these prefixes: - `chore:` - Maintenance tasks **Examples:** - ``` feat: add kubernetes-deployment skill docs: improve getting started guide fix: correct typo in stripe-integration skill +docs: add examples to react-best-practices ``` --- @@ -229,13 +360,30 @@ fix: correct typo in stripe-integration skill ## Learning Resources ### New to Git/GitHub? - - [GitHub's Hello World Guide](https://guides.github.com/activities/hello-world/) - [Git Basics](https://git-scm.com/book/en/v2/Getting-Started-Git-Basics) ### New to Markdown? - - [Markdown Guide](https://www.markdownguide.org/basic-syntax/) +- [GitHub Markdown](https://guides.github.com/features/mastering-markdown/) + +### New to Open Source? +- [First Contributions](https://github.com/firstcontributions/first-contributions) +- [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/) + +--- + +## Need Help? + +- **Questions?** Open a [Discussion](https://github.com/sickn33/antigravity-awesome-skills/discussions) +- **Stuck?** Open an [Issue](https://github.com/sickn33/antigravity-awesome-skills/issues) +- **Want feedback?** Open a [Draft Pull Request](https://github.com/sickn33/antigravity-awesome-skills/pulls) + +--- + +## Recognition + +All contributors are recognized in our [Contributors](https://github.com/sickn33/antigravity-awesome-skills/graphs/contributors) page! --- @@ -244,9 +392,10 @@ fix: correct typo in stripe-integration skill - Be respectful and inclusive - Welcome newcomers - Focus on constructive feedback -- **No harmful content**: See `docs/SECURITY_GUARDRAILS.md`. +- Help others learn --- **Thank you for making this project better for everyone!** + Every contribution, no matter how small, makes a difference. Whether you fix a typo, improve a sentence, or create a whole new skill - you're helping thousands of developers! diff --git a/FAQ.md b/FAQ.md new file mode 100644 index 00000000..76170b47 --- /dev/null +++ b/FAQ.md @@ -0,0 +1,528 @@ +# โ“ Frequently Asked Questions (FAQ) + +**Got questions?** You're not alone! Here are answers to the most common questions about Antigravity Awesome Skills. + +--- + +## ๐ŸŽฏ 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), skills let your AI become an expert in different areas when you need them. + +--- + +### Do I need to install all 179 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`. + +It's like having a library - all the books are there, but you only read the ones you need. + +--- + +### Which AI tools work with these skills? + +These skills work with any AI coding assistant that supports the `SKILL.md` format: + +- โœ… **Claude Code** (Anthropic CLI) +- โœ… **Gemini CLI** (Google) +- โœ… **Codex CLI** (OpenAI) +- โœ… **Cursor** (AI IDE) +- โœ… **Antigravity IDE** +- โœ… **OpenCode** +- โš ๏ธ **GitHub Copilot** (partial support) + +--- + +### 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 +- โœ… You can redistribute them + +--- + +### 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 + +--- + +## Installation & Setup + +### Where should I install the skills? + +The universal path that works with most tools is `.agent/skills/`: + +```bash +git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills +``` + +**Tool-specific paths:** +- Claude Code: `.claude/skills/` or `.agent/skills/` +- Gemini CLI: `.gemini/skills/` or `.agent/skills/` +- Cursor: `.cursor/skills/` or project root +- Antigravity: `.agent/skills/` + +--- + +### Can I install skills in multiple projects? + +**Yes!** You have two options: + +**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 +``` + +**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 +``` + +--- + +### How do I update skills to the latest version? + +Navigate to your skills directory and pull the latest changes: + +```bash +cd .agent/skills +git pull origin main +``` + +--- + +### Can I install only specific skills? + +**Yes!** You can manually copy individual skill folders: + +```bash +# Clone the full repo first +git clone https://github.com/sickn33/antigravity-awesome-skills.git temp-skills + +# Copy only the skills you want +mkdir -p .agent/skills +cp -r temp-skills/skills/brainstorming .agent/skills/ +cp -r temp-skills/skills/stripe-integration .agent/skills/ + +# Clean up +rm -rf temp-skills +``` + +--- + +## Using Skills + +### How do I invoke a skill? + +Use the `@` symbol followed by the skill name: + +``` +@skill-name your request here +``` + +**Examples:** +``` +@brainstorming help me design a todo app +@stripe-integration add subscription billing +@systematic-debugging fix this test failure +``` + +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 + +**Method 2: Search by keyword** +```bash +ls skills/ | grep "keyword" +``` + +**Method 3: Ask your AI** +``` +What skills are available for [topic]? +``` + +--- + +### Can I use multiple skills at once? + +**Yes!** You can invoke multiple skills in the same conversation: + +``` +@brainstorming help me design this feature + +[After brainstorming...] + +@test-driven-development now let's implement it with tests +``` + +--- + +### What if a skill doesn't work? + +**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 + ``` + +4. **Try restarting your AI assistant** + +5. **Check for typos in skill name** + - Use `@brainstorming` not `@brain-storming` + - Names are case-sensitive in some tools + +6. **Report the issue** + [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues) with details + +--- + +## ๐Ÿค Contributing + +### I'm new to open source. Can I still contribute? + +**Absolutely!** Everyone starts somewhere. We welcome contributions from beginners: + +- Fix typos or grammar +- Improve documentation clarity +- Add examples to existing skills +- Report issues or confusing parts + +Check out [CONTRIBUTING_GUIDE.md](CONTRIBUTING_GUIDE.md) for step-by-step instructions. + +--- + +### Do I need to know how to code to contribute? + +**No!** Many valuable contributions don't require coding: + +- **Documentation improvements** - Make things clearer +- **Examples** - Add real-world usage examples +- **Issue reporting** - Tell us what's confusing +- **Testing** - Try skills and report what works + +--- + +### How do I create a new skill? + +**Quick version:** + +1. Create a folder: `skills/my-skill-name/` +2. Create `SKILL.md` with frontmatter and content +3. Test it with your AI assistant +4. Run validation: `python3 scripts/validate_skills.py` +5. Submit a Pull Request + +**Detailed version:** See [CONTRIBUTING_GUIDE.md](CONTRIBUTING_GUIDE.md) + +--- + +### What makes a good skill? + +A good skill: +- โœ… Solves a specific problem +- โœ… Has clear, actionable instructions +- โœ… Includes examples +- โœ… Is reusable across projects +- โœ… Follows the standard structure + +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 +- Responding to feedback quickly + +--- + +## Technical Questions + +### What's the difference between SKILL.md and README.md? + +- **SKILL.md** (required): The actual skill definition that the AI reads +- **README.md** (optional): Human-readable documentation about the skill + +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 +bash scripts/setup.sh +\`\`\` +``` + +--- + +### What programming languages can skills cover? + +**Any language!** Current skills cover: +- JavaScript/TypeScript +- Python +- Go +- Rust +- Swift +- Kotlin +- Shell scripting +- And many more... + +--- + +### Can skills call other skills? + +**Yes!** Skills can reference other skills: + +```markdown +## Workflow + +1. First, use `@brainstorming` to design +2. Then, use `@writing-plans` to plan +3. Finally, use `@test-driven-development` to implement +``` + +--- + +### How do I validate my skill before submitting? + +Run the validation script: + +```bash +python3 scripts/validate_skills.py +``` + +This checks: +- โœ… SKILL.md exists +- โœ… Frontmatter is valid +- โœ… Name matches folder name +- โœ… Description exists + +--- + +## Learning & Best Practices + +### 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 + +--- + +### How do I learn to write good skills? + +**Learning path:** + +1. **Read existing skills** - Study 5-10 well-written skills +2. **Use skills** - Try them with your AI assistant +3. **Read guides** - Check [SKILL_ANATOMY.md](docs/SKILL_ANATOMY.md) +4. **Start simple** - Create a basic skill first +5. **Get feedback** - Submit and learn from reviews +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 + +--- + +### Are there any skills for learning AI/ML? + +**Yes!** Check out: +- `@rag-engineer` - RAG systems +- `@prompt-engineering` - Prompt design +- `@langgraph` - Multi-agent systems +- `@ai-agents-architect` - Agent architecture +- `@llm-app-patterns` - LLM application patterns + +--- + +## Troubleshooting + +### My AI assistant doesn't recognize skills + +**Possible causes:** + +1. **Wrong installation path** + - Check your tool's documentation for the correct path + - Try `.agent/skills/` as the universal path + +2. **Skill name typo** + - Verify the exact skill name: `ls .agent/skills/` + - Use the exact name from the folder + +3. **Tool doesn't support skills** + - Verify your tool supports the SKILL.md format + - Check the [Compatibility](#-compatibility) section + +4. **Need to restart** + - Restart your AI assistant after installing skills + +--- + +### A skill gives incorrect or outdated advice + +**Please report it!** + +1. [Open an issue](https://github.com/sickn33/antigravity-awesome-skills/issues) +2. Include: + - Which skill + - What's incorrect + - What should it say instead + - Links to correct documentation + +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 + +**Consider contributing improvements back!** + +--- + +## Statistics & Info + +### How many skills are there? + +**179 skills** across 10+ categories as of the latest update. + +--- + +### How often are skills updated? + +- **Bug fixes**: As soon as reported +- **New skills**: Added regularly by contributors +- **Updates**: When best practices change + +**Stay updated:** +```bash +cd .agent/skills +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 + +See [Credits & Sources](README.md#credits--sources) for attribution. + +--- + +## Still Have Questions? + +### Where can I get help? + +- **[GitHub Discussions](https://github.com/sickn33/antigravity-awesome-skills/discussions)** - Ask questions +- **[GitHub Issues](https://github.com/sickn33/antigravity-awesome-skills/issues)** - Report bugs +- **Documentation** - Read the guides in this repo +- **Community** - Connect with other users + +--- + +### How can I stay updated? + +- **Star the repository** on GitHub +- **Watch the repository** for updates +- **Subscribe to releases** for notifications +- **Follow contributors** on social media + +--- + +### 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 +- โœ… Modify for commercial purposes + +**Only requirement:** Keep the license notice. + +--- + +## ๐Ÿ’ก Pro Tips + +- Start with `@brainstorming` before building anything new +- Use `@systematic-debugging` when stuck on bugs +- Try `@test-driven-development` for better code quality +- Explore `@skill-creator` to make your own skills +- Read skill descriptions to understand when to use them + +--- + +**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 new file mode 100644 index 00000000..9c4b646d --- /dev/null +++ b/GETTING_STARTED.md @@ -0,0 +1,201 @@ +# Getting Started with Antigravity Awesome Skills + +**New here? This guide will help you understand and use this repository in 5 minutes!** + +--- + +## ๐Ÿค” What Are "Skills"? + +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. + +--- + +## ๐Ÿ“ฆ 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` + +``` +skills/ +โ”œโ”€โ”€ brainstorming/ +โ”‚ โ””โ”€โ”€ SKILL.md โ† The skill definition +โ”œโ”€โ”€ stripe-integration/ +โ”‚ โ””โ”€โ”€ SKILL.md +โ”œโ”€โ”€ react-best-practices/ +โ”‚ โ””โ”€โ”€ SKILL.md +โ””โ”€โ”€ ... (176 more skills) +``` + +--- + +## How Do Skills Work? + +### Step 1: Install Skills +Copy the skills to your AI tool's directory: + +```bash +# For most AI tools (Claude Code, Gemini CLI, etc.) +git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills +``` + +### Step 2: Use a Skill +In your AI chat, mention the skill: + +``` +@brainstorming help me design a todo app +``` + +or + +``` +/stripe-integration add payment processing to my app +``` + +### 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/` | + +--- + +## 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` + +--- + +## Your First Skill: A Quick Example + +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 + ``` + +3. **What happens:** + - The AI loads the brainstorming skill + - It asks you questions one at a time + - It helps you design the app before coding + - It creates a design document for you + +4. **Result:** You get a well-thought-out plan instead of jumping straight to code! + +--- + +## 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 + +### Method 2: Search by Keyword +Use your file explorer or terminal: +```bash +# Find skills related to "testing" +ls skills/ | grep test + +# Find skills related to "auth" +ls skills/ | grep auth +``` + +### Method 3: Look at the Index +Check `skills_index.json` for a machine-readable list + +--- + +## ๐Ÿค Want to Contribute? + +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_GUIDE.md](CONTRIBUTING_GUIDE.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? +**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_GUIDE.md](CONTRIBUTING_GUIDE.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. + +--- + +## Next Steps + +1. โœ… Install the skills in your AI tool +2. โœ… Try 2-3 skills from different categories +3. โœ… Read [CONTRIBUTING_GUIDE.md](CONTRIBUTING_GUIDE.md) if you want to help +4. โœ… Star the repo if you find it useful! โญ + +--- + +## ๐Ÿ’ก Pro Tips + +- **Start with `@brainstorming`** before building anything new +- **Use `@systematic-debugging`** when you're stuck on a bug +- **Try `@test-driven-development`** to write better code +- **Explore `@skill-creator`** to make your own skills + +--- + +**Still confused?** Open an issue and we'll help you out! ๐Ÿ™Œ + +**Ready to dive deeper?** Check out the main [README.md](README.md) for the complete skill list. diff --git a/README.md b/README.md index 8e0cf4d2..65e3bfce 100644 --- a/README.md +++ b/README.md @@ -1,405 +1,323 @@ -# ๐ŸŒŒ Antigravity Awesome Skills: 1002+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More +# ๐ŸŒŒ Antigravity Awesome Skills: 179+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More -> **The Ultimate Collection of 1002+ Universal Agentic Skills for AI Coding Assistants โ€” Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode, AdaL** +> **The Ultimate Collection of 179+ Universal Agentic Skills for AI Coding Assistants โ€” Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode** [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Claude Code](https://img.shields.io/badge/Claude%20Code-Anthropic-purple)](https://claude.ai) [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Google-blue)](https://github.com/google-gemini/gemini-cli) [![Codex CLI](https://img.shields.io/badge/Codex%20CLI-OpenAI-green)](https://github.com/openai/codex) -[![Kiro](https://img.shields.io/badge/Kiro-AWS-orange)](https://kiro.dev) [![Cursor](https://img.shields.io/badge/Cursor-AI%20IDE-orange)](https://cursor.sh) [![Copilot](https://img.shields.io/badge/GitHub%20Copilot-VSCode-lightblue)](https://github.com/features/copilot) [![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray)](https://github.com/opencode-ai/opencode) -[![Antigravity](https://img.shields.io/badge/Antigravity-DeepMind-red)](https://github.com/sickn33/antigravity-awesome-skills) -[![AdaL CLI](https://img.shields.io/badge/AdaL%20CLI-SylphAI-pink)](https://sylph.ai/) -[![ASK Supported](https://img.shields.io/badge/ASK-Supported-blue)](https://github.com/yeasy/ask) -[![Buy Me a Book](https://img.shields.io/badge/Buy%20me%20a-book-d13610?logo=buymeacoffee&logoColor=white)](https://buymeacoffee.com/sickn33) +[![Antigravity](https://img.shields.io/badge/Antigravity-DeepMind-red)](https://github.com/anthropics/antigravity) -If this project helps you, you can [support it here](https://buymeacoffee.com/sickn33) or simply โญ the repo. - -**Antigravity Awesome Skills** is a curated, battle-tested library of **978+ high-performance agentic skills** designed to work seamlessly across all major AI coding assistants: +**Antigravity Awesome Skills** is a curated, battle-tested library of **179 high-performance agentic skills** designed to work seamlessly across all major AI coding assistants: - ๐ŸŸฃ **Claude Code** (Anthropic CLI) - ๐Ÿ”ต **Gemini CLI** (Google DeepMind) - ๐ŸŸข **Codex CLI** (OpenAI) -- ๐ŸŸ  **Kiro CLI** (AWS) -- ๐ŸŸ  **Kiro IDE** (AWS) - ๐Ÿ”ด **Antigravity IDE** (Google DeepMind) - ๐Ÿฉต **GitHub Copilot** (VSCode Extension) - ๐ŸŸ  **Cursor** (AI-native IDE) - โšช **OpenCode** (Open-source CLI) -- ๐ŸŒธ **AdaL CLI** (Self-evolving Coding Agent) -This repository provides essential skills to transform your AI assistant into a **full-stack digital agency**, including official capabilities from **Anthropic**, **OpenAI**, **Google**, **Microsoft**, **Supabase**, **Apify**, and **Vercel Labs**. +This repository provides essential skills to transform your AI assistant into a **full-stack digital agency**, including official capabilities from **Anthropic**, **OpenAI**, **Google**, and **Vercel Labs**. -## Table of Contents +## ๐Ÿ“ Table of Contents -- [๐Ÿš€ New Here? Start Here!](#new-here-start-here) -- [๐Ÿ“– Complete Usage Guide](docs/USAGE.md) - **Start here if confused after installation!** -- [๐Ÿ”Œ Compatibility & Invocation](#compatibility--invocation) -- [๐Ÿ› ๏ธ Installation](#installation) -- [๐Ÿงฏ Troubleshooting](#troubleshooting) -- [๐ŸŽ Curated Collections (Bundles)](#curated-collections) -- [๐Ÿงญ Antigravity Workflows](#antigravity-workflows) -- [๐Ÿ“ฆ Features & Categories](#features--categories) -- [๐Ÿ“š Browse 1002+ Skills](#browse-1002-skills) -- [๐Ÿค How to Contribute](#how-to-contribute) -- [๐Ÿ’ฌ Community](#community) -- [โ˜• Support the Project](#support-the-project) -- [๐Ÿ† Credits & Sources](#credits--sources) -- [๐Ÿ‘ฅ Repo Contributors](#repo-contributors) -- [โš–๏ธ License](#license) -- [๐ŸŒŸ Star History](#star-history) +- [๐Ÿš€ New Here? Start Here!](#-new-here-start-here) +- [๐Ÿ”Œ Compatibility](#-compatibility) +- [Features & Categories](#features--categories) +- [Full Skill Registry](#full-skill-registry-155155) +- [Installation](#installation) +- [How to Contribute](#how-to-contribute) +- [Credits & Sources](#credits--sources) +- [License](#license) --- ## New Here? Start Here! -**Welcome to the V6.10.0 Interactive Web Edition.** This isn't just a list of scripts; it's a complete operating system for your AI Agent. +**First time using this repository?** We've created beginner-friendly guides to help you get started: -### 1. ๐Ÿฃ Context: What is this? +- **[GETTING_STARTED.md](GETTING_STARTED.md)** - Complete beginner's guide (5-minute read) +- **[CONTRIBUTING_GUIDE.md](CONTRIBUTING_GUIDE.md)** - How to contribute (step-by-step) +- **[SKILL_ANATOMY.md](docs/SKILL_ANATOMY.md)** - Understanding how skills work +- **[QUICK_START_VISUAL.md](docs/QUICK_START_VISUAL.md)** - Visual guide with diagrams -**Antigravity Awesome Skills** (Release 6.10.0) is a massive upgrade to your AI's capabilities. +**Quick Start:** +```bash +# 1. Install skills +git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills -AI Agents (like Claude Code, Cursor, or Gemini) are smart, but they lack **specific tools**. They don't know your company's "Deployment Protocol" or the specific syntax for "AWS CloudFormation". -**Skills** are small markdown files that teach them how to do these specific tasks perfectly, every time. +# 2. Use a skill in your AI assistant +@brainstorming help me design a todo app +``` -### 2. โšก๏ธ Quick Start (1 minute) +That's it! Your AI assistant now has 179 specialized skills. ๐ŸŽ‰ -Install once; then use Starter Packs in [docs/BUNDLES.md](docs/BUNDLES.md) to focus on your role. - -1. **Install**: - - ```bash - # Default: ~/.gemini/antigravity/skills (Antigravity global). Use --path for other locations. - npx antigravity-awesome-skills - ``` - -2. **Verify**: - - ```bash - test -d ~/.gemini/antigravity/skills && echo "Skills installed in ~/.gemini/antigravity/skills" - ``` - -3. **Run your first skill**: - - > "Use **@brainstorming** to plan a SaaS MVP." - -4. **Pick a bundle**: - - **Web Dev?** start with `Web Wizard`. - - **Security?** start with `Security Engineer`. - - **General use?** start with `Essentials`. - -### 3. ๐Ÿง  How to use - -Once installed, just ask your agent naturally: - -> "Use the **@brainstorming** skill to help me plan a SaaS." -> "Run **@lint-and-validate** on this file." - -๐Ÿ‘‰ **NEW:** [**Complete Usage Guide - Read This First!**](docs/USAGE.md) (answers: "What do I do after installation?", "How do I execute skills?", "What should prompts look like?") - -๐Ÿ‘‰ **[Full Getting Started Guide](docs/GETTING_STARTED.md)** +**Additional Resources:** +- ๐Ÿ’ก **[Real-World Examples](docs/EXAMPLES.md)** - See skills in action +- โ“ **[FAQ](FAQ.md)** - Common questions answered --- -## Compatibility & Invocation +## ๐Ÿ”Œ Compatibility -These skills follow the universal **SKILL.md** format and work with any AI coding assistant that supports agentic skills. +These skills follow the universal **SKILL.md** format and work with any AI coding assistant that supports agentic skills: -| Tool | Type | Invocation Example | Path | -| :-------------- | :--- | :-------------------------------- | :-------------------------------------------------------------------- | -| **Claude Code** | CLI | `>> /skill-name help me...` | `.claude/skills/` | -| **Gemini CLI** | CLI | `(User Prompt) Use skill-name...` | `.gemini/skills/` | -| **Codex CLI** | CLI | `(User Prompt) Use skill-name...` | `.codex/skills/` | -| **Kiro CLI** | CLI | `(Auto) Skills load on-demand` | Global: `~/.kiro/skills/` ยท Workspace: `.kiro/skills/` | -| **Kiro IDE** | IDE | `/skill-name or (Auto)` | Global: `~/.kiro/skills/` ยท Workspace: `.kiro/skills/` | -| **Antigravity** | IDE | `(Agent Mode) Use skill...` | Global: `~/.gemini/antigravity/skills/` ยท Workspace: `.agent/skills/` | -| **Cursor** | IDE | `@skill-name (in Chat)` | `.cursor/skills/` | -| **Copilot** | Ext | `(Paste content manually)` | N/A | -| **OpenCode** | CLI | `opencode run @skill-name` | `.agents/skills/` | -| **AdaL CLI** | CLI | `(Auto) Skills load on-demand` | `.adal/skills/` | +| Tool | Type | Compatibility | Installation Path | +| ------------------- | --------- | ------------- | ---------------------------------------- | +| **Claude Code** | CLI | โœ… Full | `.claude/skills/` or `.agent/skills/` | +| **Gemini CLI** | CLI | โœ… Full | `.gemini/skills/` or `.agent/skills/` | +| **Codex CLI** | CLI | โœ… Full | `.codex/skills/` or `.agent/skills/` | +| **Antigravity IDE** | IDE | โœ… Full | `.agent/skills/` | +| **Cursor** | IDE | โœ… Full | `.cursor/skills/` or project root | +| **GitHub Copilot** | Extension | โš ๏ธ Partial | Copy skill content to `.github/copilot/` | +| **OpenCode** | CLI | โœ… Full | `.opencode/skills/` or `.agent/skills/` | > [!TIP] -> **Default installer path**: `~/.gemini/antigravity/skills` (Antigravity global). Use `--path ~/.agent/skills` for workspace-specific install. For manual clone, `.agent/skills/` works as workspace path for Antigravity. -> **OpenCode Path Update**: opencode path is changed to `.agents/skills` for global skills. See [Place Files](https://opencode.ai/docs/skills/#place-files) directive on OpenCode Docs. +> Most tools auto-discover skills in `.agent/skills/`. For maximum compatibility, clone to this directory. -> [!WARNING] -> **Windows Users**: this repository uses **symlinks** for official skills. -> See [Troubleshooting](#troubleshooting) for the exact fix. +--- + +Whether you are using **Gemini CLI**, **Claude Code**, **Codex CLI**, **Cursor**, **GitHub Copilot**, **Antigravity**, or **OpenCode**, these skills are designed to drop right in and supercharge your AI agent. + +This repository aggregates the best capabilities from across the open-source community, transforming your AI assistant into a full-stack digital agency capable of Engineering, Design, Security, Marketing, and Autonomous Operations. + +## Features & Categories + +The repository is organized into several key areas of expertise: + +| Category | Skills Count | Key Skills Included | +| :-------------------------- | :----------- | :--------------------------------------------------------------------------------------------------------------------------- | +| **๐Ÿ›ธ 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 | +| **๐ŸŽจ 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 | +| **๐Ÿ—๏ธ 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) | +| **๐Ÿ“„ Document Processing** | **~4** | DOCX (Official), PDF (Official), PPTX (Official), XLSX (Official) | +| **๐Ÿงช Testing & QA** | **~4** | Webapp Testing, Playwright Automation, Test Fixing, Testing Patterns | +| **๐Ÿ“ˆ Product & Strategy** | **~8** | Product Manager Toolkit, Content Creator, ASO, Doc Co-authoring, Brainstorming, Internal Comms | +| **๐Ÿ“ฃ Marketing & Growth** | **~23** | Page CRO, Copywriting, SEO Audit, Paid Ads, Email Sequence, Pricing Strategy, Referral Program, Launch Strategy | +| **๐Ÿš€ Maker Tools** | **~11** | Micro-SaaS Launcher, Browser Extension Builder, Telegram Bot, AI Wrapper Product, Viral Generator, 3D Web Experience | + +--- + +## Full Skill Registry (179/179) + +Below is the complete list of available skills. Each skill folder contains a `SKILL.md` that can be imported into Antigravity or Claude Code. + +> [!NOTE] > **Document Skills**: We provide both **community** and **official Anthropic** versions for DOCX, PDF, PPTX, and XLSX. Locally, the official versions are used by default (via symlinks). In the repository, both versions are available for flexibility. + +| Skill Name | Description | Path | +| :-------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------- | +| **3D Web Experience** | Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL. | `skills/3d-web-experience` | +| **A/B Test Setup** | Plan and implement A/B tests with proper experiment design, statistical significance, and test analysis. | `skills/ab-test-setup` | +| **Active Directory Attacks** | This skill should be used when the user asks to "attack Active Directory", "exploit AD", "Kerberoasting", "DCSync", "pass-the-hash", "BloodHound enumeration", "Golden Ticket", "Silver Ticket", "AS-REP roasting", "NTLM relay", or needs guidance on Windows domain penetration testing. | `skills/active-directory-attacks` | +| **Address GitHub Comments** | Use when you need to address review or issue comments on an open GitHub Pull Request using the gh CLI. | `skills/address-github-comments` | +| **Agent Evaluation** | Testing and benchmarking LLM agents including behavioral testing, capability assessment, reliability metrics. | `skills/agent-evaluation` | +| **Agent Manager Skill** | Use when you need to manage multiple local CLI agents via tmux sessions (start/stop/monitor/assign) with cron-friendly scheduling. | `skills/agent-manager-skill` | +| **Agent Memory Systems** | Memory architecture for agents: short-term, long-term (vector stores), and cognitive architectures. | `skills/agent-memory-systems` | +| **Agent Tool Builder** | Tool design from schema to error handling. JSON Schema best practices, validation, and MCP. | `skills/agent-tool-builder` | +| **AI Agents Architect** | Expert in autonomous AI agents. Tool use, memory systems, planning strategies, multi-agent orchestration. | `skills/ai-agents-architect` | +| **AI Product** | LLM integration patterns, RAG architecture, prompt engineering, AI UX, and cost optimization. | `skills/ai-product` | +| **AI Wrapper Product** | Building products that wrap AI APIs into focused tools. Prompt engineering, cost management. | `skills/ai-wrapper-product` | +| **Algolia Search** | Algolia search implementation, indexing strategies, React InstantSearch, relevance tuning. | `skills/algolia-search` | +| **Algorithmic Art** | Creating algorithmic art using p5. | `skills/algorithmic-art` | +| **Analytics Tracking** | Set up analytics tracking with GA4, GTM, and custom event implementations for marketing measurement. | `skills/analytics-tracking` | +| **API Fuzzing for Bug Bounty** | This skill should be used when the user asks to "test API security", "fuzz APIs", "find IDOR vulnerabilities", "test REST API", "test GraphQL", "API penetration testing", "bug bounty API testing", or needs guidance on API security assessment techniques. | `skills/api-fuzzing-bug-bounty` | +| **App Store Optimization** | Complete App Store Optimization (ASO) toolkit for researching, optimizing, and tracking mobile app performance on Apple App Store and Google Play Store. | `skills/app-store-optimization` | +| **Autonomous Agent Patterns** | "Design patterns for building autonomous coding agents. | `skills/autonomous-agent-patterns` | +| **Autonomous Agents** | AI systems that independently decompose goals, plan actions, execute tools. ReAct, reflection. | `skills/autonomous-agents` | +| **AWS Penetration Testing** | This skill should be used when the user asks to "pentest AWS", "test AWS security", "enumerate IAM", "exploit cloud infrastructure", "AWS privilege escalation", "S3 bucket testing", "metadata SSRF", "Lambda exploitation", or needs guidance on Amazon Web Services security assessment. | `skills/aws-penetration-testing` | +| **AWS Serverless** | Serverless on AWS. Lambda, API Gateway, DynamoDB, SQS/SNS, SAM/CDK deployment. | `skills/aws-serverless` | +| **Azure Functions** | Azure Functions patterns. Isolated worker model, Durable Functions, cold start optimization. | `skills/azure-functions` | +| **Backend Guidelines** | Comprehensive backend development guide for Node. | `skills/backend-dev-guidelines` | +| **BlockRun** | Agent wallet for LLM micropayments. Use when user needs capabilities Claude lacks (image generation, real-time X/Twitter data) or explicitly requests external models ("blockrun", "use grok", "use gpt", "dall-e", "deepseek"). | `skills/blockrun` | +| **Brainstorming** | "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. | `skills/brainstorming` | +| **Brand Guidelines (Anthropic)** | Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. | `skills/brand-guidelines-anthropic` | +| **Brand Guidelines (Community)** | Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. | `skills/brand-guidelines-community` | +| **Broken Authentication Testing** | This skill should be used when the user asks to "test for broken authentication vulnerabilities", "assess session management security", "perform credential stuffing tests", "evaluate password policies", "test for session fixation", or "identify authentication bypass flaws". | `skills/broken-authentication` | +| **Browser Automation** | Browser automation with Playwright and Puppeteer. Testing, scraping, agentic control. | `skills/browser-automation` | +| **Browser Extension Builder** | Building browser extensions - Chrome, Firefox. Manifest v3, content scripts, monetization. | `skills/browser-extension-builder` | +| **BullMQ Specialist** | BullMQ for Redis-backed job queues, background processing in Node.js/TypeScript. | `skills/bullmq-specialist` | +| **Bun Development** | "Modern JavaScript/TypeScript development with Bun runtime. | `skills/bun-development` | +| **Burp Suite Web Application Testing** | This skill should be used when the user asks to "intercept HTTP traffic", "modify web requests", "use Burp Suite for testing", "perform web vulnerability scanning", "test with Burp Repeater", "analyze HTTP history", or "configure proxy for web testing". | `skills/burp-suite-testing` | +| **Canvas Design** | Create beautiful visual art in . | `skills/canvas-design` | +| **Claude Code Guide** | Master guide for using Claude Code effectively. | `skills/claude-code-guide` | +| **Claude D3.js** | Creating interactive data visualisations using d3. | `skills/claude-d3js-skill` | +| **Clerk Auth** | Clerk auth implementation, middleware, organizations, webhooks, user sync. | `skills/clerk-auth` | +| **Cloud Penetration Testing** | This skill should be used when the user asks to "perform cloud penetration testing", "assess Azure or AWS or GCP security", "enumerate cloud resources", "exploit cloud misconfigurations", "test O365 security", "extract secrets from cloud environments", or "audit cloud infrastructure". | `skills/cloud-penetration-testing` | +| **Computer Use Agents** | AI agents that interact with computers like humans. Screen control, sandboxing. | `skills/computer-use-agents` | +| **Concise Planning** | Use when a user asks for a plan for a coding task, to generate a clear, actionable, and atomic checklist. | `skills/concise-planning` | +| **Competitor Alternatives** | Create compelling competitor comparison and alternative pages for SEO and conversions. | `skills/competitor-alternatives` | +| **Content Creator** | Create SEO-optimized marketing content with consistent brand voice. | `skills/content-creator` | +| **Context Window Management** | Managing LLM context windows. Summarization, trimming, routing. | `skills/context-window-management` | +| **Conversation Memory** | Persistent memory for LLM conversations. Short-term, long-term, entity-based memory. | `skills/conversation-memory` | +| **Core Components** | Core component library and design system patterns. | `skills/core-components` | +| **Copy Editing** | Edit and polish existing marketing copy with a systematic seven-sweeps framework. | `skills/copy-editing` | +| **Copywriting** | Write compelling marketing copy for homepages, landing pages, pricing pages, and feature pages. | `skills/copywriting` | +| **CrewAI** | Role-based multi-agent framework. Agent design, task definition, crew orchestration. | `skills/crewai` | +| **Cross-Site Scripting and HTML Injection Testing** | This skill should be used when the user asks to "test for XSS vulnerabilities", "perform cross-site scripting attacks", "identify HTML injection flaws", "exploit client-side injection vulnerabilities", "steal cookies via XSS", or "bypass content security policies". | `skills/xss-html-injection` | +| **Discord Bot Architect** | Production Discord bots. Discord.js, Pycord, slash commands, sharding. | `skills/discord-bot-architect` | +| **Dispatching Parallel Agents** | Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies. | `skills/dispatching-parallel-agents` | +| **Doc Co-authoring** | Guide users through a structured workflow for co-authoring documentation. | `skills/doc-coauthoring` | +| **DOCX (Official)** | "Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. | `skills/docx-official` | +| **Email Sequence** | Create and optimize email sequences, drip campaigns, and lifecycle email programs. | `skills/email-sequence` | +| **Email Systems** | Transactional email, marketing automation, deliverability, infrastructure. | `skills/email-systems` | +| **Ethical Hacking Methodology** | This skill should be used when the user asks to "learn ethical hacking", "understand penetration testing lifecycle", "perform reconnaissance", "conduct security scanning", "exploit vulnerabilities", or "write penetration test reports". | `skills/ethical-hacking-methodology` | +| **Executing Plans** | Use when you have a written implementation plan to execute in a separate session with review checkpoints. | `skills/executing-plans` | +| **File Organizer** | Intelligently organizes files and folders by understanding context, finding duplicates, and suggesting better organizational structures. | `skills/file-organizer` | +| **File Path Traversal Testing** | This skill should be used when the user asks to "test for directory traversal", "exploit path traversal vulnerabilities", "read arbitrary files through web applications", "find LFI vulnerabilities", or "access files outside web root". | `skills/file-path-traversal` | +| **File Uploads** | File uploads and cloud storage. S3, Cloudflare R2, presigned URLs. | `skills/file-uploads` | +| **Finishing Dev Branch** | Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup. | `skills/finishing-a-development-branch` | +| **Firebase** | Firebase Auth, Firestore, Realtime Database, Cloud Functions, Storage. | `skills/firebase` | +| **Form CRO** | Optimize lead capture forms, contact forms, demo request forms for higher conversion rates. | `skills/form-cro` | +| **Free Tool Strategy** | Plan and build free tools for marketing, lead generation, and SEO value. | `skills/free-tool-strategy` | +| **Frontend Design** | Create distinctive, production-grade frontend interfaces with high design quality. | `skills/frontend-design` | +| **Frontend Guidelines** | Frontend development guidelines for React/TypeScript applications. | `skills/frontend-dev-guidelines` | +| **GCP Cloud Run** | Serverless on GCP. Cloud Run services and functions, Pub/Sub. | `skills/gcp-cloud-run` | +| **Git Pushing** | Stage, commit, and push git changes with conventional commit messages. | `skills/git-pushing` | +| **GitHub Workflow Automation** | "Automate GitHub workflows with AI assistance. | `skills/github-workflow-automation` | +| **GraphQL** | Schema design, resolvers, DataLoader, federation, Apollo/urql integration. | `skills/graphql` | +| **HTML Injection Testing** | This skill should be used when the user asks to "test for HTML injection", "inject HTML into web pages", "perform HTML injection attacks", "deface web applications", or "test content injection vulnerabilities". | `skills/html-injection-testing` | +| **HubSpot Integration** | HubSpot CRM integration. OAuth, CRM objects, webhooks, custom objects. | `skills/hubspot-integration` | +| **IDOR Vulnerability Testing** | This skill should be used when the user asks to "test for insecure direct object references," "find IDOR vulnerabilities," "exploit broken access control," "enumerate user IDs or object references," or "bypass authorization to access other users' data. | `skills/idor-testing` | +| **Inngest** | Inngest for serverless background jobs, event-driven workflows. | `skills/inngest` | +| **Interactive Portfolio** | Building portfolios that land jobs. Developer, designer portfolios. | `skills/interactive-portfolio` | +| **Internal Comms (Anthropic)** | A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. | `skills/internal-comms-anthropic` | +| **Internal Comms (Community)** | A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. | `skills/internal-comms-community` | +| **JavaScript Mastery** | "Comprehensive JavaScript reference covering 33+ essential concepts every developer should know. | `skills/javascript-mastery` | +| **Kaizen** | Guide for continuous improvement, error proofing, and standardization. | `skills/kaizen` | +| **Langfuse** | Open-source LLM observability. Tracing, prompt management, evaluation. | `skills/langfuse` | +| **LangGraph** | Stateful, multi-actor AI applications. Graph construction, persistence. | `skills/langgraph` | +| **Launch Strategy** | Plan product launches, feature announcements, and go-to-market strategies. | `skills/launch-strategy` | +| **Linux Privilege Escalation** | This skill should be used when the user asks to "escalate privileges on Linux", "find privesc vectors on Linux systems", "exploit sudo misconfigurations", "abuse SUID binaries", "exploit cron jobs for root access", "enumerate Linux systems for privilege escalation", or "gain root access from low-privilege shell". | `skills/linux-privilege-escalation` | +| **Linux Shell Scripting** | This skill should be used when the user asks to "create bash scripts", "automate Linux tasks", "monitor system resources", "backup files", "manage users", or "write production shell scripts". | `skills/linux-shell-scripting` | +| **LLM App Patterns** | "Production-ready patterns for building LLM applications. | `skills/llm-app-patterns` | +| **Loki Mode** | Multi-agent autonomous startup system for Claude Code. | `skills/loki-mode` | +| **Marketing Ideas** | 140 proven SaaS marketing ideas and strategies organized by category. | `skills/marketing-ideas` | +| **Marketing Psychology** | 70+ mental models and psychological principles for marketing and persuasion. | `skills/marketing-psychology` | +| **MCP Builder** | Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. | `skills/mcp-builder` | +| **Metasploit Framework** | This skill should be used when the user asks to "use Metasploit for penetration testing", "exploit vulnerabilities with msfconsole", "create payloads with msfvenom", "perform post-exploitation", "use auxiliary modules for scanning", or "develop custom exploits". | `skills/metasploit-framework` | +| **Moodle External API Development** | Create custom external web service APIs for Moodle LMS. Use when implementing web services for course management, user tracking, quiz operations, or custom plugin functionality. Covers parameter validation, database operations, error handling, service registration, and Moodle coding standards. | `skills/moodle-external-api-development` | +| **Micro-SaaS Launcher** | Launching small SaaS products fast. Idea validation, MVP, pricing. | `skills/micro-saas-launcher` | +| **Neon Postgres** | Neon serverless Postgres, branching, connection pooling, Prisma integration. | `skills/neon-postgres` | +| **Network 101** | This skill should be used when the user asks to "set up a web server", "configure HTTP or HTTPS", "perform SNMP enumeration", "configure SMB shares", "test network services", or needs guidance on configuring and testing network services for penetration testing labs. | `skills/network-101` | +| **Next.js Supabase Auth** | Supabase Auth with Next.js App Router. Auth middleware. | `skills/nextjs-supabase-auth` | +| **NotebookLM** | Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. | `skills/notebooklm` | +| **Notion Template Business** | Building and selling Notion templates. Design, pricing, marketing. | `skills/notion-template-business` | +| **Onboarding CRO** | Optimize post-signup onboarding, user activation, and time-to-value. | `skills/onboarding-cro` | +| **PDF (Official)** | Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. | `skills/pdf-official` | +| **Pentest Checklist** | This skill should be used when the user asks to "plan a penetration test", "create a security assessment checklist", "prepare for penetration testing", "define pentest scope", "follow security testing best practices", or needs a structured methodology for penetration testing engagements. | `skills/pentest-checklist` | +| **Pentest Commands** | This skill should be used when the user asks to "run pentest commands", "scan with nmap", "use metasploit exploits", "crack passwords with hydra or john", "scan web vulnerabilities with nikto", "enumerate networks", or needs essential penetration testing command references. | `skills/pentest-commands` | +| **Page CRO** | Conversion rate optimization for marketing pages - homepages, landing pages, pricing pages. | `skills/page-cro` | +| **Paid Ads** | Create and optimize paid ad campaigns on Google Ads, Meta, LinkedIn, and other platforms. | `skills/paid-ads` | +| **Paywall Upgrade CRO** | Optimize in-app paywalls, upgrade screens, and freemium conversion moments. | `skills/paywall-upgrade-cro` | +| **Personal Tool Builder** | Building custom tools. Rapid prototyping, local-first apps, CLI tools. | `skills/personal-tool-builder` | +| **Plaid Fintech** | Plaid API for banking. Link token flows, transactions, ACH. | `skills/plaid-fintech` | +| **Planning With Files** | Implements Manus-style file-based planning for complex tasks. | `skills/planning-with-files` | +| **Playwright Automation** | Complete browser automation with Playwright. | `skills/playwright-skill` | +| **Popup CRO** | Create and optimize popups, modals, and overlays for conversion. | `skills/popup-cro` | +| **PPTX (Official)** | "Presentation creation, editing, and analysis. | `skills/pptx-official` | +| **Privilege Escalation Methods** | This skill should be used when the user asks to "escalate privileges", "get root access", "become administrator", "privesc techniques", "abuse sudo", "exploit SUID binaries", "Kerberoasting", "pass-the-ticket", "token impersonation", or needs guidance on post-exploitation privilege escalation for Linux or Windows systems. | `skills/privilege-escalation-methods` | +| **Pricing Strategy** | Design pricing, packaging, and monetization strategy for SaaS products. | `skills/pricing-strategy` | +| **Product Toolkit** | Comprehensive toolkit for product managers including RICE prioritization, customer interview analysis, PRD templates, discovery frameworks, and go-to-market strategies. | `skills/product-manager-toolkit` | +| **Prompt Caching** | Caching strategies for LLM prompts. Anthropic caching, CAG. | `skills/prompt-caching` | +| **Prompt Engineer** | Designing prompts for LLM applications. Structure, evaluation. | `skills/prompt-engineer` | +| **Prompt Engineering** | Expert guide on prompt engineering patterns, best practices, and optimization techniques. | `skills/prompt-engineering` | +| **Prompt Library** | "Curated collection of high-quality prompts for various use cases. | `skills/prompt-library` | +| **Programmatic SEO** | Build SEO-driven pages at scale using templates and data. | `skills/programmatic-seo` | +| **RAG Engineer** | Building RAG systems. Embedding models, vector databases, chunking. | `skills/rag-engineer` | +| **RAG Implementation** | RAG patterns. Chunking, embeddings, vector stores. | `skills/rag-implementation` | +| **React Best Practices** | React and Next. | `skills/react-best-practices` | +| **React UI Patterns** | Modern React UI patterns for loading states, error handling, and data fetching. | `skills/react-ui-patterns` | +| **Receiving Code Review** | Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation. | `skills/receiving-code-review` | +| **Red Team Tools and Methodology** | This skill should be used when the user asks to "follow red team methodology", "perform bug bounty hunting", "automate reconnaissance", "hunt for XSS vulnerabilities", "enumerate subdomains", or needs security researcher techniques and tool configurations from top bug bounty hunters. | `skills/red-team-tools` | +| **Referral Program** | Design referral programs, affiliate programs, and word-of-mouth strategies. | `skills/referral-program` | +| **Requesting Code Review** | Use when completing tasks, implementing major features, or before merging to verify work meets requirements. | `skills/requesting-code-review` | +| **Salesforce Development** | Salesforce integration, Apex development, Lightning components. | `skills/salesforce-development` | +| **Schema Markup** | Add structured data and JSON-LD schema markup for SEO and rich snippets. | `skills/schema-markup` | +| **Scroll Experience** | GSAP/Framer scroll-driven storytelling. Parallax effects. | `skills/scroll-experience` | +| **Security Scanning Tools** | This skill should be used when the user asks to "perform vulnerability scanning", "scan networks for open ports", "assess web application security", "scan wireless networks", "detect malware", "check cloud security", or "evaluate system compliance". | `skills/scanning-tools` | +| **Segment CDP** | Segment customer data platform. Event tracking, identity resolution. | `skills/segment-cdp` | +| **Senior Architect** | Comprehensive software architecture skill for designing scalable, maintainable systems using ReactJS, NextJS, NodeJS, Express, React Native, Swift, Kotlin, Flutter, Postgres, GraphQL, Go, Python. | `skills/senior-architect` | +| **Senior Fullstack** | Comprehensive fullstack development skill for building complete web applications with React, Next. | `skills/senior-fullstack` | +| **SEO Audit** | Audit technical and on-page SEO issues for better search rankings. | `skills/seo-audit` | +| **Shodan Reconnaissance and Pentesting** | This skill should be used when the user asks to "search for exposed devices on the internet," "perform Shodan reconnaissance," "find vulnerable services using Shodan," "scan IP ranges with Shodan," or "discover IoT devices and open ports. | `skills/shodan-reconnaissance` | +| **Shopify Apps** | Building Shopify apps. App Bridge, Polaris, webhooks. | `skills/shopify-apps` | +| **Shopify Development** | Build Shopify apps, extensions, themes using GraphQL Admin API, Shopify CLI, Polaris UI, and Liquid. Use when user asks about "shopify app", "checkout extension", "shopify theme", "liquid template", "polaris", "shopify graphql", "shopify webhook", or "metafields". | `skills/shopify-development` | +| **Signup Flow CRO** | Optimize signup, registration, and trial activation flows for higher conversions. | `skills/signup-flow-cro` | +| **Skill Creator** | Guide for creating effective skills. | `skills/skill-creator` | +| **Skill Developer** | Create and manage Claude Code skills following Anthropic best practices. | `skills/skill-developer` | +| **Slack Bot Builder** | Production Slack bots. Bolt framework, slash commands, modals. | `skills/slack-bot-builder` | +| **Slack GIF Creator** | Knowledge and utilities for creating animated GIFs optimized for Slack. | `skills/slack-gif-creator` | +| **SMTP Penetration Testing** | This skill should be used when the user asks to "perform SMTP penetration testing", "enumerate email users", "test for open mail relays", "grab SMTP banners", "brute force email credentials", or "assess mail server security". | `skills/smtp-penetration-testing` | +| **Social Content** | Create and schedule social media content for LinkedIn, Twitter/X, and other platforms. | `skills/social-content` | +| **Software Architecture** | Guide for quality focused software architecture. | `skills/software-architecture` | +| **SQL Injection Testing** | This skill should be used when the user asks to "test for SQL injection vulnerabilities", "perform SQLi attacks", "bypass authentication using SQL injection", "extract database information through injection", "detect SQL injection flaws", or "exploit database query vulnerabilities". | `skills/sql-injection-testing` | +| **SQLMap Database Penetration Testing** | This skill should be used when the user asks to "automate SQL injection testing," "enumerate database structure," "extract database credentials using sqlmap," "dump tables and columns from a vulnerable database," or "perform automated database penetration testing. | `skills/sqlmap-database-pentesting` | +| **SSH Penetration Testing** | This skill should be used when the user asks to "pentest SSH services", "enumerate SSH configurations", "brute force SSH credentials", "exploit SSH vulnerabilities", "perform SSH tunneling", or "audit SSH security". | `skills/ssh-penetration-testing` | +| **Stripe Integration** | Stripe patterns. Checkout, subscriptions, payment intents, webhooks. | `skills/stripe-integration` | +| **Subagent Driven Dev** | Use when executing implementation plans with independent tasks in the current session. | `skills/subagent-driven-development` | +| **Systematic Debugging** | Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes. | `skills/systematic-debugging` | +| **TDD** | Use when implementing any feature or bugfix, before writing implementation code. | `skills/test-driven-development` | +| **Telegram Bot Builder** | Building Telegram bots. Bot API, inline mode, payments, Mini Apps. | `skills/telegram-bot-builder` | +| **Telegram Mini App** | TON Connect, Telegram Mini Apps, wallet integration. | `skills/telegram-mini-app` | +| **Test Fixing** | Run tests and systematically fix all failing tests using smart error grouping. | `skills/test-fixing` | +| **Testing Patterns** | Jest testing patterns, factory functions, mocking strategies, and TDD workflow. | `skills/testing-patterns` | +| **Theme Factory** | Toolkit for styling artifacts with a theme. | `skills/theme-factory` | +| **Top 100 Vulnerabilities** | This skill should be used when the user asks to "identify web application vulnerabilities", "explain common security flaws", "understand vulnerability categories", "learn about injection attacks", "review access control weaknesses", "analyze API security issues", "assess security misconfigurations", "understand client-side vulnerabilities", "examine mobile and IoT security flaws", or "reference the OWASP-aligned vulnerability taxonomy". | `skills/top-web-vulnerabilities` | +| **Trigger.dev** | Trigger.dev for serverless background jobs. Long-running tasks. | `skills/trigger-dev` | +| **Twilio Communications** | Twilio for SMS, voice, video. Programmable messaging, OTP. | `skills/twilio-communications` | +| **UI/UX Pro Max** | "UI/UX design intelligence. | `skills/ui-ux-pro-max` | +| **Upstash QStash** | Upstash QStash for serverless message queues. | `skills/upstash-qstash` | +| **Using Git Worktrees** | Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification. | `skills/using-git-worktrees` | +| **Using Superpowers** | Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions. | `skills/using-superpowers` | +| **Vercel Deployment** | Vercel deployment. Edge functions, preview deployments. | `skills/vercel-deployment` | +| **Verification Before Completion** | Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always. | `skills/verification-before-completion` | +| **Viral Generator Builder** | Building shareable generators that go viral. | `skills/viral-generator-builder` | +| **Voice Agents** | Voice-based AI assistants. Speech-to-text, real-time conversation. | `skills/voice-agents` | +| **Voice AI Development** | Voice AI patterns. Wake words, streaming ASR, emotional TTS. | `skills/voice-ai-development` | +| **Web Artifacts** | Suite of tools for creating elaborate, multi-component claude. | `skills/web-artifacts-builder` | +| **Web Design Guidelines** | Review UI code for Web Interface Guidelines compliance. | `skills/web-design-guidelines` | +| **Webapp Testing** | Toolkit for interacting with and testing local web applications using Playwright. | `skills/webapp-testing` | +| **Windows Privilege Escalation** | This skill should be used when the user asks to "escalate privileges on Windows," "find Windows privesc vectors," "enumerate Windows for privilege escalation," "exploit Windows misconfigurations," or "perform post-exploitation privilege escalation. | `skills/windows-privilege-escalation` | +| **Wireshark Network Traffic Analysis** | This skill should be used when the user asks to "analyze network traffic with Wireshark", "capture packets for troubleshooting", "filter PCAP files", "follow TCP/UDP streams", "detect network anomalies", "investigate suspicious traffic", or "perform protocol analysis". | `skills/wireshark-analysis` | +| **WordPress Penetration Testing** | This skill should be used when the user asks to "pentest WordPress sites", "scan WordPress for vulnerabilities", "enumerate WordPress users, themes, or plugins", "exploit WordPress vulnerabilities", or "use WPScan". | `skills/wordpress-penetration-testing` | +| **Workflow Automation** | "Design and implement automated workflows combining visual logic with custom code. | `skills/workflow-automation` | +| **Writing Plans** | Use when you have a spec or requirements for a multi-step task, before touching code. | `skills/writing-plans` | +| **Writing Skills** | Use when creating new skills, editing existing skills, or verifying skills work before deployment. | `skills/writing-skills` | +| **XLSX (Official)** | "Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. | `skills/xlsx-official` | +| **Zapier/Make Patterns** | No-code automation. Zapier, Make, n8n workflows. | `skills/zapier-make-patterns` | + +> [!TIP] +> Use the `validate_skills.py` script in the `scripts/` directory to ensure all skills are properly formatted and ready for use. --- ## Installation -To use these skills with **Claude Code**, **Gemini CLI**, **Codex CLI**, **Kiro CLI**, **Kiro IDE**, **Cursor**, **Antigravity**, **OpenCode**, or **AdaL**: - -### Option A: npx (recommended) +To use these skills with **Claude Code**, **Gemini CLI**, **Codex CLI**, **Cursor**, **Antigravity**, or **OpenCode**, clone this repository into your agent's skills directory: ```bash -# Default: ~/.gemini/antigravity/skills (Antigravity global) -npx antigravity-awesome-skills - -# Antigravity (explicit; same as default) -npx antigravity-awesome-skills --antigravity - -# Kiro CLI/IDE (global) -npx antigravity-awesome-skills --path ~/.kiro/skills - -# Kiro CLI/IDE (workspace) -npx antigravity-awesome-skills --path .kiro/skills - -# Cursor -npx antigravity-awesome-skills --cursor - -# Claude Code -npx antigravity-awesome-skills --claude - -# Gemini CLI -npx antigravity-awesome-skills --gemini - -# Codex CLI -npx antigravity-awesome-skills --codex - -# Kiro CLI -npx antigravity-awesome-skills --kiro - -# OpenCode -npx antigravity-awesome-skills --path .agents/skills - -# AdaL CLI -npx antigravity-awesome-skills --path .adal/skills - -# Workspace-specific (e.g. .agent/skills for Antigravity workspace) -npx antigravity-awesome-skills --path ~/.agent/skills - -# Custom path -npx antigravity-awesome-skills --path ./my-skills -``` - -Run `npx antigravity-awesome-skills --help` for all options. If the directory already exists, the installer runs `git pull` to update. - -### Option B: git clone - -Without `--path`, the npx installer uses `~/.gemini/antigravity/skills`. For manual clone or a different path (e.g. workspace `.agent/skills`), use one of the following: - -```bash -# Antigravity global (matches npx default) -git clone https://github.com/sickn33/antigravity-awesome-skills.git ~/.gemini/antigravity/skills - -# Workspace-specific (e.g. .agent/skills in your project) +# Universal installation (works with most tools) git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills -# Kiro CLI/IDE global -git clone https://github.com/sickn33/antigravity-awesome-skills.git ~/.kiro/skills - # Claude Code specific git clone https://github.com/sickn33/antigravity-awesome-skills.git .claude/skills # Gemini CLI specific git clone https://github.com/sickn33/antigravity-awesome-skills.git .gemini/skills -# Codex CLI specific -git clone https://github.com/sickn33/antigravity-awesome-skills.git .codex/skills - # Cursor specific git clone https://github.com/sickn33/antigravity-awesome-skills.git .cursor/skills - -# OpenCode -git clone https://github.com/sickn33/antigravity-awesome-skills.git .agents/skills - -# AdaL CLI specific -git clone https://github.com/sickn33/antigravity-awesome-skills.git .adal/skills ``` -### Option C: Kiro IDE Import (GUI) - -For Kiro IDE users, you can import individual skills directly: - -1. Open **Agent Steering & Skills** panel in Kiro IDE -2. Click **+** โ†’ **Import a skill** โ†’ **GitHub** -3. Paste skill URL: `https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/[skill-name]` -4. Example: `https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/aws-cost-optimizer` - -> **Note**: This imports one skill at a time. For bulk installation, use Option A or B above. - ---- - -## Troubleshooting - -### `npx antigravity-awesome-skills` returns 404 - -Use the GitHub package fallback: - -```bash -npx github:sickn33/antigravity-awesome-skills -``` - -### Windows clone issues (symlinks) - -This repository uses symlinks for official skills. Enable Developer Mode or run Git as Administrator, then clone with: - -```bash -git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills -``` - -### Skills installed but not detected by your tool - -Install to the tool-specific path. Use installer flags: `--antigravity` (default), `--claude`, `--gemini`, `--codex`, `--cursor`, or `--path ` for a custom location (e.g. `~/.agent/skills` for Antigravity workspace). - -### Update an existing installation - -**Good news!** You no longer need to manually run `git pull` or `npx antigravity-awesome-skills` to update your skills. - -- **Windows:** Double-click **`START_APP.bat`** (or run it in your terminal). -- **macOS/Linux:** Run `cd web-app && npm run app:dev` from the repo root. - -Both methods automatically fetch and merge the latest skills from the original repository every time you open the Web App, ensuring you always have the most up-to-date catalog. - -### Reinstall from scratch - -```bash -rm -rf ~/.gemini/antigravity/skills -npx antigravity-awesome-skills -``` - ---- - -## Curated Collections - -**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 950+ skills one by one. - -### โš ๏ธ Important: Bundles Are NOT Separate Installations! - -**Common confusion:** "Do I need to install each bundle separately?" - -**Answer: NO!** Here's what bundles actually are: - -**What bundles ARE:** - -- โœ… Recommended skill lists organized by role -- โœ… Curated starting points to help you decide what to use -- โœ… Time-saving shortcuts for discovering relevant skills - -**What bundles are NOT:** - -- โŒ Separate installations or downloads -- โŒ Different git commands -- โŒ Something you need to "activate" - -### How to use bundles: - -1. **Install the repository once** (you already have all skills) -2. **Browse bundles** in [docs/BUNDLES.md](docs/BUNDLES.md) to find your role -3. **Pick 3-5 skills** from that bundle to start using in your prompts -4. **Reference them in your conversations** with your AI (e.g., "Use @brainstorming...") - -For detailed examples of how to actually use skills, see the [**Usage Guide**](docs/USAGE.md). - -### Examples: - -- Building a SaaS MVP: `Essentials` + `Full-Stack Developer` + `QA & Testing`. -- Hardening production: `Security Developer` + `DevOps & Cloud` + `Observability & Monitoring`. -- Shipping OSS changes: `Essentials` + `OSS Maintainer`. - -## Antigravity Workflows - -Bundles help you choose skills. Workflows help you execute them in order. - -- Use bundles when you need curated recommendations by role. -- Use workflows when you need step-by-step execution for a concrete goal. - -Start here: - -- [docs/WORKFLOWS.md](docs/WORKFLOWS.md): human-readable playbooks. -- [data/workflows.json](data/workflows.json): machine-readable workflow metadata. - -Initial workflows include: - -- Ship a SaaS MVP -- Security Audit for a Web App -- Build an AI Agent System -- QA and Browser Automation (with optional `@go-playwright` support for Go stacks) - -## Features & Categories - -The repository is organized into specialized domains to transform your AI into an expert across the entire software development lifecycle: - -| Category | Focus | Example skills | -| :------------- | :------------------------------------------------- | :------------------------------------------------------------------------------ | -| Architecture | System design, ADRs, C4, and scalable patterns | `architecture`, `c4-context`, `senior-architect` | -| Business | Growth, pricing, CRO, SEO, and go-to-market | `copywriting`, `pricing-strategy`, `seo-audit` | -| Data & AI | LLM apps, RAG, agents, observability, analytics | `rag-engineer`, `prompt-engineer`, `langgraph` | -| Development | Language mastery, framework patterns, code quality | `typescript-expert`, `python-patterns`, `react-patterns` | -| General | Planning, docs, product ops, writing, guidelines | `brainstorming`, `doc-coauthoring`, `writing-plans` | -| Infrastructure | DevOps, cloud, serverless, deployment, CI/CD | `docker-expert`, `aws-serverless`, `vercel-deployment` | -| Security | AppSec, pentesting, vuln analysis, compliance | `api-security-best-practices`, `sql-injection-testing`, `vulnerability-scanner` | -| Testing | TDD, test design, fixes, QA workflows | `test-driven-development`, `testing-patterns`, `test-fixing` | -| Workflow | Automation, orchestration, jobs, agents | `workflow-automation`, `inngest`, `trigger-dev` | - -Counts change as new skills are added. For the current full registry, see [CATALOG.md](CATALOG.md). - -## Browse 1002+ Skills - -We have moved the full skill registry to a dedicated catalog to keep this README clean, and we've also introduced an interactive **Web App**! - -### ๐ŸŒ Interactive Skills Web App - -A modern web interface to explore, search, and use the 950+ skills directly from your browser. - -#### โœจ Features - -- ๐Ÿ” **Full-text search** โ€“ Search skills by name, description, or content -- ๐Ÿท๏ธ **Category filters** โ€“ Frontend, Backend, Security, DevOps, etc. -- ๐Ÿ“ **Markdown rendering** โ€“ View complete documentation with syntax highlighting -- ๐Ÿ“‹ **Copy buttons** โ€“ Copy `@skill-name` or full content in 1 click -- ๐Ÿ› ๏ธ **Prompt Builder** โ€“ Add custom context before copying -- ๐ŸŒ™ **Dark mode** โ€“ Adaptive light/dark interface -- โšก **Auto-update** โ€“ Automatically syncs with upstream repo - -#### ๐Ÿš€ Quick Start - -**Windows:** - -```bash -# Double-click or terminal -START_APP.bat -``` - -**macOS/Linux:** - -```bash -# 1. Install dependencies (first time) -cd web-app && npm install - -# 2. Setup assets and launch -npm run app:dev -``` - -**Available npm commands:** - -```bash -npm run app:setup # Copy skills to web-app/public/ -npm run app:dev # Start dev server -npm run app:build # Production build -npm run app:preview # Preview production build -``` - -The app automatically opens at `http://localhost:5173` (or alternative port). - -#### ๐Ÿ› ๏ธ Interactive Prompt Builder - -On each skill page you'll find the **Interactive Prompt Builder**. Instead of manually copying `@skill-name` and writing your requirements separately in your IDE: - -1. Type your specific project constraints into the text box (e.g., "Use React 19, TypeScript and Tailwind"). -2. Click **Copy Prompt** โ€” copies a fully formatted, ready-to-run prompt combining `@skill-name` + your custom context. -3. Or click **Copy Full Content** โ€” copies the full skill documentation. -4. Paste into your AI assistant (Claude, Cursor, Gemini, etc.). - -๐Ÿ‘‰ **[View the Complete Skill Catalog (CATALOG.md)](CATALOG.md)** - --- ## How to Contribute @@ -408,76 +326,27 @@ We welcome contributions from the community! To add a new skill: 1. **Fork** the repository. 2. **Create a new directory** inside `skills/` for your skill. -3. **Add a `SKILL.md`** with the required frontmatter (name, description, risk, source). See [docs/SKILL_ANATOMY.md](docs/SKILL_ANATOMY.md) and [docs/QUALITY_BAR.md](docs/QUALITY_BAR.md). -4. **Add date tracking** (optional): Include `date_added: "YYYY-MM-DD"` in frontmatter. See [docs/SKILLS_DATE_TRACKING.md](docs/SKILLS_DATE_TRACKING.md) for details. -5. **Run validation**: `npm run validate` (or `npm run validate:strict` for CI). Optionally run `python3 scripts/validate_references.py` if you touch workflows or bundles. -6. **Submit a Pull Request**. +3. **Add a `SKILL.md`** with the required frontmatter (name and description). +4. **Run validation**: `python3 scripts/validate_skills.py`. +5. **Submit a Pull Request**. -Please ensure your skill follows the Antigravity/Claude Code best practices. Maintainers: see [docs/AUDIT.md](docs/AUDIT.md) for coherence checks and [.github/MAINTENANCE.md](.github/MAINTENANCE.md) for the full validation chain. - ---- - -## Community - -- [Community Guidelines](docs/COMMUNITY_GUIDELINES.md) -- [Security Policy](docs/SECURITY_GUARDRAILS.md) - ---- - -## Support the Project - -Support is optional. This project stays free and open-source for everyone. - -If this repository saves you time or helps you ship faster, you can support ongoing maintenance: - -- [โ˜• Buy me a book on Buy Me a Coffee](https://buymeacoffee.com/sickn33) - -Where support goes: - -- Skill curation, testing, and quality validation. -- Documentation updates, examples, and onboarding improvements. -- Faster triage and review of community issues and PRs. - -Prefer non-financial support: - -- Star the repository. -- Open clear, reproducible issues. -- Submit PRs (skills, docs, fixes). -- Share the project with other builders. +Please ensure your skill follows the Antigravity/Claude Code best practices. --- ## Credits & Sources -We stand on the shoulders of giants. - -๐Ÿ‘‰ **[View the Full Attribution Ledger](docs/SOURCES.md)** - -Key contributors and sources include: - -- **HackTricks** -- **OWASP** -- **Anthropic / OpenAI / Google** -- **The Open Source Community** - This collection would not be possible without the incredible work of the Claude Code community and official sources: ### Official Sources - **[anthropics/skills](https://github.com/anthropics/skills)**: Official Anthropic skills repository - Document manipulation (DOCX, PDF, PPTX, XLSX), Brand Guidelines, Internal Communications. - **[anthropics/claude-cookbooks](https://github.com/anthropics/claude-cookbooks)**: Official notebooks and recipes for building with Claude. -- **[remotion-dev/skills](https://github.com/remotion-dev/skills)**: Official Remotion skills - Video creation in React with 28 modular rules. - **[vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills)**: Vercel Labs official skills - React Best Practices, Web Design Guidelines. - **[openai/skills](https://github.com/openai/skills)**: OpenAI Codex skills catalog - Agent skills, Skill Creator, Concise Planning. -- **[supabase/agent-skills](https://github.com/supabase/agent-skills)**: Supabase official skills - Postgres Best Practices. -- **[microsoft/skills](https://github.com/microsoft/skills)**: Official Microsoft skills - Azure cloud services, Bot Framework, Cognitive Services, and enterprise development patterns across .NET, Python, TypeScript, Go, Rust, and Java. -- **[google-gemini/gemini-skills](https://github.com/google-gemini/gemini-skills)**: Official Gemini skills - Gemini API, SDK and model interactions. -- **[apify/agent-skills](https://github.com/apify/agent-skills)**: Official Apify skills - Web scraping, data extraction and automation. ### Community Contributors -- **[rmyndharis/antigravity-skills](https://github.com/rmyndharis/antigravity-skills)**: For the massive contribution of 300+ Enterprise skills and the catalog generation logic. -- **[amartelr/antigravity-workspace-manager](https://github.com/amartelr/antigravity-workspace-manager)**: Official Workspace Manager CLI companion to dynamically auto-provision subsets of skills across unlimited local development environments. - **[obra/superpowers](https://github.com/obra/superpowers)**: The original "Superpowers" by Jesse Vincent. - **[guanyang/antigravity-skills](https://github.com/guanyang/antigravity-skills)**: Core Antigravity extensions. - **[diet103/claude-code-infrastructure-showcase](https://github.com/diet103/claude-code-infrastructure-showcase)**: Infrastructure and Backend/Frontend Guidelines. @@ -486,23 +355,9 @@ This collection would not be possible without the incredible work of the Claude - **[zebbern/claude-code-guide](https://github.com/zebbern/claude-code-guide)**: Comprehensive Security suite & Guide (Source for ~60 new skills). - **[alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills)**: Senior Engineering and PM toolkit. - **[karanb192/awesome-claude-skills](https://github.com/karanb192/awesome-claude-skills)**: A massive list of verified skills for Claude Code. -- **[VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills)**: Curated collection of 61 high-quality skills including official team skills from Sentry, Trail of Bits, Expo, Hugging Face, and comprehensive context engineering suite (v4.3.0 integration). - **[zircote/.claude](https://github.com/zircote/.claude)**: Shopify development skill reference. - **[vibeforge1111/vibeship-spawner-skills](https://github.com/vibeforge1111/vibeship-spawner-skills)**: AI Agents, Integrations, Maker Tools (57 skills, Apache 2.0). - **[coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills)**: Marketing skills for CRO, copywriting, SEO, paid ads, and growth (23 skills, MIT). -- **[jonathimer/devmarketing-skills](https://github.com/jonathimer/devmarketing-skills)**: Developer marketing skills โ€” HN strategy, technical tutorials, docs-as-marketing, Reddit engagement, developer onboarding, and more (33 skills, MIT). -- **[Silverov/yandex-direct-skill](https://github.com/Silverov/yandex-direct-skill)**: Yandex Direct (API v5) advertising audit skill โ€” 55 automated checks, A-F scoring, campaign/ad/keyword analysis for the Russian PPC market (MIT). -- **[vudovn/antigravity-kit](https://github.com/vudovn/antigravity-kit)**: AI Agent templates with Skills, Agents, and Workflows (33 skills, MIT). -- **[affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code)**: Complete Claude Code configuration collection from Anthropic hackathon winner - skills only (8 skills, MIT). -- **[whatiskadudoing/fp-ts-skills](https://github.com/whatiskadudoing/fp-ts-skills)**: Practical fp-ts skills for TypeScript โ€“ fp-ts-pragmatic, fp-ts-react, fp-ts-errors (v4.4.0). -- **[webzler/agentMemory](https://github.com/webzler/agentMemory)**: Source for the agent-memory-mcp skill. -- **[sstklen/claude-api-cost-optimization](https://github.com/sstklen/claude-api-cost-optimization)**: Save 50-90% on Claude API costs with smart optimization strategies (MIT). -- **[Wittlesus/cursorrules-pro](https://github.com/Wittlesus/cursorrules-pro)**: Professional .cursorrules configurations for 8 frameworks - Next.js, React, Python, Go, Rust, and more. Works with Cursor, Claude Code, and Windsurf. -- **[nedcodes-ok/rule-porter](https://github.com/nedcodes-ok/rule-porter)**: Bidirectional rule converter between Cursor (.mdc), Claude Code (CLAUDE.md), GitHub Copilot, Windsurf, and legacy .cursorrules formats. Zero dependencies. -- **[SSOJet/skills](https://github.com/ssojet/skills)**: Production-ready SSOJet skills and integration guides for popular frameworks and platforms โ€” Node.js, Next.js, React, Java, .NET Core, Go, iOS, Android, and more. Works seamlessly with SSOJet SAML, OIDC, and enterprise SSO flows. Works with Cursor, Antigravity, Claude Code, and Windsurf. -- **[MojoAuth/skills](https://github.com/MojoAuth/skills)**: Production-ready MojoAuth guides and examples for popular frameworks like Node.js, Next.js, React, Java, .NET Core, Go, iOS, and Android. -- **[Xquik-dev/x-twitter-scraper](https://github.com/Xquik-dev/x-twitter-scraper)**: X (Twitter) data platform โ€” tweet search, user lookup, follower extraction, engagement metrics, giveaway draws, monitoring, webhooks, 19 extraction tools, MCP server. -- **[shmlkv/dna-claude-analysis](https://github.com/shmlkv/dna-claude-analysis)**: Personal genome analysis toolkit โ€” Python scripts analyzing raw DNA data across 17 categories (health risks, ancestry, pharmacogenomics, nutrition, psychology, etc.) with terminal-style single-page HTML visualization. ### Inspirations @@ -511,102 +366,24 @@ This collection would not be possible without the incredible work of the Claude --- -## Repo Contributors - - - Repository contributors - - -Made with [contrib.rocks](https://contrib.rocks). - -We officially thank the following contributors for their help in making this repository awesome! - -- [@sickn33](https://github.com/sickn33) -- [@munir-abbasi](https://github.com/munir-abbasi) -- [@ssumanbiswas](https://github.com/ssumanbiswas) -- [@zinzied](https://github.com/zinzied) -- [@Mohammad-Faiz-Cloud-Engineer](https://github.com/Mohammad-Faiz-Cloud-Engineer) -- [@Dokhacgiakhoa](https://github.com/Dokhacgiakhoa) -- [@IanJ332](https://github.com/IanJ332) -- [@chauey](https://github.com/chauey) -- [@ar27111994](https://github.com/ar27111994) -- [@8hrsk](https://github.com/8hrsk) -- [@itsmeares](https://github.com/itsmeares) -- [@GuppyTheCat](https://github.com/GuppyTheCat) -- [@fernandorych](https://github.com/fernandorych) -- [@nikolasdehor](https://github.com/nikolasdehor) -- [@talesperito](https://github.com/talesperito) -- [@jackjin1997](https://github.com/jackjin1997) -- [@HuynhNhatKhanh](https://github.com/HuynhNhatKhanh) -- [@liyin2015](https://github.com/liyin2015) -- [@arathiesh](https://github.com/arathiesh) -- [@Tiger-Foxx](https://github.com/Tiger-Foxx) -- [@Musayrlsms](https://github.com/Musayrlsms) -- [@sohamganatra](https://github.com/sohamganatra) -- [@SuperJMN](https://github.com/SuperJMN) -- [@SebConejo](https://github.com/SebConejo) -- [@Onsraa](https://github.com/Onsraa) -- [@truongnmt](https://github.com/truongnmt) -- [@code-vj](https://github.com/code-vj) -- [@viktor-ferenczi](https://github.com/viktor-ferenczi) -- [@vprudnikoff](https://github.com/vprudnikoff) -- [@Vonfry](https://github.com/Vonfry) -- [@Wittlesus](https://github.com/Wittlesus) -- [@avimak](https://github.com/avimak) -- [@buzzbysolcex](https://github.com/buzzbysolcex) -- [@c1c3ru](https://github.com/c1c3ru) -- [@ckdwns9121](https://github.com/ckdwns9121) -- [@developer-victor](https://github.com/developer-victor) -- [@fbientrigo](https://github.com/fbientrigo) -- [@junited31](https://github.com/junited31) -- [@KrisnaSantosa15](https://github.com/KrisnaSantosa15) -- [@nocodemf](https://github.com/nocodemf) -- [@sstklen](https://github.com/sstklen) -- [@taksrules](https://github.com/taksrules) -- [@thuanlm215](https://github.com/thuanlm215) -- [@zebbern](https://github.com/zebbern) -- [@vuth-dogo](https://github.com/vuth-dogo) -- [@ALEKGG1](https://github.com/ALEKGG1) -- [@Abdulrahmansoliman](https://github.com/Abdulrahmansoliman) -- [@alexmvie](https://github.com/alexmvie) -- [@Andruia](https://github.com/Andruia) -- [@acbhatt12](https://github.com/acbhatt12) -- [@BenedictKing](https://github.com/BenedictKing) -- [@rcigor](https://github.com/rcigor) -- [@whatiskadudoing](https://github.com/whatiskadudoing) -- [@k-kolomeitsev](https://github.com/k-kolomeitsev) -- [@Krishna-Modi12](https://github.com/Krishna-Modi12) -- [@kromahlusenii-ops](https://github.com/kromahlusenii-ops) -- [@djmahe4](https://github.com/djmahe4) -- [@maxdml](https://github.com/maxdml) -- [@mertbaskurt](https://github.com/mertbaskurt) -- [@nedcodes-ok](https://github.com/nedcodes-ok) -- [@LocNguyenSGU](https://github.com/LocNguyenSGU) -- [@KhaiTrang1995](https://github.com/KhaiTrang1995) -- [@sharmanilay](https://github.com/sharmanilay) -- [@yubing744](https://github.com/yubing744) -- [@PabloASMD](https://github.com/PabloASMD) -- [@0xrohitgarg](https://github.com/0xrohitgarg) -- [@Silverov](https://github.com/Silverov) -- [@shmlkv](https://github.com/shmlkv) -- [@kriptoburak](https://github.com/kriptoburak) -- [@lsuryatej](https://github.com/lsuryatej) -- [@tejasashinde](https://github.com/tejasashinde) -- [@SnakeEye-sudo](https://github.com/SnakeEye-sudo) -- [@8144225309](https://github.com/8144225309) - ---- - ## License MIT License. See [LICENSE](LICENSE) for details. --- -## Star History +**Keywords**: 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. -[![Star History Chart](https://api.star-history.com/svg?repos=sickn33/antigravity-awesome-skills&type=date&legend=top-left)](https://www.star-history.com/#sickn33/antigravity-awesome-skills&type=date&legend=top-left) +--- -If Antigravity Awesome Skills has been useful, consider โญ starring the repo! +## ๐Ÿท๏ธ GitHub Topics - +For repository maintainers, add these topics to maximize discoverability: + +```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, skill, skills, SKILL.md, rules.md, CLAUDE.md, GEMINI.md, CURSOR.md +claude-code, gemini-cli, codex-cli, antigravity, cursor, github-copilot, opencode, +agentic-skills, ai-coding, llm-tools, ai-agents, autonomous-coding, mcp +``` diff --git a/docs/EXAMPLES.md b/docs/EXAMPLES.md index 6ff2ff60..ca9b9936 100644 --- a/docs/EXAMPLES.md +++ b/docs/EXAMPLES.md @@ -1,56 +1,760 @@ -# ๐Ÿงช Real-World Examples ("The Antigravity Cookbook") +# ๐Ÿ’ก Real-World Examples - See Skills in Action -Skills are powerful on their own, but unstoppable when combined. -Here are three common scenarios and how to solve them using this repository. - -## ๐Ÿฅ˜ Recipe 1: The "Legacy Code Audit" - -_Scenario: You just inherited a messy 5-year-old Node.js repo. You need to fix it safely._ - -**Skills Used:** - -1. `concise-planning` (To map the chaos) -2. `lint-and-validate` (To find the bugs) -3. `security-audit` (To find the holes) - -**The Workflow:** - -1. **Plan**: "Agent, use `concise-planning` to create a checklist for refactoring `src/legacy-api.js`." -2. **Audit**: "Run `security-audit` on the `package.json` to find vulnerable dependencies." -3. **Fix**: "Use `lint-and-validate` rules to auto-fix the formatting issues in `src/`." +**Learn by example!** This guide shows you real conversations using different skills. --- -## ๐Ÿฅ˜ Recipe 2: The "Modern Web App" +## Example 1: Designing a Feature with @brainstorming -_Scenario: You need to build a high-performance Landing Page in 2 hours._ +### The Scenario +You want to add a "dark mode" feature to your app, but you're not sure how to approach it. -**Skills Used:** +### The Conversation -1. `frontend-design` (For aesthetics) -2. `react-patterns` (For structure) -3. `tailwind-mastery` (For speed) +``` +You: @brainstorming I want to add dark mode to my React app -**The Workflow:** +AI: Great! Let me help you think through this. First, let me check your + current project structure... + + [AI examines your files] + + I see you're using React with Tailwind CSS. Now, let's understand + your requirements: + + What's your primary goal for dark mode? + a) User preference (toggle in settings) + b) System preference (follow OS setting) + c) Both (with manual override) -1. **Design**: "Use `frontend-design` to generate a color palette and typography for a 'Cyberpunk Coffee Shop'." -2. **Scaffold**: "Initialize a Vite project. Then apply `react-patterns` to create the 'Hero' component." -3. **Style**: "Use `tailwind-mastery` to make the buttons glassmorphic and responsive." +You: c) Both + +AI: Perfect! That's the best user experience. Next question: + + Where should the dark mode toggle be located? + a) In the main navigation + b) In a settings page + c) In a dropdown menu + d) Multiple locations + +You: a) In the main navigation + +AI: Good choice for accessibility. One more question: + + Should dark mode preference persist across sessions? + a) Yes, save to localStorage + b) Yes, save to user account (requires backend) + c) No, reset each session + +You: a) Yes, save to localStorage + +AI: Excellent! Now I have a clear picture. Let me present the design... + + ## Dark Mode Implementation Design + + ### Architecture Overview + We'll use React Context for state management, Tailwind's dark mode + utilities, and localStorage for persistence. The system will: + 1. Check OS preference on first visit + 2. Allow manual override via toggle + 3. Persist preference in localStorage + + Does this approach look good so far? + +You: Yes, continue + +AI: [Continues with detailed design sections...] + + [After design is complete] + + I've saved the design to docs/plans/2026-01-20-dark-mode-design.md + + Ready to set up for implementation? + +You: Yes + +AI: I'll create an isolated workspace using git worktrees and write an + implementation plan. One moment... +``` + +### What Happened +- โœ… AI asked focused questions one at a time +- โœ… Explored your specific context +- โœ… Presented design in sections +- โœ… Saved documentation +- โœ… Prepared for implementation --- -## ๐Ÿฅ˜ Recipe 3: The "Agent Architect" +## Example 2: Debugging with @systematic-debugging -_Scenario: You want to build a custom AI agent that can verify its own code._ +### The Scenario +Your tests are failing, but you're not sure why. -**Skills Used:** +### The Conversation -1. `mcp-builder` (To build tools) -2. `agent-evaluation` (To test reliability) -3. `prompt-engineering` (To refine instructions) +``` +You: @systematic-debugging My tests are failing with "Cannot read property + 'map' of undefined" -**The Workflow:** +AI: Let me help you debug this systematically. First, I'll gather information: + + 1. Running the failing test to see the full error... + + [AI runs: npm test] + + I see the error occurs in UserList.test.tsx at line 45. Let me examine + the test file and the component... + + [AI reads both files] + + ## Hypothesis + The test is failing because `users` prop is undefined when the component + renders. This suggests the mock data isn't being passed correctly. + + ## Verification + Let me check the test setup... + + [AI examines test] + + Found it! The test is calling: + ```typescript + render() + ``` + + But UserList requires a `users` prop. The component expects: + ```typescript + interface UserListProps { + users: User[]; + } + ``` + + ## Solution + The test should pass the users prop: + ```typescript + const mockUsers = [ + { id: 1, name: 'Alice' }, + { id: 2, name: 'Bob' } + ]; + + render() + ``` + + Should I apply this fix? -1. **Build**: "Use `mcp-builder` to create a `verify-file` tool." -2. **Instruct**: "Apply `prompt-engineering` patterns to the System Prompt so the agent always checks file paths." -3. **Test**: "Run `agent-evaluation` to benchmark how often the agent fails to find the file." +You: Yes + +AI: [Applies fix and runs tests] + + โœ… All tests passing! + + ## Root Cause + The test was missing required props. This is a common issue when + components are refactored to require props that were previously optional. + + ## Prevention + Consider adding TypeScript strict mode to catch these at compile time: + ```json + "strict": true, + "strictNullChecks": true + ``` + + Would you like me to add this to your tsconfig.json? +``` + +### What Happened +- โœ… Systematic investigation +- โœ… Clear hypothesis +- โœ… Verification before fixing +- โœ… Root cause analysis +- โœ… Prevention suggestions + +--- + +## Example 3: Adding Payments with @stripe-integration + +### The Scenario +You need to add subscription billing to your SaaS app. + +### The Conversation + +``` +You: @stripe-integration I need to add monthly subscription billing + +AI: I'll help you implement Stripe subscriptions. Let me understand your + requirements: + + Current stack detected: + - Next.js 14 (App Router) + - TypeScript + - Prisma with PostgreSQL + + For subscription billing, we'll need: + + 1. **Stripe Setup** + - Stripe account and API keys + - Webhook endpoint for events + - Product and price IDs + + 2. **Backend Implementation** + - API routes for checkout + - Webhook handler + - Database schema for subscriptions + + 3. **Frontend Implementation** + - Pricing page + - Checkout flow + - Subscription management + + Let's start with the backend. First, install dependencies: + + ```bash + npm install stripe @stripe/stripe-js + ``` + + Now, let's create the database schema... + + [AI provides Prisma schema] + + ```prisma + model User { + id String @id @default(cuid()) + email String @unique + stripeCustomerId String? @unique + subscriptions Subscription[] + } + + model Subscription { + id String @id @default(cuid()) + userId String + user User @relation(fields: [userId], references: [id]) + stripeSubscriptionId String @unique + status String + priceId String + currentPeriodEnd DateTime + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + } + ``` + + Next, let's create the checkout API route... + + [AI provides complete implementation with:] + - API route for creating checkout sessions + - Webhook handler for subscription events + - Helper functions for Stripe operations + - Error handling and logging + - TypeScript types + + Now for the frontend... + + [AI provides:] + - Pricing page component + - Checkout button component + - Subscription status display + - Tailwind styling + + Finally, let's set up the webhook: + + 1. In Stripe Dashboard, add webhook endpoint: + `https://yourdomain.com/api/webhooks/stripe` + + 2. Select these events: + - customer.subscription.created + - customer.subscription.updated + - customer.subscription.deleted + - invoice.payment_succeeded + - invoice.payment_failed + + 3. Copy the webhook secret to your .env: + ``` + STRIPE_WEBHOOK_SECRET=whsec_... + ``` + + ## Testing + + Test locally with Stripe CLI: + ```bash + stripe listen --forward-to localhost:3000/api/webhooks/stripe + stripe trigger customer.subscription.created + ``` + + ## Security Checklist + - โœ… API keys in environment variables + - โœ… Webhook signature verification + - โœ… Server-side price validation + - โœ… Idempotency keys for operations + + Ready to test the implementation? +``` + +### What Happened +- โœ… Detected existing stack +- โœ… Provided complete implementation +- โœ… Included database schema +- โœ… Added security best practices +- โœ… Included testing instructions + +--- + +## Example 4: Writing Copy with @copywriting + +### The Scenario +You need compelling copy for your SaaS landing page. + +### The Conversation + +``` +You: @copywriting Write homepage copy for my project management tool + +AI: I'll help you create compelling homepage copy. First, let me understand + your product: + + What makes your project management tool different from competitors + like Asana, Trello, or Monday.com? + +You: It's specifically built for remote teams with built-in video standups + and async communication features + +AI: Excellent differentiator! Who is your primary target audience? + a) Startups and small teams (2-20 people) + b) Mid-size companies (20-200 people) + c) Enterprise (200+ people) + d) Freelancers and agencies + +You: a) Startups and small teams + +AI: Perfect. What's the main pain point you solve? + +You: Remote teams waste time in unnecessary meetings and lose context + in async communication + +AI: Great! Now I have what I need. Here's your homepage copy: + + --- + + ## Hero Section + + **Headline:** + Run Your Remote Team Without the Meeting Overload + + **Subheadline:** + The project management tool built for distributed teams. Replace + status meetings with async video standups and keep everyone in sync + without the Zoom fatigue. + + **CTA:** + Start Free Trial โ†’ (No credit card required) + + --- + + ## Problem Section + + **Headline:** + Remote Work Shouldn't Mean More Meetings + + **Body:** + Your team is distributed across time zones. You're spending hours in + status meetings just to stay aligned. Async updates get lost in Slack. + Context disappears. Productivity suffers. + + Sound familiar? + + --- + + ## Solution Section + + **Headline:** + Stay Aligned Without the Meeting Marathon + + **Features:** + + ๐Ÿ“น **Async Video Standups** + Record quick video updates on your schedule. Your team watches when + it works for them. No more 9am calls for your teammate in Tokyo. + + ๐Ÿ’ฌ **Context-Rich Communication** + Every task, comment, and decision stays connected. No more hunting + through Slack threads or email chains. + + ๐Ÿ“Š **Visual Progress Tracking** + See what's happening at a glance. Kanban boards, timelines, and + dashboards that actually make sense. + + ๐Ÿ”” **Smart Notifications** + Get notified about what matters. Ignore the rest. Your focus time + is sacred. + + --- + + ## Social Proof Section + + **Headline:** + Trusted by Remote Teams Worldwide + + [Testimonial placeholders with structure] + + --- + + ## CTA Section + + **Headline:** + Ready to Reclaim Your Calendar? + + **Body:** + Join 500+ remote teams who've cut meeting time by 60% while staying + more aligned than ever. + + **CTA:** + Start Your Free 14-Day Trial โ†’ + + No credit card required. Cancel anytime. + + --- + + ## Copy Notes + + **Tone:** Professional but conversational + **Focus:** Pain point (too many meetings) โ†’ Solution (async video) + **Differentiation:** Built specifically for remote teams + **Social proof:** Quantified benefit (60% fewer meetings) + + Would you like me to: + 1. Write alternative versions for A/B testing? + 2. Create copy for specific feature pages? + 3. Write email sequences for onboarding? +``` + +### What Happened +- โœ… Asked clarifying questions +- โœ… Identified unique value proposition +- โœ… Created benefit-focused copy +- โœ… Included clear CTAs +- โœ… Provided copy notes for consistency + +--- + +## Example 5: Test-Driven Development with @test-driven-development + +### The Scenario +You need to implement a new feature: user authentication. + +### The Conversation + +``` +You: @test-driven-development I need to implement user login functionality + +AI: Perfect! Let's use TDD to build this. Following the Red-Green-Refactor + cycle, we'll write tests first, then implement. + + ## Step 1: Write the First Test (RED) + + Let's start with the simplest case - successful login: + + ```typescript + // auth.test.ts + import { login } from './auth'; + + describe('login', () => { + it('should return user data for valid credentials', async () => { + const result = await login({ + email: 'user@example.com', + password: 'correct-password' + }); + + expect(result.success).toBe(true); + expect(result.user).toHaveProperty('id'); + expect(result.user).toHaveProperty('email'); + expect(result.token).toBeDefined(); + }); + }); + ``` + + Let's run this test to see it fail: + + [AI runs: npm test] + + โœ… Test fails as expected (auth.ts doesn't exist yet) + + ## Step 2: Write Minimal Implementation (GREEN) + + Now let's write just enough code to make this test pass: + + ```typescript + // auth.ts + interface LoginCredentials { + email: string; + password: string; + } + + interface LoginResult { + success: boolean; + user?: { + id: string; + email: string; + }; + token?: string; + } + + export async function login( + credentials: LoginCredentials + ): Promise { + // Minimal implementation to pass the test + return { + success: true, + user: { + id: '1', + email: credentials.email + }, + token: 'fake-token' + }; + } + ``` + + [AI runs: npm test] + + โœ… Test passes! + + ## Step 3: Add Next Test (RED) + + Now let's test the failure case: + + ```typescript + it('should return error for invalid credentials', async () => { + const result = await login({ + email: 'user@example.com', + password: 'wrong-password' + }); + + expect(result.success).toBe(false); + expect(result.error).toBe('Invalid credentials'); + expect(result.user).toBeUndefined(); + expect(result.token).toBeUndefined(); + }); + ``` + + [AI runs: npm test] + + โŒ Test fails (always returns success) + + ## Step 4: Implement Real Logic (GREEN) + + Now let's add actual authentication: + + ```typescript + import bcrypt from 'bcrypt'; + import jwt from 'jsonwebtoken'; + import { db } from './db'; + + export async function login( + credentials: LoginCredentials + ): Promise { + // Find user + const user = await db.user.findUnique({ + where: { email: credentials.email } + }); + + if (!user) { + return { + success: false, + error: 'Invalid credentials' + }; + } + + // Verify password + const validPassword = await bcrypt.compare( + credentials.password, + user.passwordHash + ); + + if (!validPassword) { + return { + success: false, + error: 'Invalid credentials' + }; + } + + // Generate token + const token = jwt.sign( + { userId: user.id }, + process.env.JWT_SECRET!, + { expiresIn: '7d' } + ); + + return { + success: true, + user: { + id: user.id, + email: user.email + }, + token + }; + } + ``` + + [AI runs: npm test] + + โœ… All tests pass! + + ## Step 5: Add Edge Cases + + Let's add more tests for edge cases: + + ```typescript + it('should handle missing email', async () => { + const result = await login({ + email: '', + password: 'password' + }); + + expect(result.success).toBe(false); + expect(result.error).toBe('Email is required'); + }); + + it('should handle missing password', async () => { + const result = await login({ + email: 'user@example.com', + password: '' + }); + + expect(result.success).toBe(false); + expect(result.error).toBe('Password is required'); + }); + + it('should handle database errors gracefully', async () => { + // Mock database error + jest.spyOn(db.user, 'findUnique').mockRejectedValue( + new Error('Database connection failed') + ); + + const result = await login({ + email: 'user@example.com', + password: 'password' + }); + + expect(result.success).toBe(false); + expect(result.error).toBe('An error occurred'); + }); + ``` + + [AI implements validation and error handling] + + ## Step 6: Refactor (REFACTOR) + + Now that all tests pass, let's refactor for better code quality: + + ```typescript + // Extract validation + function validateCredentials(credentials: LoginCredentials): string | null { + if (!credentials.email) return 'Email is required'; + if (!credentials.password) return 'Password is required'; + return null; + } + + // Extract user verification + async function verifyUser( + email: string, + password: string + ): Promise { + const user = await db.user.findUnique({ where: { email } }); + if (!user) return null; + + const valid = await bcrypt.compare(password, user.passwordHash); + return valid ? user : null; + } + + // Main function is now cleaner + export async function login( + credentials: LoginCredentials + ): Promise { + try { + const validationError = validateCredentials(credentials); + if (validationError) { + return { success: false, error: validationError }; + } + + const user = await verifyUser( + credentials.email, + credentials.password + ); + + if (!user) { + return { success: false, error: 'Invalid credentials' }; + } + + const token = generateToken(user.id); + + return { + success: true, + user: { id: user.id, email: user.email }, + token + }; + } catch (error) { + console.error('Login error:', error); + return { success: false, error: 'An error occurred' }; + } + } + ``` + + [AI runs: npm test] + + โœ… All tests still pass after refactoring! + + ## Summary + + We've implemented login functionality using TDD: + - โœ… 5 tests covering happy path, errors, and edge cases + - โœ… Clean, testable code + - โœ… Proper error handling + - โœ… Type safety with TypeScript + + Next steps: + 1. Add rate limiting tests + 2. Add session management tests + 3. Add logout functionality + + Should I continue with these? +``` + +### What Happened +- โœ… Followed Red-Green-Refactor cycle +- โœ… Wrote tests before implementation +- โœ… Covered edge cases +- โœ… Refactored with confidence +- โœ… Maintained test coverage + +--- + +## Key Takeaways + +### What Makes These Examples Effective? + +1. **Skills ask clarifying questions** before jumping to solutions +2. **Skills provide context-aware help** based on your project +3. **Skills follow best practices** for their domain +4. **Skills include complete examples** not just snippets +5. **Skills explain the "why"** not just the "how" + +### How to Get Similar Results + +1. **Be specific** in your requests +2. **Provide context** about your project +3. **Answer questions** the skill asks +4. **Review suggestions** before applying +5. **Iterate** based on results + +--- + +## Try These Yourself! + +Pick a skill and try it with your own project: + +- **Planning:** `@brainstorming` or `@writing-plans` +- **Development:** `@test-driven-development` or `@react-best-practices` +- **Debugging:** `@systematic-debugging` or `@test-fixing` +- **Integration:** `@stripe-integration` or `@firebase` +- **Marketing:** `@copywriting` or `@seo-audit` + +--- + +**Want more examples?** Check individual skill folders for additional examples and use cases! diff --git a/docs/SKILL_ANATOMY.md b/docs/SKILL_ANATOMY.md index 28701cfe..73bf2660 100644 --- a/docs/SKILL_ANATOMY.md +++ b/docs/SKILL_ANATOMY.md @@ -31,7 +31,6 @@ skills/ Every `SKILL.md` file has two main parts: ### 1. Frontmatter (Metadata) - ### 2. Content (Instructions) Let's break down each part: @@ -52,17 +51,15 @@ description: "Brief description of what this skill does" ### Required Fields #### `name` - - **What it is:** The skill's identifier - **Format:** lowercase-with-hyphens - **Must match:** The folder name exactly - **Example:** `stripe-integration` #### `description` - - **What it is:** One-sentence summary - **Format:** String in quotes -- **Length:** Keep it under 200 characters (validator enforces this) +- **Length:** Keep it under 150 characters - **Example:** `"Stripe payment integration patterns including checkout, subscriptions, and webhooks"` ### Optional Fields @@ -73,22 +70,12 @@ Some skills include additional metadata: --- name: my-skill-name description: "Brief description" -risk: "safe" # none | safe | critical | offensive (see QUALITY_BAR.md) -source: "community" -tags: ["react", "typescript"] -date_added: "2024-01-15" +version: "1.0.0" +author: "Your Name" +tags: ["react", "typescript", "testing"] --- ``` -#### `date_added` - -- **What it is:** The date when the skill was created or added to the collection -- **Format:** `YYYY-MM-DD` (ISO 8601 date format) -- **Purpose:** Helps track skill versioning and community contributions -- **Required:** No (optional, but recommended) -- **Example:** `date_added: "2024-01-15"` -- **Note:** Can be managed automatically with the `scripts/manage_skill_dates.py` script - --- ## Part 2: Content @@ -98,16 +85,13 @@ After the frontmatter comes the actual skill content. Here's the recommended str ### Recommended Sections #### 1. Title (H1) - ```markdown # Skill Title ``` - - Use a clear, descriptive title - Usually matches or expands on the skill name #### 2. Overview - ```markdown ## Overview @@ -116,7 +100,6 @@ A brief explanation of what this skill does and why it exists. ``` #### 3. When to Use - ```markdown ## When to Use This Skill @@ -128,34 +111,28 @@ A brief explanation of what this skill does and why it exists. **Why this matters:** Helps the AI know when to activate this skill #### 4. Core Instructions - ```markdown ## How It Works ### Step 1: [Action] - Detailed instructions... ### Step 2: [Action] - More instructions... ``` **This is the heart of your skill** - clear, actionable steps #### 5. Examples - ```markdown ## Examples ### Example 1: [Use Case] - \`\`\`javascript // Example code \`\`\` ### Example 2: [Another Use Case] - \`\`\`javascript // More code \`\`\` @@ -164,7 +141,6 @@ More instructions... **Why examples matter:** They show the AI exactly what good output looks like #### 6. Best Practices - ```markdown ## Best Practices @@ -175,7 +151,6 @@ More instructions... ``` #### 7. Common Pitfalls - ```markdown ## Common Pitfalls @@ -184,7 +159,6 @@ More instructions... ``` #### 8. Related Skills - ```markdown ## Related Skills @@ -199,13 +173,11 @@ More instructions... ### Use Clear, Direct Language **โŒ Bad:** - ```markdown You might want to consider possibly checking if the user has authentication. ``` **โœ… Good:** - ```markdown Check if the user is authenticated before proceeding. ``` @@ -213,13 +185,11 @@ Check if the user is authenticated before proceeding. ### Use Action Verbs **โŒ Bad:** - ```markdown The file should be created... ``` **โœ… Good:** - ```markdown Create the file... ``` @@ -227,13 +197,11 @@ Create the file... ### Be Specific **โŒ Bad:** - ```markdown Set up the database properly. ``` **โœ… Good:** - ```markdown 1. Create a PostgreSQL database 2. Run migrations: `npm run migrate` @@ -256,7 +224,6 @@ scripts/ ``` **Reference them in SKILL.md:** - ```markdown Run the setup script: \`\`\`bash @@ -289,7 +256,6 @@ templates/ ``` **Reference in SKILL.md:** - ```markdown Use this template as a starting point: \`\`\`typescript @@ -313,19 +279,16 @@ references/ ## Skill Size Guidelines ### Minimum Viable Skill - - **Frontmatter:** name + description - **Content:** 100-200 words - **Sections:** Overview + Instructions ### Standard Skill - - **Frontmatter:** name + description - **Content:** 300-800 words - **Sections:** Overview + When to Use + Instructions + Examples ### Comprehensive Skill - - **Frontmatter:** name + description + optional fields - **Content:** 800-2000 words - **Sections:** All recommended sections @@ -340,9 +303,7 @@ references/ ### Use Markdown Effectively #### Code Blocks - Always specify the language: - ```markdown \`\`\`javascript const example = "code"; @@ -350,9 +311,7 @@ const example = "code"; ``` #### Lists - Use consistent formatting: - ```markdown - Item 1 - Item 2 @@ -361,13 +320,11 @@ Use consistent formatting: ``` #### Emphasis - - **Bold** for important terms: `**important**` -- _Italic_ for emphasis: `*emphasis*` +- *Italic* for emphasis: `*emphasis*` - `Code` for commands/code: `` `code` `` #### Links - ```markdown [Link text](https://example.com) ``` @@ -379,28 +336,24 @@ Use consistent formatting: Before finalizing your skill: ### Content Quality - - [ ] Instructions are clear and actionable - [ ] Examples are realistic and helpful - [ ] No typos or grammar errors - [ ] Technical accuracy verified ### Structure - - [ ] Frontmatter is valid YAML - [ ] Name matches folder name - [ ] Sections are logically organized - [ ] Headings follow hierarchy (H1 โ†’ H2 โ†’ H3) ### Completeness - - [ ] Overview explains the "why" - [ ] Instructions explain the "how" - [ ] Examples show the "what" - [ ] Edge cases are addressed ### Usability - - [ ] A beginner could follow this - [ ] An expert would find it useful - [ ] The AI can parse it correctly @@ -420,7 +373,6 @@ description: "You MUST use this before any creative work..." ``` **Analysis:** - - โœ… Clear name - โœ… Strong description with urgency ("MUST use") - โœ… Explains when to use it @@ -429,12 +381,10 @@ description: "You MUST use this before any creative work..." # Brainstorming Ideas Into Designs ## Overview - Help turn ideas into fully formed designs... ``` **Analysis:** - - โœ… Clear title - โœ… Concise overview - โœ… Explains the value proposition @@ -443,13 +393,11 @@ Help turn ideas into fully formed designs... ## The Process **Understanding the idea:** - - Check out the current project state first - Ask questions one at a time ``` **Analysis:** - - โœ… Broken into clear phases - โœ… Specific, actionable steps - โœ… Easy to follow @@ -464,12 +412,10 @@ Help turn ideas into fully formed designs... ## Instructions If the user is working with React: - - Use functional components - Prefer hooks over class components If the user is working with Vue: - - Use Composition API - Follow Vue 3 patterns ``` @@ -478,11 +424,9 @@ If the user is working with Vue: ```markdown ## Basic Usage - [Simple instructions for common cases] ## Advanced Usage - [Complex patterns for power users] ``` @@ -503,18 +447,15 @@ If the user is working with Vue: How to know if your skill is good: ### Clarity Test - - Can someone unfamiliar with the topic follow it? - Are there any ambiguous instructions? ### Completeness Test - - Does it cover the happy path? - Does it handle edge cases? - Are error scenarios addressed? ### Usefulness Test - - Does it solve a real problem? - Would you use this yourself? - Does it save time or improve quality? @@ -526,13 +467,11 @@ How to know if your skill is good: ### Study These Examples **For Beginners:** - - `skills/brainstorming/SKILL.md` - Clear structure - `skills/git-pushing/SKILL.md` - Simple and focused - `skills/copywriting/SKILL.md` - Good examples **For Advanced:** - - `skills/systematic-debugging/SKILL.md` - Comprehensive - `skills/react-best-practices/SKILL.md` - Multiple files - `skills/loki-mode/SKILL.md` - Complex workflows @@ -552,28 +491,22 @@ How to know if your skill is good: ## Common Mistakes to Avoid ### โŒ Mistake 1: Too Vague - ```markdown ## Instructions - Make the code better. ``` **โœ… Fix:** - ```markdown ## Instructions - 1. Extract repeated logic into functions 2. Add error handling for edge cases 3. Write unit tests for core functionality ``` ### โŒ Mistake 2: Too Complex - ```markdown ## Instructions - [5000 words of dense technical jargon] ``` @@ -581,10 +514,8 @@ Make the code better. Break into multiple skills or use progressive disclosure ### โŒ Mistake 3: No Examples - ```markdown ## Instructions - [Instructions without any code examples] ``` @@ -592,7 +523,6 @@ Break into multiple skills or use progressive disclosure Add at least 2-3 realistic examples ### โŒ Mistake 4: Outdated Information - ```markdown Use React class components... ``` @@ -605,7 +535,7 @@ Keep skills updated with current best practices ## ๐ŸŽฏ Next Steps 1. **Read 3-5 existing skills** to see different styles -2. **Try the skill template** from CONTRIBUTING.md +2. **Try the skill template** from CONTRIBUTING_GUIDE.md 3. **Create a simple skill** for something you know well 4. **Test it** with your AI assistant 5. **Share it** via Pull Request diff --git a/docs/VISUAL_GUIDE.md b/docs/VISUAL_GUIDE.md index 3fc6864a..5cffda8c 100644 --- a/docs/VISUAL_GUIDE.md +++ b/docs/VISUAL_GUIDE.md @@ -31,9 +31,10 @@ antigravity-awesome-skills/ โ”‚ โ”œโ”€โ”€ ๐Ÿ“„ README.md โ† Overview & skill list -โ”œโ”€โ”€ ๐Ÿ“„ CONTRIBUTING.md โ† How to contribute +โ”œโ”€โ”€ ๐Ÿ“„ GETTING_STARTED.md โ† Start here! (NEW) +โ”œโ”€โ”€ ๐Ÿ“„ CONTRIBUTING_GUIDE.md โ† How to contribute (NEW) โ”‚ -โ”œโ”€โ”€ ๐Ÿ“ skills/ โ† All 250+ skills live here +โ”œโ”€โ”€ ๐Ÿ“ skills/ โ† All 179 skills live here โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ ๐Ÿ“ brainstorming/ โ”‚ โ”‚ โ””โ”€โ”€ ๐Ÿ“„ SKILL.md โ† Skill definition @@ -42,22 +43,20 @@ antigravity-awesome-skills/ โ”‚ โ”‚ โ”œโ”€โ”€ ๐Ÿ“„ SKILL.md โ”‚ โ”‚ โ””โ”€โ”€ ๐Ÿ“ examples/ โ† Optional extras โ”‚ โ”‚ -โ”‚ โ””โ”€โ”€ ... (250+ more skills) +โ”‚ โ”œโ”€โ”€ ๐Ÿ“ react-best-practices/ +โ”‚ โ”‚ โ”œโ”€โ”€ ๐Ÿ“„ SKILL.md +โ”‚ โ”‚ โ”œโ”€โ”€ ๐Ÿ“ rules/ +โ”‚ โ”‚ โ””โ”€โ”€ ๐Ÿ“„ README.md +โ”‚ โ”‚ +โ”‚ โ””โ”€โ”€ ... (176 more skills) โ”‚ โ”œโ”€โ”€ ๐Ÿ“ scripts/ โ† Validation & management -โ”‚ โ”œโ”€โ”€ validate_skills.py โ† Quality Bar Enforcer -โ”‚ โ””โ”€โ”€ generate_index.py โ† Registry Generator +โ”‚ โ”œโ”€โ”€ validate_skills.py +โ”‚ โ””โ”€โ”€ generate_index.py โ”‚ -โ”œโ”€โ”€ ๐Ÿ“ .github/ -โ”‚ โ””โ”€โ”€ ๐Ÿ“„ MAINTENANCE.md โ† Maintainers Guide -โ”‚ -โ””โ”€โ”€ ๐Ÿ“ docs/ โ† Documentation - โ”œโ”€โ”€ ๐Ÿ“„ GETTING_STARTED.md โ† Start here! (NEW) - โ”œโ”€โ”€ ๐Ÿ“„ FAQ.md โ† Troubleshooting - โ”œโ”€โ”€ ๐Ÿ“„ BUNDLES.md โ† Starter Packs (NEW) - โ”œโ”€โ”€ ๐Ÿ“„ QUALITY_BAR.md โ† Quality Standards +โ””โ”€โ”€ ๐Ÿ“ docs/ โ† Documentation (NEW) โ”œโ”€โ”€ ๐Ÿ“„ SKILL_ANATOMY.md โ† How skills work - โ””โ”€โ”€ ๐Ÿ“„ VISUAL_GUIDE.md โ† This file! + โ””โ”€โ”€ ๐Ÿ“„ QUICK_START_VISUAL.md โ† This file! ``` --- @@ -96,7 +95,7 @@ antigravity-awesome-skills/ ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” - โ”‚ 250+ AWESOME SKILLS โ”‚ + โ”‚ 179 AWESOME SKILLS โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” @@ -130,7 +129,7 @@ antigravity-awesome-skills/ ## Skill File Anatomy (Visual) -```` +``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ SKILL.md โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค @@ -168,14 +167,13 @@ antigravity-awesome-skills/ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ -```` +``` --- ## Installation (Visual Steps) ### Step 1: Clone the Repository - ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Terminal โ”‚ @@ -190,7 +188,6 @@ antigravity-awesome-skills/ ``` ### Step 2: Verify Installation - ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ File Explorer โ”‚ @@ -205,7 +202,6 @@ antigravity-awesome-skills/ ``` ### Step 3: Use a Skill - ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ AI Assistant Chat โ”‚ @@ -275,19 +271,16 @@ antigravity-awesome-skills/ ## Finding Skills (Visual Guide) ### Method 1: Browse by Category - ``` README.md โ†’ Scroll to "Full Skill Registry" โ†’ Find category โ†’ Pick skill ``` ### Method 2: Search by Keyword - ``` Terminal โ†’ ls skills/ | grep "keyword" โ†’ See matching skills ``` ### Method 3: Use the Index - ``` Open skills_index.json โ†’ Search for keyword โ†’ Find skill path ``` @@ -309,7 +302,7 @@ Open skills_index.json โ†’ Search for keyword โ†’ Find skill path โ†“ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ 3. WRITE โ”‚ Add frontmatter + content -โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ (Use template from CONTRIBUTING.md) +โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ (Use template from CONTRIBUTING_GUIDE.md) โ”‚ โ†“ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” @@ -456,8 +449,8 @@ START HERE โ”‚ 5. Submit PR โ”‚ โ”‚ โ”‚ โ”‚ ๐Ÿ†˜ HELP โ”‚ -โ”‚ โ€ข docs/GETTING_STARTED.md - Basics โ”‚ -โ”‚ โ€ข CONTRIBUTING.md - How to contribute โ”‚ +โ”‚ โ€ข GETTING_STARTED.md - Basics โ”‚ +โ”‚ โ€ข CONTRIBUTING_GUIDE.md - How to contribute โ”‚ โ”‚ โ€ข SKILL_ANATOMY.md - Deep dive โ”‚ โ”‚ โ€ข GitHub Issues - Ask questions โ”‚ โ”‚ โ”‚ @@ -472,19 +465,19 @@ START HERE Day 1: Install skills โ”‚ โ””โ”€โ†’ "Wow, @brainstorming helped me design my app!" - + Day 3: Use 5 different skills โ”‚ โ””โ”€โ†’ "These skills save me so much time!" - + Week 1: Create first skill โ”‚ โ””โ”€โ†’ "I shared my expertise as a skill!" - + Week 2: Skill gets merged โ”‚ โ””โ”€โ†’ "My skill is helping others! ๐ŸŽ‰" - + Month 1: Regular contributor โ”‚ โ””โ”€โ†’ "I've contributed 5 skills and improved docs!" @@ -497,16 +490,15 @@ Month 1: Regular contributor 1. โœ… **Understand** the visual structure 2. โœ… **Install** skills in your AI tool 3. โœ… **Try** 2-3 skills from different categories -4. โœ… **Read** CONTRIBUTING.md +4. โœ… **Read** CONTRIBUTING_GUIDE.md 5. โœ… **Create** your first skill 6. โœ… **Share** with the community --- **Visual learner?** This guide should help! Still have questions? Check out: - -- [GETTING_STARTED.md](GETTING_STARTED.md) - Text-based intro +- [GETTING_STARTED.md](../GETTING_STARTED.md) - Text-based intro - [SKILL_ANATOMY.md](SKILL_ANATOMY.md) - Detailed breakdown -- [CONTRIBUTING.md](../CONTRIBUTING.md) - How to contribute +- [CONTRIBUTING_GUIDE.md](../CONTRIBUTING_GUIDE.md) - How to contribute **Ready to contribute?** You've got this! ๐Ÿ’ช