Skills CLI

> Sync AI skills across all your agent tools with one command

Supports Cursor, Claude Code, Gemini CLI, GitHub Copilot, OpenCode, Windsurf, and more.

Installation •
Quick Start •
Commands •
Supported Tools •
Configuration •
FAQ

---

Why Skills CLI?

The problem: You create a skill for Cursor, but need it in Claude Code and Gemini too. Manually copying? Tedious. What if you update it? Copy again to every tool.

The solution: One source of truth. Add once, sync everywhere.

``bash
skills source add https://github.com/user/repo/tree/main/skills/react --remote
skills target add cursor
skills target add claude
skills sync # Done! Skills synced to all targets
`

$3

| Feature | Description |
|---------|-------------|
| 🔄 Multi-source | Pull from GitHub, GitLab, Bitbucket, or local folders |
| 🎯 Multi-target | Sync to Cursor, Claude, Gemini, Copilot, or any custom directory |
| 📂 Subdirectory support | Install specific skills from large mono-repos |
| 🏷️ Rename skills | Use --name to avoid conflicts |
| 🔍 Diagnostics | doctor command checks your setup |
| ⚡ Fast | Built with Bun for maximum performance |

---

Installation

$3

- Bun runtime (required - uses Bun shell)
- Git (for remote sources)

$3

`bash
bun install -g @dhruvwill/skills-cli
`

$3

`bash


Clone the repository

git clone https://github.com/dhruvwill/skills.git
cd skills

Install dependencies

bun install

Link globally

bun link
`

$3

`bash
skills --version
skills doctor
`

$3

Update to the latest version with:

`bash
skills self-update
`

---

Quick Start

`bash


1. Add a skill from GitHub

skills source add https://github.com/vercel-labs/agent-skills/tree/main/skills/react-best-practices --remote

2. Add your targets (path auto-detected for known tools)

skills target add cursor
skills target add claude

3. Sync!

skills sync
`

Check your setup anytime:

`bash
skills status # Overview of skills & targets
skills doctor # Diagnose issues
`

---

How It Works

`
┌─────────────────────────────────────────────────────────────┐
│ Remote Sources │
│ GitHub • GitLab • Bitbucket • Self-hosted Git │
└─────────────────────────────────────────────────────────────┘
│
▼ skills source add
┌─────────────────────────────────────────────────────────────┐
│ ~/.skills/store/ │
│ │
│ react-best-practices/ my-custom-skill/ local-skill/ │
│ │
│ ⬆ Single Source of Truth ⬆ │
└─────────────────────────────────────────────────────────────┘
│
▼ skills sync
┌─────────────────────┼─────────────────────┐
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ Cursor │ │ Claude Code │ │ Gemini CLI │
│ ~/.cursor/ │ │ ~/.claude/ │ │ ~/.gemini/ │
│ skills/ │ │ skills/ │ │ skills/ │
└───────────────┘ └───────────────┘ └───────────────┘
`

---

Commands

$3

| Command | Description |
|---------|-------------|
| skills status | Show overview of skills, targets & sync state |
| skills doctor | Diagnose configuration issues |
| skills sync | Push skills from store to all targets |
| skills update | Refresh all skills from origin |
| skills self-update | Update the CLI to the latest version |

$3

| Command | Description |
|---------|-------------|
| skills source list | List all registered skills |
| skills source add --remote | Add a skill from Git repository |
| skills source add --local | Add a skill from local folder |
| skills source add --remote --name | Add with custom name |
| skills source remove | Remove a skill by name |

$3

| Command | Description |
|---------|-------------|
| skills target list | List all targets with sync status |
| skills target available | Show predefined targets with paths |
| skills target add | Add a predefined target (auto-detects path) |
| skills target add | Add a custom target with specific path |
| skills target remove | Remove a target |

---

Supported Tools

Run skills target available to see all supported tools:

| Tool | Path |
|------|------|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
| VS Code / Copilot | ~/.copilot/skills/ |
| OpenCode | ~/.config/opencode/skills/ |
| Windsurf | ~/.windsurf/skills/ |
| Antigravity | ~/.gemini/antigravity/skills/ |

$3

`bash


