bdcfbb9625
Import the official Hugging Face ecosystem skills and sync the\nexisting local coverage with upstream metadata and assets.\n\nRegenerate the canonical catalog, plugin mirrors, docs, and release\nnotes after the maintainer merge batch so main stays in sync.\n\nFixes #417
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,340+ 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,340+ 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,340+ 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,340+ 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! 💪