Omni Skills

I try every AI tool. My skills scattered everywhere. This unifies them.

🎉 v1.5.0 is out — automatic pre-sync backups, session-aware consent, a smaller core CLI (sync, setup, doctor, restore, update, help), and secondary commands moved under manage. Read the changelog →

A CLI + MCP server that takes the skills you've collected across all your AI coding tools and unifies them into a single canonical store. Then it syncs them into every tool you use — Claude, Codex, Kimi, Gemini, Cursor, Zed, Cline, Z.AI, and anything else that follows.

If you find this useful, please consider starring the repo — it helps us reach the criteria for inclusion in homebrew/core so users can run brew install omni-skills without the brew tap step.

---

The Problem This Solves

Every new AI coding tool wants its own instruction file, skill directory, and configuration. The result is fragmentation:

Mess	What I Found
Duplicate AGENTS.md files	70 copies of the same template across 16 projects
Orphaned skills	15 skills hidden in a tool's skills directory, invisible to other tools
Marketplace dumps	203 generic skills cloned into a project
Stale templates	Old project-only rules in every repo
Private skills leaking	Project-specific skills mixed with generic skills
Iron laws drifting	A 98KB instruction file manually copy-pasted between repos
New tool = manual setup	Every new AI tool meant copying config files one by one

Omni Skills is a single-purpose tool: find all your skills, put them in one place, and wire them into every AI tool you use.

# One canonical store. Every tool sees it.
omni-skills sync all   # Claude, Codex, Kimi, Gemini, Cursor, Cline, Zed, etc.

---

Install

Choose one of the following. Native binaries do not require Node.js.

# macOS / Linux
brew tap moatazhamada/tap
brew install omni-skills

# Windows
winget install omni-skills

# npm
npm install -g ai-omni-skills

See docs/install.md for details on why brew tap is needed and how each distribution channel works.

---

Quick Start

You need your own private repository for your skills. This toolkit does not include skills — it connects the skills you already have to every AI tool you use.

# 1. Run the auto-scan setup
omni-skills setup
# Auto-detects your installed AI tools, finds your skill directories,
# suggests cleanup, and generates ~/.config/skills/config.json

# 2. Sync to every AI tool
omni-skills sync all

# 3. Verify health
omni-skills doctor

# 4. Run the verification suite
node verify.js

Override defaults without questions:

omni-skills setup --public=~/my-skills-public --private=~/my-skills-private
omni-skills setup --toolkit=/path/to/this/repo

---

What It Does

Tier	What	Mechanism
A	SKILL.md skills + shared instructions + MCP server	Symlinks + local MCP server exposing list_skills / read_skill
B	Hooks	Canonical hooks transpiled into each tool's native hook format
C	Other assets	Symlinks from your config repo to per-tool paths