🚀 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 is a public repository of reusable SKILL.md playbooks, a curated repository of improved best-practice derivatives, and the CLI, API, MCP, and A2A runtime surfaces that distribute and operate the same catalog.

Native intake enters skills/ in two ways: direct contributor PRs and reviewed repository-based external-import PRs. Curated English-only derivatives are then proposed separately into skills_omni/ by the private enhancement pipeline.

2️⃣ Quick Start

# Open the visual shell in an interactive terminal
npx awesome-omni-skills

# Or force the text guided installer explicitly
npx awesome-omni-skills install --guided

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
• direct contributor PRs and repository-based external intake share the same validator, metadata refresh, and enhancer path

💡 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:

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

🎯 Install-Capable Clients

⚡ 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

ℹ️ Bundle definitions in data/bundles.json list each bundle's ideal members. Backing shows how many of those skill ids are present in the current published catalog — several are curated targets (e.g. find-skills, kubernetes, omni-figma) not yet in the auto-imported set, so most bundles are currently partially backed. Run npx awesome-omni-skills find --bundle <id> to see what installs today.

✨ 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                 # Legacy integration tests + Vitest unit suite
npm run test:unit        # Fast Vitest unit tests only (~500ms)
npm run test:coverage    # Vitest with V8 coverage
npm run smoke            # Full release preflight

📖 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 · Repository Sources

📄 License