Just use the name - path is auto-detected


skills target add cursor
skills target add claude
skills target add gemini
`

$3

`bash


For tools not in the list, specify the path


skills target add mytool ~/path/to/mytool/skills
`

---

Adding Skills

$3

`bash


Full repository

skills source add https://github.com/owner/repo --remote

Specific subdirectory (great for mono-repos)

skills source add https://github.com/owner/repo/tree/main/skills/my-skill --remote

With custom name (to avoid conflicts)

skills source add https://github.com/owner/repo --remote --name my-custom-name
`

$3

`bash
skills source add https://gitlab.com/owner/repo --remote
skills source add https://gitlab.com/owner/repo/-/tree/main/skills/my-skill --remote
`

$3

`bash
skills source add https://bitbucket.org/owner/repo --remote
skills source add https://bitbucket.org/owner/repo/src/main/skills/my-skill --remote
`

$3

`bash
skills source add ./my-local-skills --local
skills source add /absolute/path/to/skills --local
`

---

Configuration

$3

`
~/.skills/
├── store/ # Central repository for all skills
│ ├── react-best-practices/ # Each skill in its own folder
│ │ ├── SKILL.md
│ │ └── rules/
│ └── my-custom-skill/
│ └── SKILL.md
└── config.json # Registry of sources and targets
`

$3

Each skill should follow this structure:

`
skill-name/
├── SKILL.md # Main skill definition (required)
├── AGENTS.md # Agent behavior (optional)
├── rules/ # Additional rules (optional)
│ ├── rule-1.md
│ └── rule-2.md
└── metadata.json # Skill metadata (optional)
`

$3

Located at ~/.skills/config.json:

`json
{
"sources": [
{
"type": "remote",
"url": "https://github.com/owner/repo/tree/main/skills/my-skill",
"name": "my-skill"
},
{
"type": "local",
"path": "/home/user/my-skills",
"name": "my-local-skill"
}
],
"targets": [
{
"name": "cursor",
"path": "/home/user/.cursor/skills"
},
{
"name": "claude",
"path": "/home/user/.claude/skills"
}
]
}
`

---

FAQ

$3

Skills CLI provides:
- Single source of truth - Update once, sync everywhere
- Git integration - Pull updates from remote repos with skills update
- Subdirectory support - Install specific skills from large mono-repos
- Status tracking - Know which targets are synced or outdated
- Auto-detection - No need to remember paths for common tools

$3

The contents of ~/.skills/store/ are copied to all registered target directories, maintaining the folder structure:

`
~/.skills/store/my-skill/ → ~/.cursor/skills/my-skill/
→ ~/.claude/skills/my-skill/
→ ~/.gemini/skills/my-skill/
`

$3

Use the --name flag when adding skills:

`bash


Two different "utils" skills from different repos


skills source add https://github.com/user1/repo --remote --name user1-utils
skills source add https://github.com/user2/repo --remote --name user2-utils
`

$3

`bash
skills update # Pulls latest from all remote sources
skills sync # Pushes to all targets
`

$3

Yes! Just specify the path:

`bash
skills target add mytool ~/path/to/mytool/skills
`

---

Common Issues

$3

Install Git from git-scm.com or via your package manager.

$3

Either remove it first or use --name to give it a different name:

`bash
skills source remove old-skill
skills source add --remote

Or use a different name


skills source add --remote --name new-name
`

$3

The target isn't in the predefined list. Specify the path:

`bash
skills target add mytool ~/path/to/skills
`

$3

`bash
skills doctor # Run diagnostics
skills status # Check current state
skills target available # See predefined targets
skills --help # Show all commands
`

---

Contributing

`bash
git clone https://github.com/dhruvwill/skills.git
cd skills
bun install
bun test
``

Links

- npm: npmjs.com/package/@dhruvwill/skills-cli
- GitHub: github.com/dhruvwill/skills

---

License

MIT