510 lines
25 KiB
Markdown
510 lines
25 KiB
Markdown
# 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,306+ 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,306+ 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,306+ 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,306+ 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
|
|
|
|
1. ✅ **Understand** the visual structure
|
|
2. ✅ **Install** skills in your AI tool
|
|
3. ✅ **Try** 2-3 skills from different categories
|
|
4. ✅ **Read** CONTRIBUTING.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
|
|
- [skill-anatomy.md](../contributors/skill-anatomy.md) - Detailed breakdown
|
|
- [CONTRIBUTING.md](../../CONTRIBUTING.md) - How to contribute
|
|
|
|
**Ready to contribute?** You've got this! 💪
|