# Awesome Omni Skills

> Public repository of AI coding skills, curated improved best-practice skills, and runtime surfaces for CLI, API, MCP, and A2A.

- **Type:** MCP server
- **Install:** `agentstack add mcp-diegosouzapw-awesome-omni-skills`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [diegosouzapw](https://agentstack.voostack.com/s/diegosouzapw)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [diegosouzapw](https://github.com/diegosouzapw)
- **Source:** https://github.com/diegosouzapw/awesome-omni-skills
- **Website:** https://github.com/diegosouzapw/awesome-omni-skills#readme

## Install

```sh
agentstack add mcp-diegosouzapw-awesome-omni-skills
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🧠 Awesome Omni Skills

### Public Skill Repository · Curated Improved Best-Practice Skills · Runtime Surfaces

**The skill catalog that installs itself.**
CLI · API · MCP · A2A — all from a single `npx` command.

> 🚀 *4715 skills · 7 bundles · 9 install clients · 16 MCP clients · 4 runtime surfaces*

[](LICENSE)
[](LICENSE-CONTENT)
[](https://www.npmjs.com/package/awesome-omni-skills)
[](https://nodejs.org)

[](#-installation)
[](#-runtime-surfaces)
[](#-runtime-surfaces)
[](#-runtime-surfaces)

  🇺🇸 English
  · 🇪🇸 Español
  · 🇫🇷 Français
  · 🇩🇪 Deutsch
  · 🇮🇹 Italiano
  · 🇷🇺 Русский
  · 🇨🇳 中文（简体）
  · 🇯🇵 日本語
  · 🇰🇷 한국어
  · 🇸🇦 العربية
  · 🇮🇳 हिन्दी
  · 🇹🇭 ไทย
  · 🇻🇳 Tiếng Việt
  · 🇮🇩 Bahasa Indonesia
  · 🇲🇾 Bahasa Melayu
  · 🇳🇱 Nederlands
  · 🇵🇱 Polski
  · 🇸🇪 Svenska
  · 🇳🇴 Norsk
  · 🇩🇰 Dansk
  · 🇫🇮 Suomi
  · 🇵🇹 Português (Portugal)
  · 🇷🇴 Română
  · 🇭🇺 Magyar
  · 🇧🇬 Български
  · 🇸🇰 Slovenčina
  · 🇺🇦 Українська
  · 🇮🇱 עברית
  · 🇵🇭 Filipino
  · 🇧🇷 Português (Brasil)

[⚡ Install in 1 min](#-installation) · [🛠️ Choose your tool](#-choose-your-tool) · [📖 CLI Guide](docs/users/CLI-USER-GUIDE.md) · [📦 Bundles](docs/users/BUNDLES.md) · [🔌 Runtime](#-runtime-surfaces) · [💡 Why Awesome Omni Skills](#-why-awesome-omni-skills)

---

### 📊 Project at a Glance

| | Metric | Value |
|:--|:-------|:------|
| 📦 | **Published Skills** | `4715` native skills across 17 active categories |
| 🎯 | **Bundles** | `7` fully backed curated bundles |
| 🖥️ | **Install Clients** | `9` install-capable AI coding assistants |
| 🔌 | **MCP Clients** | `16` MCP config-capable clients across `33` first-class targets |
| 🔐 | **Curated Output** | `1623` enhanced English derivatives in `skills_omni` |
| 🧪 | **Validation Mix** | `4073` passed · `642` warn · `0` errors |
| 📋 | **Current Release** | `v0.12.9` |

---

## 🚀 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.

📋 What's included

| Component | Description |
|:----------|:-----------|
| 🧠 **Skills** | Reusable `SKILL.md`-based playbooks for AI assistants, including native intake from direct contributor PRs and reviewed repository-based external-import PRs |
| 📦 **Manifests** | Generated JSON manifests, bundles, and archives |
| 🧭 **Guided Install** | Interactive TTY and visual terminal install flows |
| 🌐 **Catalog API** | Read-only HTTP API for search, discovery, and downloads |
| 🔌 **MCP Server** | Discovery, recommendation, and client-aware config tooling |
| 🤖 **A2A Runtime** | Agent-to-agent task orchestration |
| ✨ **Enhancement Pipeline** | Private enhancer publishes curated English derivatives into `skills_omni/` |

### 2️⃣ Quick Start

```bash
# 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

```bash
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

| 🎯 Goal | Bundle | Command |
|:---------|:-------|:--------|
| General engineering | `essentials` | `npx awesome-omni-skills --bundle essentials` |
| Product + app delivery | `full-stack` | `npx awesome-omni-skills --bundle full-stack` |
| Design systems | `design` | `npx awesome-omni-skills --bundle design` |
| Security review | `security` | `npx awesome-omni-skills --bundle security` |
| Infra and release | `devops` | `npx awesome-omni-skills --bundle devops` |
| LLM applications | `ai-engineer` | `npx awesome-omni-skills --bundle ai-engineer` |
| OSS maintenance | `oss-maintainer` | `npx awesome-omni-skills --bundle oss-maintainer` |

---

## 🧩 Core Concepts

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

| Concept | What it means |
|:--------|:-------------|
| 🧠 **Skills** | Reusable `SKILL.md` playbooks that teach an assistant how to execute a workflow well |
| 📦 **Catalog Artifacts** | Generated JSON and archive outputs enabling search, comparison, download, and install |
| 🔌 **MCP Config** | Client-side configuration for assistants to discover Awesome Omni Skills through MCP tools |
| 🤖 **A2A Runtime** | Agent-to-agent orchestration for discovery, recommendation, and install-plan handoff |
| ✨ **Curated Output** | `skills_omni/` — the Awesome Omni Skills-maintained enhanced surface, separate from native upstream intake |

> **📝 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.

| If you want… | 📁 Typical skills repo | ✨ Awesome Omni Skills |
|:-------------|:----------------------|:--------------|
| Install into a real assistant | Manual copy or custom script | `npx awesome-omni-skills`, guided install, visual UI, selective `--skill` and `--bundle` |
| Search and compare skills | Browse markdown manually | Generated catalog, filtering, bundle planning, search, compare, and recommendation |
| Use the same data across tools | Separate logic per tool | Shared manifests and catalog for CLI, API, MCP, and A2A |
| Configure MCP clients | Hand-edit files | `config-mcp`, local sidecar previews, generated recipes, and allowlisted writes |
| Trust repository content | Minimal or ad hoc linting | Critical static security gate blocks unsafe patterns such as remote content piped into shell or instructions that try to expose prompts, secrets, or hidden context |
| Trust releases | Best-effort packaging | Checksums, signed archives, ClamAV + VirusTotal verified release CI, and publish preflight |
| Curate community intake | Whatever lands stays as-is | Native intake in `skills/`, curated English derivatives in `skills_omni/` with attribution |

---

## 🖥️ 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

| Tool | Type | Invocation Example | Install Path |
|:-----|:-----|:-------------------|:-------------|
| 🟢 **Claude Code** | CLI | `Use brainstorming to plan a feature` | `~/.claude/skills` |
| 🔵 **Cursor** | IDE | `@brainstorming help me plan a feature` | `~/.cursor/skills` |
| 🟡 **Gemini CLI** | CLI | `Use brainstorming to plan a feature` | `~/.gemini/skills` |
| 🔴 **Codex CLI** | CLI | `Use brainstorming to plan a feature` | `~/.codex/skills` |
| 🟠 **Kiro** | CLI / IDE | `Use brainstorming to plan a feature` | `~/.kiro/skills` |
| 🟣 **Antigravity** | IDE | `Use @brainstorming to plan a feature` | `~/.gemini/antigravity/skills` |
| 🟤 **Goose** | CLI | `goose session --with-extension ...` | `~/.agents/skills` |
| 🟧 **Qwen Code** | CLI | `Use @brainstorming to plan a feature` | `/.qwen/skills` |
| ⚪ **OpenCode** | CLI | `opencode run @brainstorming` | `/.opencode/skills` |

🔌 Broader MCP Configuration Coverage (16 clients)

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

| Client or Surface | Support Type | Notes |
|:------------------|:------------|:------|
| Claude settings and desktop | MCP config | Settings, desktop, and project-aware flows |
| VS Code | MCP config | User, workspace, insiders, and Dev Container targets |
| Gemini | MCP config | User and workspace settings |
| Cline | MCP config | First-class config target |
| GitHub Copilot CLI | MCP config | User and repo config targets |
| Continue | MCP config | Workspace YAML generation |
| Windsurf | MCP config | User config target |
| Zed | MCP config | Workspace config target |
| Goose | MCP config | User config target with generated recipe |
| Kilo Code | MCP config | User, project, and workspace targets |
| Junie | MCP config | Project and user config targets |

---

## ⚡ Installation

### Option A: Install with `npx` *(recommended)*

```bash
npx awesome-omni-skills
```

### Option B: Guided install

```bash
npx awesome-omni-skills install --guided
```

### Option C: Specific skill

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

### Option D: Install a bundle

```bash
npx awesome-omni-skills --bundle devops
```

### Option E: Target a specific client

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

### Option F: Custom path

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

### 🔎 Discovery before install

```bash
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

| Tool | Install Command | First Use |
|:-----|:---------------|:----------|
| 🟢 Claude Code | `npx awesome-omni-skills --claude` | `Use brainstorming to plan a feature` |
| 🔵 Cursor | `npx awesome-omni-skills --cursor` | `@brainstorming help me plan a feature` |
| 🟡 Gemini CLI | `npx awesome-omni-skills --gemini` | `Use brainstorming to plan a feature` |
| 🔴 Codex CLI | `npx awesome-omni-skills --codex` | `Use brainstorming to plan a feature` |
| 🟣 Antigravity | `npx awesome-omni-skills --antigravity` *(default)* | `Use @brainstorming to plan a feature` |
| 🟠 Kiro | `npx awesome-omni-skills --kiro` | `Use brainstorming to plan a feature` |
| 🟤 Goose | `npx awesome-omni-skills --goose` | `goose session --with-extension ...` |
| 🟧 Qwen Code | `npx awesome-omni-skills --qwen` | `Use @brainstorming to plan a feature` |
| ⚪ OpenCode | `npx awesome-omni-skills --opencode` | `opencode run @brainstorming` |
| 🧩 Saved custom target | `npx awesome-omni-skills --target-id custom-team-cli` | Depends on your tool |
| 📂 Custom path | `npx awesome-omni-skills --path ./my-skills` | Depends on your tool |

> 📖 **Not sure where to start?**
> - [🚀 Getting Started](docs/users/GETTING-STARTED.md) — install and verify in under 2 minutes
> - [🧭 CLI User Guide](docs/users/CLI-USER-GUIDE.md) — full command reference
> - [📗 Usage Guide](docs/users/USAGE.md) — 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:

| Surface | State | What it does | Example |
|:--------|:------|:-------------|:--------|
| 🖥️ **CLI** | ✅ Available | Find, install, diagnose, visual UI, boot services, smoke checks | `npx awesome-omni-skills doctor` |
| 🌐 **Catalog API** | ✅ Available | Read-only catalog, search, bundles, compare, install plans, downloads, Swagger UI on `/docs` | `npx awesome-omni-skills api --port 3333` |
| 🔌 **MCP** | ✅ Available | Discovery, recommendation, install preview, local sidecar, config flows | `npx awesome-omni-skills mcp stream --local` |
| 🤖 **A2A** | ✅ Available | Task lifecycle, handoff, polling, streaming, cancelation, persistence | `npx awesome-omni-skills a2a --port 3335` |

🖥️ Visual shell and operator commands

```bash
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
```

The visual shell now includes:

- a grouped home hub for install, runtime, and utility actions
- a search-first catalog explorer for skills and bundles
- richer install and runtime preview panels with step rails and command previews
- persisted local settings for theme, compact mode, and screen reader preference
- explicit `INK_SCREEN_READER=true` and `ui --text` fallback paths

🔌 MCP transports and config

```bash
# 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

| Metric | Current State |
|:-------|:--------------|
| 🧠 Native intake skills | **4715** |
| 📂 Active categories | **17** |
| 📦 Fully backed bundles | **7** |
| ✨ Curated derivatives | **1623** in `skills_omni` |
| 🧪 Validation | **4073 passed / 642 warn / 0 errors** |
| 📋 Release | **v0.12.9** |

### 📦 Bundle Availability

> ℹ️ Bundle definitions in [`data/bundles.json`](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.

| Bundle | Backing | Members |
|:-------|:--------|:--------|
| 🧰 `essentials` | **2/4** ⚠️ | `find-skills` · `brainstorming` · `architecture` · `debugging` |
| 🌐 `full-stack` | **2/5** ⚠️ | `frontend-design` · `api-design` · `database-design` · `omni-figma` · `auth-flows` |
| 🎨 `design` | **1/5** ⚠️ | `frontend-design` · `omni-figma` · `design-systems-ops` · `accessibility-audit` · `design-token-governance` |
| 🛡️ `security` | **2/4** ⚠️ | `security-auditor` · `vulnerability-scanner` · `incident-response` · `threat-modeling` |
| ⚙️ `devops` | **1/5** ⚠️ | `docker-expert` · `kubernetes` · `terraform` · `observability-review` · `release-engineering` |
| 🤖 `ai-engineer` | **2/7** ⚠️ | `rag-engineer` · `prompt-engineer` · `llm-patterns` · `eval-design` · `context-engineering` · `data-contracts` · `model-serving` |
| 🔧 `oss-maintainer` | **2/4** ⚠️ | `find-skills` · `create-pr` · `changelog` · `documentation` |

### ✨ Native Intake → Curated Output

| Surface | Purpose | Language |
|:--------|:--------|:---------|
| 📥 `skills/` | Native intake | Any language |
| ✨ `skills_omni/` | Curated Omni-maintained output | Always English |

> **ℹ️** Changes to native skills are reprocessed by the private enhancer and refreshed in the curated baseline. This makes `skills_omni/` a **mai

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [diegosouzapw](https://github.com/diegosouzapw)
- **Source:** [diegosouzapw/awesome-omni-skills](https://github.com/diegosouzapw/awesome-omni-skills)
- **License:** MIT
- **Homepage:** https://github.com/diegosouzapw/awesome-omni-skills#readme

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-diegosouzapw-awesome-omni-skills
- Seller: https://agentstack.voostack.com/s/diegosouzapw
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.