Skip to main content
This is a quickstart guide to get you up and running fast. For more detailed information, see the Complete Installation Guide.

Installation

Get 968+ skills installed and ready to use in seconds.
1

Install via npx

Run the installer to automatically set up skills for your AI assistant:
npx antigravity-awesome-skills
The default installation path is ~/.gemini/antigravity/skills which works globally with Antigravity IDE. Use tool-specific flags or --path for custom locations.
2

Verify installation

Confirm the skills directory exists and contains the repository:
test -d ~/.gemini/antigravity/skills && echo "✓ Skills installed successfully"
You can also check the number of available skills:
ls ~/.gemini/antigravity/skills/skills | wc -l

Your First Skill

Try using @brainstorming to experience how skills transform your AI assistant into a structured expert.
Skills work across all major AI coding assistants: Claude Code, Gemini CLI, Codex CLI, Kiro, Antigravity, Cursor, and OpenCode.

Example: Plan a SaaS MVP

>> Use @brainstorming to help me design a SaaS MVP for project management
What happens next:
  • The AI loads the brainstorming skill
  • It asks you structured questions (one at a time)
  • It guides you through understanding, requirements, and design
  • You answer each question
  • You get a complete design document—without writing code yet!

Choose Your Role-Based Bundle

Bundles are curated skill lists organized by role. Pick 3-5 skills from your bundle to start. You already have all skills installed—bundles just help you discover the right ones.
The “Web Wizard” Pack — For building modern, high-performance web appsEssential skills to start with:
  • @frontend-design — UI guidelines and aesthetics
  • @react-best-practices — React & Next.js performance optimization
  • @react-patterns — Modern React patterns and principles
  • @nextjs-best-practices — Next.js App Router patterns
  • @tailwind-patterns — Tailwind CSS v4 styling superpowers
  • @seo-audit — Get found on Google
View complete bundle →
Important: Bundles are NOT separate installations! When you installed the repository, you got all 968+ skills. Bundles are recommended lists to help you pick which skills to use for your role.

Complete Example: Building a Feature End-to-End

See how skills work together in a real workflow. This example shows building a blog for a Next.js website using 5 sequential skills.
1

Plan with @brainstorming

Start by designing the system architecture and requirements.
Use @brainstorming to design a blog system for my Next.js site
Result: The AI asks structured questions about your requirements and produces a detailed design specification.
2

Implement with @nextjs-best-practices

Scaffold the blog structure following Next.js conventions.
Use @nextjs-best-practices to scaffold the blog with App Router
Result: The AI creates the file structure, sets up routes, and adds components following modern Next.js patterns.
3

Style with @tailwind-patterns

Apply modern, responsive styling to your blog.
Use @tailwind-patterns to make the blog posts look modern
Result: The AI applies Tailwind CSS styling with responsive design and modern aesthetics.
4

Optimize with @seo-audit

Make your blog discoverable by search engines.
Use @seo-audit to optimize the blog for search engines
Result: The AI adds meta tags, sitemaps, structured data, and implements SEO best practices.
5

Test and deploy

Add test coverage and deploy safely.
Use @test-driven-development to add tests, then @vercel-deployment to deploy
Result: The AI creates test suites, sets up CI/CD pipelines, and deploys to Vercel with proper configuration.
Outcome: A professional blog built with best practices, without manually researching each step or technology.

Common Questions

Any of them! Skills work universally across all major AI coding assistants. 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
  • Antigravity IDE — Native support with global skills
  • Kiro CLI/IDE — Auto-loading on-demand skills
  • OpenCode — Open-source CLI alternative
All skills work the same way across all tools.
No! When you clone/install the repository, all skills are available locally, but your AI only loads the ones you explicitly invoke with @skill-name.Think of it like a library: All books are on the shelf, but you only read the ones you need.Start with 3-5 skills from your role’s bundle in the Bundles Guide, then expand as needed.
  • Bundles are curated skill lists organized by role (like “Web Wizard” or “Security Engineer”). They help you discover which skills are relevant.
  • Workflows are step-by-step execution playbooks for concrete outcomes (like “Ship a SaaS MVP” or “Security Audit”).
Use bundles when deciding which skills to use. Use workflows when you need guided execution for a specific goal.Learn more: Bundles Guide | Workflows Guide
Yes! Three ways to browse skills:
  1. Interactive Web App — Search, filter, and copy skills with a modern UI (run START_APP.bat on Windows or cd web-app && npm run app:dev on macOS/Linux)
  2. Skill Catalog — Complete searchable list in the CATALOG.md
  3. Command line — Run ls ~/.gemini/antigravity/skills/skills/ to see all skill directories
  4. 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. Verify the installation path matches your tool’s expected location
  3. Reinstall with the tool-specific flag: npx antigravity-awesome-skills --claude (or --cursor, --gemini, etc.)
Yes! Use the @skill-creator skill to build custom skills:
Use @skill-creator to help me build a custom skill for [your specific task]
The AI will guide you through creating a properly formatted SKILL.md file following best practices.See the Contributing Guide for details on skill anatomy and quality standards.

Next Steps

Now that you’ve installed skills and tried your first one, here’s what to do next:

Browse Bundles

Find curated skill collections for your role: Web Dev, Security, Full-Stack, DevOps, AI/ML, and more.

Explore Workflows

Follow step-by-step playbooks for complete projects: Ship a SaaS MVP, Security Audit, Build AI Agents, and more.

View All Skills

Search the complete catalog of 968+ skills organized by category with descriptions and risk labels.

Usage Guide

Learn best practices, prompt patterns, and advanced techniques for getting the most out of skills.
Pro Tip: Start every new feature or project with @brainstorming. You’ll save hours of refactoring by planning first!

Build docs developers (and LLMs) love