# 🧠 Omni Skills (ไทย) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇸 [es](../es/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇩🇪 [de](../de/README.md) · 🇮🇹 [it](../it/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇮🇳 [in](../in/README.md) · 🇹🇭 [th](../th/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇮🇩 [id](../id/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇳🇴 [no](../no/README.md) · 🇩🇰 [da](../da/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇮🇱 [he](../he/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) ---
### Installable Agentic Skills · Runtime Surfaces · Curated Enhancement
**The skill catalog that installs itself.**
CLI · API · MCP · A2A — all from a single `npx` command. > 🚀 *48 skills · 7 bundles · 7 install clients · 16 MCP clients · 4 runtime surfaces*
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Content License: CC BY 4.0](https://img.shields.io/badge/Content-CC_BY_4.0-blue.svg)](LICENSE-CONTENT) [![npm](https://img.shields.io/badge/npm-omni--skills-cb3837?logo=npm)](https://www.npmjs.com/package/omni-skills) [![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen?logo=node.js)](https://nodejs.org) [![Install with NPX](https://img.shields.io/badge/⚡_Install-npx%20omni--skills-black?style=for-the-badge&logo=npm)](#-installation) [![MCP](https://img.shields.io/badge/🔌_MCP-stdio_%7C_stream_%7C_sse-2ea44f?style=for-the-badge)](#-runtime-surfaces) [![API](https://img.shields.io/badge/🌐_API-read--only_catalog-0366d6?style=for-the-badge)](#-runtime-surfaces) [![A2A](https://img.shields.io/badge/🤖_A2A-task_lifecycle-orange?style=for-the-badge)](#-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 Omni Skills](#-why-omni-skills)
---
### ภาพรวม
| | Metric | Value | |:--|:-------|:------| | 📦 | **Published Skills** | `48` native skills across 15 active categories | | 🎯 | **Bundles** | `7` fully backed curated bundles | | 🖥️ | **Install Clients** | `7` install-capable AI coding assistants | | 🔌 | **MCP Clients** | `16` MCP config-capable clients | | 🔐 | **Curated Output** | `32` enhanced English derivatives in `skills_omni/` | | 🧪 | **Validation Mix** | `40` passed · `8` warn · `0` errors | | 📋 | **Current Release** | `v0.1.3` | --- ## เริ่มต้นอย่างรวดเร็ว > 🔍 **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? Omni Skills is an **installable skill catalog and runtime** for AI coding assistants. At its core, it's a public repository of reusable `SKILL.md` playbooks — but unlike plain skill collections, the repo **is** the distribution and runtime layer.
📋 What's included | Component | Description | |:----------|:-----------| | 🧠 **Skills** | Curated `SKILL.md`-based playbooks for AI assistants | | 📦 **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 # Install with guided flow npx omni-skills # Or install directly for Antigravity (default outside TTY) npx 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 omni-skills --bundle essentials` | | Product + app delivery | `full-stack` | `npx omni-skills --bundle full-stack` | | Design systems | `design` | `npx omni-skills --bundle design` | | Security review | `security` | `npx omni-skills --bundle security` | | Infra and release | `devops` | `npx omni-skills --bundle devops` | | LLM applications | `ai-engineer` | `npx omni-skills --bundle ai-engineer` | | OSS maintenance | `oss-maintainer` | `npx 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 Omni Skills through MCP tools | | 🤖 **A2A Runtime** | Agent-to-agent orchestration for discovery, recommendation, and install-plan handoff | | ✨ **Curated Output** | `skills_omni/` — the Omni-maintained enhanced surface, separate from native upstream intake | > **📝 Native/Curated policy:** > - `skills/` accepts native upstream intake in any language > - `skills_omni/` is always curated and published in English > - `skills_omni/` is a one-way surface and does not loop back into native intake --- ## 💡 Why Omni Skills > **Not just "another repository with skills in folders."** > Omni Skills has a stronger contract and a broader runtime surface. | If you want… | 📁 Typical skills repo | ✨ Omni Skills | |:-------------|:----------------------|:--------------| | Install into a real assistant | Manual copy or custom script | `npx 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 releases | Best-effort packaging | Checksums, signed archives, scanner verification, 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: > **7** 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` | | ⚪ **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 |
--- ## ติดตั้ง
### Option A: Install with `npx` *(recommended)* ```bash npx omni-skills ``` ### Option B: Guided install ```bash npx omni-skills install --guided ``` ### Option C: Specific skill ```bash npx omni-skills --skill api-design ``` ### Option D: Install a bundle ```bash npx omni-skills --bundle devops ``` ### Option E: Target a specific client ```bash npx omni-skills --cursor --skill omni-figma npx omni-skills --codex --bundle full-stack npx omni-skills --claude --skill debugging ``` ### Option F: Custom path ```bash npx omni-skills --path ./my-skills --skill architecture ```
### 🔎 Discovery before install ```bash npx omni-skills find figma npx omni-skills find mcp --sort quality --min-quality 90 --min-security 95 npx omni-skills find foundation --bundle essentials --install --yes ``` --- ## 🛠️ Choose Your Tool | Tool | Install Command | First Use | |:-----|:---------------|:----------| | 🟢 Claude Code | `npx omni-skills --claude` | `Use brainstorming to plan a feature` | | 🔵 Cursor | `npx omni-skills --cursor` | `@brainstorming help me plan a feature` | | 🟡 Gemini CLI | `npx omni-skills --gemini` | `Use brainstorming to plan a feature` | | 🔴 Codex CLI | `npx omni-skills --codex` | `Use brainstorming to plan a feature` | | 🟣 Antigravity | `npx omni-skills --antigravity` *(default)* | `Use @brainstorming to plan a feature` | | 🟠 Kiro | `npx omni-skills --kiro` | `Use brainstorming to plan a feature` | | ⚪ OpenCode | `npx omni-skills --opencode` | `opencode run @brainstorming` | | 📂 Custom path | `npx 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 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 omni-skills doctor` | | 🌐 **Catalog API** | ✅ Available | Read-only catalog, search, bundles, compare, install plans, downloads | `npx omni-skills api --port 3333` | | 🔌 **MCP** | ✅ Available | Discovery, recommendation, install preview, local sidecar, config flows | `npx omni-skills mcp stream --local` | | 🤖 **A2A** | ✅ Available | Task lifecycle, handoff, polling, streaming, cancelation, persistence | `npx omni-skills a2a --port 3335` |
🖥️ Visual shell and operator commands ```bash npx omni-skills ui # Ink visual terminal hub npx omni-skills ui --text # Text fallback UI npx omni-skills doctor # Environment diagnostics npx omni-skills smoke # Full release preflight npx omni-skills publish-check # Package publication checks ```
🔌 MCP transports and config ```bash # Start MCP transports npx omni-skills mcp stdio npx omni-skills mcp stream npx omni-skills mcp sse npx omni-skills mcp stream --local # Local sidecar with filesystem tools # Configure MCP for any supported client npx omni-skills config-mcp --list-targets npx omni-skills config-mcp --target continue-workspace --transport stream --url http://127.0.0.1:3334/mcp npx 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 | Count | |:-------|:------| | 🧠 Native intake skills | **48** | | 📂 Active categories | **15** | | 📦 Fully backed bundles | **7** | | ✨ Curated derivatives | **32** in `skills_omni/` | ### 📦 Bundle Availability | Bundle | Skills | Members | |:-------|:-------|:--------| | 🧰 `essentials` | **4/4** ✅ | `find-skills` · `brainstorming` · `architecture` · `debugging` | | 🌐 `full-stack` | **5/5** ✅ | `frontend-design` · `api-design` · `database-design` · `omni-figma` · `auth-flows` | | 🎨 `design` | **5/5** ✅ | `frontend-design` · `omni-figma` · `design-systems-ops` · `accessibility-audit` · `design-token-governance` | | 🛡️ `security` | **4/4** ✅ | `security-auditor` · `vulnerability-scanner` · `incident-response` · `threat-modeling` | | ⚙️ `devops` | **5/5** ✅ | `docker-expert` · `kubernetes` · `terraform` · `observability-review` · `release-engineering` | | 🤖 `ai-engineer` | **7/7** ✅ | `rag-engineer` · `prompt-engineer` · `llm-patterns` · `eval-design` · `context-engineering` · `data-contracts` · `model-serving` | | 🔧 `oss-maintainer` | **4/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 > 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 # Automated tests npm run smoke # Full release preflight ```
📋 What the pipeline validates - ✅ Skill validation and metadata generation - ✅ Taxonomy normalization and recategorization tooling - ✅ Catalog and archive generation - ✅ Automated tests - ✅ API, MCP, and A2A boot paths - ✅ Archive verification - ✅ Package preflight with `npm pack --dry-run`
🔐 Release posture | 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-gated release flow | | 📦 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.
--- ## 📖 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/operations/RUNBOOK.md) | Build, serve, secure, and troubleshoot | ### 🏗️ For Architects | Doc | What You'll Learn | |:----|:-----------------| | 🗺️ [Agent-Native Roadmap](docs/architecture/AGENT-NATIVE-ROADMAP.md) | Architecture evolution and remaining areas | | 📐 [ADR-0001: Workspace Foundation](docs/architecture/ADR-0001-AGENT-NATIVE-WORKSPACE.md) | Core monorepo decision | | 🔬 [Codebase Analysis](docs/architecture/CODEBASE-ANALYSIS.md) | Runtime composition and system boundaries | | 🌐 [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 | | 🔌 [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 | | ✨ `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 | | 🌐 `packages/server-api/` | Read-only HTTP API | | 🔌 `packages/server-mcp/` | MCP server and local sidecar | | 🤖 `packages/server-a2a/` | A2A runtime and task orchestration | | 🖥️ `tools/bin/` | CLI entrypoints | | 📚 `tools/lib/` | Installer and UI helpers | | ⚙️ `tools/scripts/` | Validation, generation, release, and test scripts | > **ℹ️** `dist/` is intentionally versioned because the generated artifacts are part of the install, API, MCP, A2A, smoke, and release contract. --- ## 🤝 Contributing Omni Skills accepts native upstream skill intake under `skills/`. | Rule | Details | |:-----|:--------| | 📥 Native intake | May be rough, authored in any language | | ✨ Curated output | `skills_omni/` reserved for automation-authored Omni derivatives | | 🚫 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) --- ## 📄 License | Type | License | |:-----|:--------| | 💻 Code and tooling | [MIT License](LICENSE) | | 📝 Documentation and skill content | [CC BY 4.0](LICENSE-CONTENT) | ---
**Made with 🧠 by the Omni Skills Team** [⭐ Star this repo](https://github.com/diegosouzapw/omni-skills) · [🐛 Report a bug](https://github.com/diegosouzapw/omni-skills/issues) · [💬 Discussions](https://github.com/diegosouzapw/omni-skills/discussions) *If Omni Skills helps you build faster, consider giving it a ⭐ — it helps others discover the project!*