diegosouzapw/awesome-omni-skills

---

---

🚀 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

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

---

📦 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 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

---