🚀 New Here? Start Here

🔍 Searched for AI coding skills, Claude Code skills, Cursor skills, Codex CLI skills, Gemini CLI skills, Antigravity skills, or installable SKILL.md libraries?
You're in the right place. 👇

1️⃣ What is this?

Awesome Omni Skills is an installable skill catalog and runtime for AI coding assistants. At its core, it's a public repository of reusable SKILL.md playbooks, curated enhanced best-practice derivatives, and the runtime surfaces that distribute and operate that catalog.

2️⃣ Quick Start

# Install with guided flow
npx awesome-omni-skills

# Or install directly for Antigravity (default outside TTY)
npx awesome-omni-skills install --guided

Migration note: npx awesome-omni-skills is the new primary command. The legacy alias npx omni-skills still works during the migration window.

3️⃣ Verify

test -d ~/.gemini/antigravity/skills && echo "✅ Skills installed"

4️⃣ Use your first skill

💬 "Use @brainstorming to plan a SaaS MVP."

💬 "Use @api-design to review this endpoint design."

💬 "Use @debugging to isolate this regression."

5️⃣ Start with a bundle

🧩 Core Concepts

Before comparing bundles or picking an install path, understanding these five building blocks helps:

📝 Native/Curated policy:

• skills/ accepts native upstream intake in any language, whether submitted directly or proposed by the private external-sync runtime
• skills_omni/ is always curated and published in English
• skills_omni/ is a one-way surface and does not loop back into native intake

💡 Why Awesome Omni Skills

Not just "another repository with skills in folders."
Awesome Omni Skills has a stronger contract and a broader runtime surface.

🖥️ Compatibility and Invocation

These skills follow the SKILL.md model and can be used as a normal repository, but the package also installs and configures them across a broad surface:

7 install-capable clients · 16 MCP config-capable clients

🎯 Install-Capable Clients

These targets are part of the supported MCP configuration surface, even when they are not install targets for skill directories:

⚡ Installation

npx awesome-omni-skills

npx awesome-omni-skills install --guided

npx awesome-omni-skills --skill api-design

npx awesome-omni-skills --bundle devops

npx awesome-omni-skills --cursor --skill omni-figma
npx awesome-omni-skills --codex --bundle full-stack
npx awesome-omni-skills --claude --skill debugging

npx awesome-omni-skills --path ./my-skills --skill architecture

🔎 Discovery before install

npx awesome-omni-skills find figma
npx awesome-omni-skills find mcp --sort quality --min-quality 90 --min-security 95
npx awesome-omni-skills find foundation --bundle essentials --install --yes

🛠️ Choose Your Tool

📖 Not sure where to start?

• 🚀 Getting Started — install and verify in under 2 minutes
• 🧭 CLI User Guide — full command reference
• 📗 Usage Guide — prompts, patterns, and runtime modes

🔌 Runtime Surfaces

Awesome Omni Skills is not only a library of skills. It exposes four runtime surfaces that consume the same generated catalog:

npx awesome-omni-skills ui                # Ink visual terminal hub
npx awesome-omni-skills ui --text         # Text fallback UI
npx awesome-omni-skills doctor            # Environment diagnostics
npx awesome-omni-skills smoke             # Full release preflight
npx awesome-omni-skills publish-check     # Package publication checks

# Start MCP transports
npx awesome-omni-skills mcp stdio
npx awesome-omni-skills mcp stream
npx awesome-omni-skills mcp sse
npx awesome-omni-skills mcp stream --local     # Local sidecar with filesystem tools

# Configure MCP for any supported client
npx awesome-omni-skills config-mcp --list-targets
npx awesome-omni-skills config-mcp --target continue-workspace --transport stream --url http://127.0.0.1:3334/mcp
npx awesome-omni-skills config-mcp --target windsurf-user --transport sse --url http://127.0.0.1:3335/sse --write

📦 Catalog, Bundles, and Curated Output

📊 Current Catalog

📦 Bundle Availability

✨ Native Intake → Curated Output

ℹ️ Changes to native skills are reprocessed by the private enhancer and refreshed in the curated baseline. This makes skills_omni/ a maintained catalog surface, not a second copy.

🛡️ Security and Release Posture

Awesome Omni Skills ships a stronger release and verification story than a plain markdown repository.

🧪 Validation and Smoke Checks

npm run validate         # Skill validation and metadata generation
npm run build            # Full build pipeline
npm test                 # Automated tests
npm run smoke            # Full release preflight

• ✅ Skill validation and metadata generation
• ✅ Taxonomy normalization and recategorization tooling
• ✅ Catalog and archive generation
• ✅ Automated tests
• ✅ API, MCP, and A2A boot paths
• ✅ Archive verification
• ✅ Package preflight with npm pack --dry-run

Auto-release triggers only when a merge changes:

• skills/*/**
• skills_omni/*/**
• data/bundles.json

Doc-only changes do not trigger package publication.

📖 Documentation Map

👤 For Users

🏗️ For Architects

🤝 For Contributors

🗂️ Repository Layout

ℹ️ dist/ is intentionally versioned because the generated artifacts are part of the install, API, MCP, A2A, smoke, and release contract.

🤝 Contributing

Awesome Omni Skills accepts native upstream skill intake under skills/.

📖 Start with: Contributing Guide · Skill PR Workflow

📄 License