bb2304a34f
Add installer filters for risk, category, and tags so maintainers and users can ship smaller skill surfaces to context-sensitive runtimes. Document the reduced-install flow for OpenCode-style hosts, add the humanize-chinese community skill, and sync the generated catalog and plugin-safe artifacts that now reflect the release batch. Refs #437 Refs #440 Refs #443
25 KiB
25 KiB
Visual Quick Start Guide
Learn by seeing! This guide uses diagrams and visual examples to help you understand skills.
The Big Picture
┌─────────────────────────────────────────────────────────────┐
│ YOU (Developer) │
│ ↓ │
│ "Help me build a payment system" │
│ ↓ │
├─────────────────────────────────────────────────────────────┤
│ AI ASSISTANT │
│ ↓ │
│ Loads @stripe-integration skill │
│ ↓ │
│ Becomes an expert in Stripe payments │
│ ↓ │
│ Provides specialized help with code examples │
└─────────────────────────────────────────────────────────────┘
Repository Structure (Visual)
antigravity-awesome-skills/
│
├── 📄 README.md ← Overview and quick start
├── 📄 CONTRIBUTING.md ← Contributor workflow
├── 📄 CATALOG.md ← Full generated catalog
│
├── 📁 skills/ ← 1,344+ skills live here
│ │
│ ├── 📁 brainstorming/
│ │ └── 📄 SKILL.md ← Skill definition
│ │
│ ├── 📁 stripe-integration/
│ │ ├── 📄 SKILL.md
│ │ └── 📁 examples/ ← Optional extras
│ │
│ ├── 📁 game-development/
│ │ └── 📁 2d-games/
│ │ └── 📄 SKILL.md ← Nested skills also supported
│ │
│ └── ... (1,344+ total)
│
├── 📁 apps/
│ └── 📁 web-app/ ← Interactive browser
│
├── 📁 tools/
│ ├── 📁 scripts/ ← Validators and generators
│ ├── 📁 lib/ ← Shared helpers
│ └── 📁 bin/ ← Installer entrypoint
│
└── 📁 docs/
├── 📁 users/ ← Getting started, bundles, workflows
├── 📁 contributors/ ← Template, anatomy, quality bar
├── 📁 maintainers/ ← Release and maintenance docs
└── 📁 sources/ ← Attribution and licenses
How Skills Work (Flow Diagram)
┌──────────────┐
│ 1. INSTALL │ Run npx installer or clone to your tool path
└──────┬───────┘
│
↓
┌──────────────┐
│ 2. INVOKE │ Type: @skill-name in AI chat
└──────┬───────┘
│
↓
┌──────────────┐
│ 3. LOAD │ AI reads SKILL.md file
└──────┬───────┘
│
↓
┌──────────────┐
│ 4. EXECUTE │ AI follows skill instructions
└──────┬───────┘
│
↓
┌──────────────┐
│ 5. RESULT │ You get specialized help!
└──────────────┘
Skill Categories (Visual Map)
┌─────────────────────────┐
│ 1,344+ SKILLS │
└────────────┬────────────┘
│
┌────────────────────────┼────────────────────────┐
│ │ │
┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
│ PRODUCT │ │ DEVELOPMENT │ │ SECURITY │
│ & UX │ │ & TESTING │ │ & RELIAB. │
└────┬────┘ └──────┬──────┘ └──────┬──────┘
│ │ │
• Brainstorming • React / Next.js • AppSec reviews
• Design systems • TDD / debugging • Pentest guides
• Copywriting • API / backend • Cloud hardening
• Incident response
│ │ │
└────────────────────────┼────────────────────────┘
│
┌────────────────────────┼────────────────────────┐
│ │ │
┌────▼────┐ ┌──────▼──────┐ ┌──────▼──────┐
│ AI │ │ DATA / OPS │ │ DOCS / OSS │
│ AGENTS │ │ & CLOUD │ │ MAINTENANCE │
└────┬────┘ └──────┬──────┘ └──────┬──────┘
│ │ │
• RAG systems • SQL / analytics • Release flow
• LangGraph • Docker / K8s • Changelog
• Prompt engineering • Terraform / AWS • PR / review
• Tooling / MCP • Observability • Skill authoring
Skill File Anatomy (Visual)
┌─────────────────────────────────────────────────────────┐
│ SKILL.md │
├─────────────────────────────────────────────────────────┤
│ │
│ ┌───────────────────────────────────────────────┐ │
│ │ FRONTMATTER (Metadata) │ │
│ │ ───────────────────────────────────────────── │ │
│ │ --- │ │
│ │ name: my-skill │ │
│ │ description: "What this skill does" │ │
│ │ --- │ │
│ └───────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────┐ │
│ │ CONTENT (Instructions) │ │
│ │ ───────────────────────────────────────────── │ │
│ │ │ │
│ │ # Skill Title │ │
│ │ │ │
│ │ ## Overview │ │
│ │ What this skill does... │ │
│ │ │ │
│ │ ## When to Use │ │
│ │ - Use when... │ │
│ │ │ │
│ │ ## Instructions │ │
│ │ 1. First step... │ │
│ │ 2. Second step... │ │
│ │ │ │
│ │ ## Examples │ │
│ │ ```javascript │ │
│ │ // Example code │ │
│ │ ``` │ │
│ │ │ │
│ └───────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
Installation (Visual Steps)
Step 1: Install the Repository
┌─────────────────────────────────────────┐
│ Terminal │
├─────────────────────────────────────────┤
│ $ npx antigravity-awesome-skills │
│ │
│ ✓ Installing to │
│ ~/.gemini/antigravity/skills/ │
└─────────────────────────────────────────┘
If you want a workspace-style manual install instead, cloning into .agent/skills/ is still a valid custom path for Antigravity.
Step 2: Verify Installation
┌─────────────────────────────────────────┐
│ File Explorer │
├─────────────────────────────────────────┤
│ 📁 ~/.gemini/antigravity/skills/ │
│ ├── 📁 brainstorming/ │
│ ├── 📁 stripe-integration/ │
│ ├── 📁 react-best-practices/ │
│ └── ... (1,344+ total) │
└─────────────────────────────────────────┘
Step 3: Use a Skill
┌─────────────────────────────────────────┐
│ AI Assistant Chat │
├─────────────────────────────────────────┤
│ You: @brainstorming help me design │
│ a todo app │
│ │
│ AI: Great! Let me help you think │
│ through this. First, let's │
│ understand your requirements... │
│ │
│ What's the primary use case? │
│ a) Personal task management │
│ b) Team collaboration │
│ c) Project planning │
└─────────────────────────────────────────┘
Example: Using a Skill (Step-by-Step)
Scenario: You want to add Stripe payments to your app
┌─────────────────────────────────────────────────────────────┐
│ STEP 1: Identify the Need │
├─────────────────────────────────────────────────────────────┤
│ "I need to add payment processing to my app" │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ STEP 2: Find the Right Skill │
├─────────────────────────────────────────────────────────────┤
│ Search: "payment" or "stripe" │
│ Found: @stripe-integration │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ STEP 3: Invoke the Skill │
├─────────────────────────────────────────────────────────────┤
│ You: @stripe-integration help me add subscription billing │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ STEP 4: AI Loads Skill Knowledge │
├─────────────────────────────────────────────────────────────┤
│ • Stripe API patterns │
│ • Webhook handling │
│ • Subscription management │
│ • Best practices │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ STEP 5: Get Expert Help │
├─────────────────────────────────────────────────────────────┤
│ AI provides: │
│ • Code examples │
│ • Setup instructions │
│ • Security considerations │
│ • Testing strategies │
└─────────────────────────────────────────────────────────────┘
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
Creating Your First Skill (Visual Workflow)
┌──────────────┐
│ 1. IDEA │ "I want to share my Docker knowledge"
└──────┬───────┘
│
↓
┌──────────────┐
│ 2. CREATE │ mkdir skills/docker-mastery
└──────┬───────┘ touch skills/docker-mastery/SKILL.md
│
↓
┌──────────────┐
│ 3. WRITE │ Add frontmatter + content
└──────┬───────┘ (Use docs/contributors/skill-template.md)
│
↓
┌──────────────┐
│ 4. TEST │ Copy to your tool's installed skills path
└──────┬───────┘ Try: @docker-mastery
│
↓
┌──────────────┐
│ 5. VALIDATE │ npm run validate
└──────┬───────┘
│
↓
┌──────────────┐
│ 6. SUBMIT │ git commit + push + Pull Request
└──────────────┘
Skill Complexity Levels
┌─────────────────────────────────────────────────────────────┐
│ SKILL COMPLEXITY │
├─────────────────────────────────────────────────────────────┤
│ │
│ SIMPLE STANDARD COMPLEX │
│ ────── ──────── ─────── │
│ │
│ • 1 file • 1 file • Multiple │
│ • 100-200 words • 300-800 words • 800-2000 │
│ • Basic structure • Full structure • Scripts │
│ • No extras • Examples • Examples │
│ • Best practices • Templates│
│ • Docs │
│ Example: Example: Example: │
│ git-pushing brainstorming loki-mode │
│ │
└─────────────────────────────────────────────────────────────┘
Contribution Impact (Visual)
Your Contribution
│
├─→ Improves Documentation
│ │
│ └─→ Helps 1000s of developers understand
│
├─→ Creates New Skill
│ │
│ └─→ Enables new capabilities for everyone
│
├─→ Fixes Bug/Typo
│ │
│ └─→ Prevents confusion for future users
│
└─→ Adds Example
│
└─→ Makes learning easier for beginners
Learning Path (Visual Roadmap)
START HERE
│
↓
┌─────────────────┐
│ Read │
│ GETTING_STARTED │
└────────┬────────┘
│
↓
┌─────────────────┐
│ Try 2-3 Skills │
│ in AI Assistant │
└────────┬────────┘
│
↓
┌─────────────────┐
│ Read │
│ SKILL_ANATOMY │
└────────┬────────┘
│
↓
┌─────────────────┐
│ Study Existing │
│ Skills │
└────────┬────────┘
│
↓
┌─────────────────┐
│ Create Simple │
│ Skill │
└────────┬────────┘
│
↓
┌─────────────────┐
│ Read │
│ CONTRIBUTING │
└────────┬────────┘
│
↓
┌─────────────────┐
│ Submit PR │
└────────┬────────┘
│
↓
CONTRIBUTOR! 🎉
Quick Tips (Visual Cheatsheet)
┌─────────────────────────────────────────────────────────────┐
│ QUICK REFERENCE │
├─────────────────────────────────────────────────────────────┤
│ │
│ 📥 INSTALL │
│ npx antigravity-awesome-skills │
│ │
│ 🎯 USE │
│ @skill-name [your request] │
│ │
│ 🔍 FIND │
│ ls skills/ | grep "keyword" │
│ │
│ ✅ VALIDATE │
│ npm run validate │
│ │
│ 📝 CREATE │
│ 1. mkdir skills/my-skill │
│ 2. Create SKILL.md with frontmatter │
│ 3. Add content │
│ 4. Test & validate │
│ 5. Submit PR │
│ │
│ 🆘 HELP │
│ • docs/users/getting-started.md │
│ • docs/users/faq.md │
│ • CONTRIBUTING.md │
│ • docs/contributors/skill-anatomy.md │
│ • GitHub Issues - Ask questions │
│ │
└─────────────────────────────────────────────────────────────┘
Success Stories (Visual Timeline)
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!"
Next Steps
- ✅ Understand the visual structure
- ✅ Install skills in your AI tool
- ✅ Try 2-3 skills from different categories
- ✅ Read CONTRIBUTING.md
- ✅ Create your first skill
- ✅ Share with the community
Visual learner? This guide should help! Still have questions? Check out:
- getting-started.md - Text-based intro
- skill-anatomy.md - Detailed breakdown
- CONTRIBUTING.md - How to contribute
Ready to contribute? You've got this! 💪