Skip to main content

​
What Are Skills?

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), these skills let your AI become an expert in different areas when you need them.

​
Understanding “Bundles” vs “Skills”

Common confusion: “Do I need to download each skill separately?”Answer: NO! When you install Antigravity Awesome Skills, all 968+ skills are already available.

​
What Bundles Are

Bundles are recommended lists of skills grouped by role. They help you decide which skills to start using. Analogy:
  • You installed a toolbox with 968+ tools ✅
  • Bundles are like labeled organizer trays saying: “If you’re a carpenter, start with these 10 tools”
  • You don’t install bundles—you pick skills from them

​
What Bundles Are NOT

  • ❌ Separate installations
  • ❌ Different download commands
  • ❌ Something you need to “activate”

​
How to Invoke Skills

The exact syntax varies by tool, but it’s always simple: 
# In your terminal/chat with Claude Code:
>> Use @brainstorming to help me design a todo app
Most modern tools use the @skill-name syntax. When in doubt, try that first!

​
Example Prompts

​
Starting a New Project

“Help me build a todo app”
Why it’s bad: Too vague, no skill invocation.
“Use @brainstorming to help me design a todo app with user authentication and cloud sync”
Why it’s better: You’re explicitly invoking the skill and providing context.

​
Reviewing Code

“Check my code”
Why it’s bad: No specific skill or target file.
“Use @lint-and-validate to check src/components/Button.tsx for issues”
Why it’s better: Specific skill + specific file = precise results.

​
Security Audit

“Make my API secure”
Why it’s bad: No skill guidance or scope.
“Use @api-security-best-practices to review my REST endpoints in routes/api/users.js”
Why it’s better: The AI knows exactly which skill’s standards to apply.

​
Combining Multiple Skills

“Use @brainstorming to design a payment flow, then apply @stripe-integration to implement it”
Why it’s good: You can chain skills together in a single prompt!

​
Your First Skill (Tutorial)

1

Pick a skill

Let’s use brainstorming (from the “Essentials” bundle)
2

Open your AI assistant

Open Claude Code, Cursor, Gemini CLI, or your preferred tool
3

Type this exact prompt

Use @brainstorming to help me design a user profile page for my app
4

Press Enter and interact

What happens next:
  • The AI loads the brainstorming skill
  • It will start asking you structured questions (one at a time)
  • It will guide you through understanding, requirements, and design
  • You answer each question, and it builds a complete spec
5

Get results

You’ll end up with a detailed design document—without writing a single line of code yet!

​
Picking Your First Skills

Don’t try to use all 968+ skills! Here’s a sensible approach:

​
Start with “The Essentials” (5 skills)

Everyone needs these:
  1. @brainstorming - Plan before you build
  2. @lint-and-validate - Keep code clean
  3. @git-pushing - Save work safely
  4. @systematic-debugging - Fix bugs faster
  5. @concise-planning - Organize tasks
How to use them:
  • Before writing new code → @brainstorming
  • After writing code → @lint-and-validate
  • Before committing → @git-pushing
  • When stuck → @systematic-debugging

​
Then Add Role-Specific Skills (5-10 more)

Find your role in the Bundles documentation and pick 5-10 skills from that bundle.

Web Developer

  • @frontend-design
  • @react-best-practices
  • @tailwind-patterns
  • @seo-audit

Security Engineer

  • @api-security-best-practices
  • @vulnerability-scanner
  • @ethical-hacking-methodology

​
Finally, Add On-Demand Skills

Keep the CATALOG.md open as reference. When you need something specific:
“I need to integrate Stripe payments”
→ Search catalog → Find @stripe-integration → Use it!

​
Complete Example: Building a Feature

Let’s walk through a realistic scenario:

​
Task: “Add a blog to my Next.js website”

1

Plan with @brainstorming

You: Use @brainstorming to design a blog system for my Next.js site

AI: [Asks structured questions about requirements]
You: [Answer questions]
AI: [Produces detailed design spec]
2

Implement with @nextjs-best-practices

You: Use @nextjs-best-practices to scaffold the blog with App Router

AI: [Creates file structure, sets up routes, adds components]
3

Style with @tailwind-patterns

You: Use @tailwind-patterns to make the blog posts look modern

AI: [Applies Tailwind styling with responsive design]
4

Optimize with @seo-audit

You: Use @seo-audit to optimize the blog for search engines

AI: [Adds meta tags, sitemaps, structured data]
5

Test & Deploy

You: Use @test-driven-development to add tests, then @vercel-deployment to deploy

AI: [Creates tests, sets up CI/CD, deploys to Vercel]
Result: Professional blog built with best practices, without manually researching each step!

​
Quick Reference Card

TaskSkill to UseExample Prompt
Plan new feature@brainstormingUse @brainstorming to design a login system
Review code@lint-and-validateUse @lint-and-validate on src/app.js
Debug issue@systematic-debuggingUse @systematic-debugging to fix login error
Security audit@api-security-best-practicesUse @api-security-best-practices on my API routes
SEO check@seo-auditUse @seo-audit on my landing page
React component@react-patternsUse @react-patterns to build a form component
Deploy app@vercel-deploymentUse @vercel-deployment to ship this to production

​
Pro Tips for Maximum Effectiveness

Tip 1: Start Every Feature with @brainstormingBefore writing code, use @brainstorming to plan. You’ll save hours of refactoring.
Tip 2: Chain Skills in OrderDon’t try to do everything at once. Use skills sequentially: Plan → Build → Test → Deploy
Tip 3: Be Specific in PromptsBad: “Use @react-patterns”
Good: “Use @react-patterns to build a modal component with animations”
Tip 4: Reference File PathsHelp the AI focus: “Use @security-auditor on routes/api/auth.js”
Tip 5: Combine Skills for Complex Tasks“Use @brainstorming to design, then @test-driven-development to implement with tests”

​
FAQ

Any of them! Skills work universally. Pick the tool you already use or prefer:
  • Claude Code - Best for terminal/CLI workflows
  • Cursor - Best for IDE integration
  • Gemini CLI - Best for Google ecosystem
  • Codex CLI - Best for OpenAI ecosystem
Yes! Three ways:
  1. Browse CATALOG.md (searchable list)
  2. Run ls ~/.gemini/antigravity/skills/ (if installed there)
  3. Ask your AI: “What skills do you have for [topic]?”
Usually no, but if your AI doesn’t recognize a skill:
  1. Try restarting your IDE/CLI
  2. Check the installation path matches your tool
  3. Try the explicit path: npx antigravity-awesome-skills --claude (or --cursor, --gemini, etc.)
Yes! Use the @skill-creator skill:
Use @skill-creator to help me build a custom skill for [your task]
  1. Check the skill’s SKILL.md file directly: ~/.gemini/antigravity/skills/[skill-name]/SKILL.md
  2. Read the description to ensure you’re using it correctly
  3. Open an issue on GitHub with details

Build docs developers (and LLMs) love

Get started for freeTalk to us