omni-skills

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