5af8360409
Document the new Claude Code and Codex plugin distributions and explain how root plugins, bundle plugins, and plugin-safe filtering relate to the full library install.\n\nSync the catalog, plugin compatibility artifacts, and generated plugin-safe subsets so main stays consistent before the v9.0.0 release flow.
7.6 KiB
Getting Started with Antigravity Awesome Skills (V9.0.0)
New here? This guide will help you supercharge your AI Agent in 5 minutes.
💡 Confused about what to do after installation? Check out the Complete Usage Guide for detailed explanations and examples!
What Are "Skills"?
AI Agents (like Claude Code, Gemini, Cursor) are smart, but they lack specific knowledge about your tools. Skills are specialized instruction manuals (markdown files) that teach your AI how to perform specific tasks perfectly, every time.
Analogy: Your AI is a brilliant intern. Skills are the SOPs (Standard Operating Procedures) that make them a Senior Engineer.
Quick Start: The "Starter Packs"
Don't panic about the size of the repository. You don't need everything at once. We have curated Starter Packs to get you running immediately.
You install the full repo once (npx or clone); Starter Packs are curated lists to help you pick which skills to use by role (e.g. Web Wizard, Hacker Pack)—they are not a different way to install.
If you prefer a marketplace-style install for Claude Code or Codex, use the new plugin distributions described in plugins.md.
1. Install the Repo
Option A — npx (easiest):
npx antigravity-awesome-skills
This clones to ~/.gemini/antigravity/skills by default. Use --cursor, --claude, --gemini, --codex, or --kiro to install for a specific tool, or --path <dir> for a custom location. Run npx antigravity-awesome-skills --help for details.
If you see a 404 error, use: npx github:sickn33/antigravity-awesome-skills
Option B — git clone:
# Universal (works for most agents)
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
2. Pick Your Persona
Find the bundle that matches your role (see bundles.md):
| Persona | Bundle Name | What's Inside? |
|---|---|---|
| Web Developer | Web Wizard |
React Patterns, Tailwind mastery, Frontend Design |
| Security Engineer | Hacker Pack |
OWASP, Metasploit, Pentest Methodology |
| Manager / PM | Product Pack |
Brainstorming, Planning, SEO, Strategy |
| Everything | Essentials |
Clean Code, Planning, Validation (The Basics) |
Bundles vs Workflows
Bundles and workflows solve different problems:
- Bundles = curated sets by role (what to pick).
- Workflows = step-by-step playbooks (how to execute).
Start with bundles in bundles.md, then run a workflow from workflows.md when you need guided execution.
Example:
"Use @antigravity-workflows and run
ship-saas-mvpfor my project idea."
How to Use a Skill
Once installed, just talk to your AI naturally.
Example 1: Planning a Feature (Essentials)
"Use @brainstorming to help me design a new login flow."
What happens: The AI loads the brainstorming skill, asks you structured questions, and produces a professional spec.
Example 2: Checking Your Code (Web Wizard)
"Run @lint-and-validate on this file and fix errors."
What happens: The AI follows strict linting rules defined in the skill to clean your code.
Example 3: Security Audit (Hacker Pack)
"Use @api-security-best-practices to review my API endpoints."
What happens: The AI audits your code against OWASP standards.
🔌 Supported Tools
| Tool | Status | Path |
|---|---|---|
| Claude Code | ✅ Full Support | .claude/skills/ or install via /plugin marketplace add sickn33/antigravity-awesome-skills |
| Gemini CLI | ✅ Full Support | .gemini/skills/ |
| Codex CLI | ✅ Full Support | .codex/skills/ or use the repo-local plugin metadata described in plugins.md |
| Kiro CLI | ✅ Full Support | Global: ~/.kiro/skills/ · Workspace: .kiro/skills/ |
| Kiro IDE | ✅ Full Support | Global: ~/.kiro/skills/ · Workspace: .kiro/skills/ |
| Antigravity | ✅ Native | Global: ~/.gemini/antigravity/skills/ · Workspace: .agent/skills/ |
| Cursor | ✅ Native | .cursor/skills/ |
| OpenCode | ✅ Full Support | .agents/skills/ |
| AdaL CLI | ✅ Full Support | .adal/skills/ |
| Copilot | ⚠️ Text Only | Manual copy-paste |
Trust & Safety
We classify skills so you know what you're running:
- 🟣 Official: Maintained by Anthropic/Google/Vendors (High Trust).
- 🔵 Safe: Community skills that are non-destructive (Read-only/Planning).
- 🔴 Risk: Skills that modify systems or perform security tests (Authorized Use Only).
When adding new skills, high-risk guidance is extra-reviewed with repository-wide security:docs scanning before release.
Check the Skill Catalog for the full list.
FAQ
If you prefer a plugin install instead of copying skills into tool directories, start with plugins.md.
For Claude Code, use:
/plugin marketplace add sickn33/antigravity-awesome-skills
/plugin install antigravity-awesome-skills
For Codex, this repository also ships a root plugin plus bundle plugins through the repo-local metadata described in plugins.md.
Q: Do I need to install every skill? A: You clone the whole repo once; your AI only reads the skills you invoke (or that are relevant), so it stays lightweight. Starter Packs in bundles.md are curated lists to help you discover the right skills for your role—they don't change how you install.
Q: Can I make my own skills? A: Yes! Use the @skill-creator skill to build your own.
Q: What if Antigravity on Windows gets stuck in a truncation crash loop? A: Follow the recovery steps in windows-truncation-recovery.md. It explains which Antigravity storage folders to back up and clear, and includes an optional batch helper adapted from issue #274.
Q: What if Antigravity overloads on Linux or macOS when too many skills are active?
A: Use the activation flow in agent-overload-recovery.md. It shows how to run scripts/activate-skills.sh from a cloned repo so you can keep the full library archived and activate only the bundles or skills you need in the live Antigravity directory.
Q: Is this free? A: Yes. Original code and tooling are MIT-licensed, and original documentation/non-code written content is CC BY 4.0. See ../../LICENSE and ../../LICENSE-CONTENT.
Next Steps
Need a tool-specific starting point first?