Content
<!-- generated:project-meta:start -->
<!-- awesome-omni-skills: version=0.12.9; native_skills=4715; curated_skills=1623; updated_at=2026-05-17 -->
<!-- generated:project-meta:end -->
<div align="center">
# 🧠 Awesome Omni Skills
### Public Skill Repository · Curated Improved Best-Practice Skills · Runtime Surfaces
<br/>
**The skill catalog that installs itself.**<br/>
CLI · API · MCP · A2A — all from a single `npx` command.
> 🚀 *4715 skills · 7 bundles · 9 install clients · 16 MCP clients · 4 runtime surfaces*
<br/>
[](LICENSE)
[](LICENSE-CONTENT)
[](https://www.npmjs.com/package/awesome-omni-skills)
[](https://nodejs.org)
[](#-installation)
[](#-runtime-surfaces)
[](#-runtime-surfaces)
[](#-runtime-surfaces)
<p align="center">
🇺🇸 English
· <a href="docs/i18n/es/README.md">🇪🇸 Español</a>
· <a href="docs/i18n/fr/README.md">🇫🇷 Français</a>
· <a href="docs/i18n/de/README.md">🇩🇪 Deutsch</a>
· <a href="docs/i18n/it/README.md">🇮🇹 Italiano</a>
· <a href="docs/i18n/ru/README.md">🇷🇺 Русский</a>
· <a href="docs/i18n/zh-CN/README.md">🇨🇳 中文（简体）</a>
· <a href="docs/i18n/ja/README.md">🇯🇵 日本語</a>
· <a href="docs/i18n/ko/README.md">🇰🇷 한국어</a>
· <a href="docs/i18n/ar/README.md">🇸🇦 العربية</a>
· <a href="docs/i18n/in/README.md">🇮🇳 हिन्दी</a>
· <a href="docs/i18n/th/README.md">🇹🇭 ไทย</a>
· <a href="docs/i18n/vi/README.md">🇻🇳 Tiếng Việt</a>
· <a href="docs/i18n/id/README.md">🇮🇩 Bahasa Indonesia</a>
· <a href="docs/i18n/ms/README.md">🇲🇾 Bahasa Melayu</a>
· <a href="docs/i18n/nl/README.md">🇳🇱 Nederlands</a>
· <a href="docs/i18n/pl/README.md">🇵🇱 Polski</a>
· <a href="docs/i18n/sv/README.md">🇸🇪 Svenska</a>
· <a href="docs/i18n/no/README.md">🇳🇴 Norsk</a>
· <a href="docs/i18n/da/README.md">🇩🇰 Dansk</a>
· <a href="docs/i18n/fi/README.md">🇫🇮 Suomi</a>
· <a href="docs/i18n/pt/README.md">🇵🇹 Português (Portugal)</a>
· <a href="docs/i18n/ro/README.md">🇷🇴 Română</a>
· <a href="docs/i18n/hu/README.md">🇭🇺 Magyar</a>
· <a href="docs/i18n/bg/README.md">🇧🇬 Български</a>
· <a href="docs/i18n/sk/README.md">🇸🇰 Slovenčina</a>
· <a href="docs/i18n/uk-UA/README.md">🇺🇦 Українська</a>
· <a href="docs/i18n/he/README.md">🇮🇱 עברית</a>
· <a href="docs/i18n/phi/README.md">🇵🇭 Filipino</a>
· <a href="docs/i18n/pt-BR/README.md">🇧🇷 Português (Brasil)</a>
</p>
<br/>
[⚡ 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)
</div>
---
<div align="center">
### 📊 Project at a Glance
</div>
<!-- generated:readme-project-at-a-glance:start -->
| | 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` |
<!-- generated:readme-project-at-a-glance:end -->
---
## 🚀 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.
<details>
<summary>📋 <strong>What's included</strong></summary>
| 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/` |
</details>
### 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` | `<workspace>/.qwen/skills` |
| ⚪ **OpenCode** | CLI | `opencode run @brainstorming` | `<workspace>/.opencode/skills` |
<details>
<summary>🔌 <strong>Broader MCP Configuration Coverage (16 clients)</strong></summary>
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 |
</details>
---
## ⚡ Installation
<table>
<tr>
<td width="50%">
### 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
```
</td>
<td width="50%">
### 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
```
</td>
</tr>
</table>
### 🔎 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` |
<details>
<summary>🖥️ <strong>Visual shell and operator commands</strong></summary>
```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
</details>
<details>
<summary>🔌 <strong>MCP transports and config</strong></summary>
```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
```
</details>
---
## 📦 Catalog, Bundles, and Curated Output
### 📊 Current Catalog
<!-- generated:readme-published-catalog-snapshot:start -->
| 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** |
<!-- generated:readme-published-catalog-snapshot:end -->
### 📦 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 <id>` 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 **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
```bash
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
```
<details>
<summary>📋 <strong>What the pipeline validates</strong></summary>
- ✅ Skill validation and metadata generation
- ✅ Critical security gating on native intake before PR merge
- ✅ Taxonomy normalization and recategorization tooling
- ✅ Catalog and archive generation
- ✅ Legacy integration tests (Python PTY + Node TUI assertions)
- ✅ Vitest unit suite for catalog-core scoring, search, and filtering logic
- ✅ API, MCP, and A2A boot paths
- ✅ Archive verification
- ✅ OpenAPI 3.1 contract served via Swagger UI at `/docs`
- ✅ Package preflight with `npm pack --dry-run`
</details>
<details>
<summary>🔐 <strong>Release posture</strong></summary>
| Control | Description |
|:--------|:-----------|
| 🔒 SHA-256 checksums | Checksum manifests for all archives |
| ✍️ Signed artifacts | Detached signatures on release artifacts |
| 🤖 CI-enforced | Release verification in CI before publication |
| 🦠 Scanner gates | ClamAV and VirusTotal both required in release verification before publish |
| 📦 GitHub Release | Automated GitHub Release generation |
| 📋 npm publication | From verified tarball only |
| 🔄 Auto release | On qualifying skill merges to `main` |
**Auto-release triggers only when a merge changes:**
- `skills/*/**`
- `skills_omni/*/**`
- `data/bundles.json`
Doc-only changes **do not** trigger package publication.
</details>
<details>
<summary>🛡️ <strong>Repository safety contract</strong></summary>
- Native intake does not accept skills with critical security findings.
- The static validator blocks high-risk patterns before a skill can merge into the public catalog.
- The current hard blockers include:
- remote content piped directly into shell execution
- instructions that try to reveal prompts, secrets, or hidden runtime context
- Published releases go through a stricter second layer:
- ClamAV scanning
- VirusTotal hash lookup
- archive checksum verification
- detached signature verification in release CI
This is a user-facing benefit, not just build plumbing: the catalog favors installable skills that already passed the same restrictive security gate the project uses internally.
</details>
---
## 📖 Documentation Map
### 👤 For Users
| Doc | What You'll Learn |
|:----|:-----------------|
| 🚀 [Getting Started](docs/users/GETTING-STARTED.md) | Install, verify, and invoke in under 2 minutes |
| 🧭 [CLI User Guide](docs/users/CLI-USER-GUIDE.md) | Full command reference and real-world patterns |
| 📗 [Usage Guide](docs/users/USAGE.md) | CLI commands, install modes, runtime, and MCP config |
| 📦 [Bundles](docs/users/BUNDLES.md) | Curated bundles and availability |
| 📚 [Catalog](docs/CATALOG.md) | Auto-generated catalog of published skills |
| 🔧 [System Runbook](docs/users/RUNBOOK.md) | Build, serve, secure, and troubleshoot |
### 🏗️ For Architects
| Doc | What You'll Learn |
|:----|:-----------------|
| 🏛️ [Architecture & System Overview](docs/ARCHITECTURE.md) | End-to-end map of all functionality, how the surfaces connect, and current state |
| 🗂️ [Project Structure](docs/PROJECT-STRUCTURE.md) | The monorepo directory and file reference, and where each runtime lives |
| 🌐 [Catalog API](docs/specs/CATALOG-API.md) | HTTP endpoints, filtering, governance, and downloads |
| 🧩 [CLI Guided Installer](docs/specs/CLI-GUIDED-INSTALLER.md) | Behavioral contract for the guided installer |
| 🖥️ [CLI Visual Shell](docs/specs/CLI-VISUAL-SHELL.md) | Ink visual shell and state model |
| 🧬 [Skill Family, Variant, and Provenance Model](docs/specs/SKILL-FAMILY-VARIANT-MODEL.md) | Catalog grouping, variant selection, and provenance contract |
| 🔌 [Local MCP Sidecar](docs/specs/LOCAL-MCP-SIDECAR.md) | Filesystem tools and allowlist model |
| 📊 [Client Support Matrix](docs/specs/CLIENT-SUPPORT-MATRIX.md) | Full client and writer reference |
| 🏷️ [Skill Classification](docs/specs/SKILL-CLASSIFICATION.md) | Taxonomy, scoring, and metadata |
| 🛡️ [Security Validation](docs/specs/SECURITY-VALIDATION.md) | Scanners, archives, and signatures |
| 📋 [Skill Manifest](docs/specs/SKILL-MANIFEST.md) | Machine-readable manifest format |
### 🤝 For Contributors
| Doc | What You'll Learn |
|:----|:-----------------|
| 📝 [Contributing Guide](CONTRIBUTING.md) | Repo workflow and PR expectations |
| 🧾 [Skill PR Workflow](docs/contributors/SKILL-PR-WORKFLOW.md) | Native intake, enhancer processing, reviewer expectations |
| 📄 [Skill Template](docs/contributors/SKILL-TEMPLATE.md) | Starter `SKILL.md` with frontmatter and structure |
| 🔬 [Skill Anatomy](docs/contributors/SKILL-ANATOMY.md) | Structure and quality expectations |
| ✅ [Quality Bar](docs/contributors/QUALITY-BAR.md) | Acceptance criteria |
| 🏆 [High-Score Playbook](docs/contributors/HIGH-SCORE-PLAYBOOK.md) | What drives high scores |
---
## 🗂️ Repository Layout
| Path | Purpose |
|:-----|:--------|
| 📂 `skills/` | Canonical authored skills and native intake from direct PRs or reviewed repository-based imports |
| ✨ `skills_omni/` | Curated Omni-maintained enhanced derivatives |
| 📖 `docs/` | User, contributor, architecture, operations, and spec documentation |
| 📦 `dist/` | Generated manifests, bundles, catalog, and archives |
| 📁 `data/` | Bundle definitions and static supporting data |
| 🧠 `packages/catalog-core/` | Shared catalog runtime with `ICatalogStorageAdapter` dependency injection |
| 🌐 `packages/server-api/` | Read-only HTTP API with OpenAPI/Swagger UI on `/docs` |
| 🔌 `packages/server-mcp/` | MCP server and local sidecar |
| 🤖 `packages/server-a2a/` | A2A runtime and task orchestration |
| 🖥️ `packages/cli/` | Unified CLI entrypoints, install logic, and Ink visual TUI (ESM-native) |
| ⚙️ `tools/scripts/` | Validation, generation, release, and test scripts |
| 🧪 `vitest.workspace.js` | Vitest monorepo workspace configuration |
> **ℹ️** `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/`.
| Rule | Details |
|:-----|:--------|
| 📥 Native intake | May be rough, authored in any language, and can arrive from direct PRs or reviewed external-import branches |
| ✨ Curated output | `skills_omni/` reserved for automation-authored Omni derivatives |
| 🌍 Upstream repo proposals | Add a URL to [`SOURCES.txt`](SOURCES.txt) — one line, one URL — or update one row in [REPOSITORY-SOURCES.md](REPOSITORY-SOURCES.md) to nominate a repository for operator review; repo-first proposals can now use `branch=auto` and `skills_path=auto` |
| 🚫 Manual edits | Public manual edits to `skills_omni/` are rejected |
| 🔄 Reprocessing | Private enhancer reprocesses native changes and refreshes curated baseline |
> 📖 **Start with:** [Contributing Guide](CONTRIBUTING.md) · [Skill PR Workflow](docs/contributors/SKILL-PR-WORKFLOW.md) · [Repository Sources](REPOSITORY-SOURCES.md)
---
## 📄 License
| Type | License |
|:-----|:--------|
| 💻 Code and tooling | [MIT License](LICENSE) |
| 📝 Documentation and skill content | [CC BY 4.0](LICENSE-CONTENT) |
---
<div align="center">
**Made with 🧠 by the Awesome Omni Skills Team**
[⭐ Star this repo](https://github.com/diegosouzapw/awesome-omni-skills) · [🐛 Report a bug](https://github.com/diegosouzapw/awesome-omni-skills/issues) · [💬 Discussions](https://github.com/diegosouzapw/awesome-omni-skills/discussions)
*If Awesome Omni Skills helps you build faster, consider giving it a ⭐ — it helps others discover the project!*
</div>
