agentic-skills

🚀 The #1 Universal Skills CLI for AI Coding Agents

Browse all available skills at agenticskills.org

Install, manage, and sync AI agent skills from the terminal. Works with 15+ AI coding tools including Cursor, VS Code + Copilot, Claude Code, Windsurf, Gemini CLI, Aider, OpenCode, Codex CLI, Amp, Goose, Letta, Trae, Qoder, CodeBuddy, and Antigravity.


✨ What's New in v2.2.0

- 🔍 Interactive Search - Beautiful TUI search with @clack/prompts
- 🤖 15 AI Clients - Support for all major AI coding tools
- 🌐 Our Own Registry - Using marketplace.json as source of truth
- ⚡ All previous features from v2.1.0 (doctor, init, export, toggle, config, lock, import)

Installation

``bash

Use with npx (no installation needed)

npx agentic-skills add vercel-react-best-practices

Or install globally

npm install -g agentic-skills
`

🔒 Privacy First (Zero Telemetry)

Unlike other tools that collect telemetry to "rank" skills, Agentic Skills is 100% private.
- No tracking.
- No analytics.
- No data leaves your machine.

🩺 Quick Start

`bash

1. Diagnose your environment

npx agentic-skills doctor

2. Add a skill from our registry or skills.sh

npx agentic-skills add vercel-react-best-practices

3. Add directly to your AI Agents (Native Install)

npx agentic-skills add vercel-react-best-practices --native

4. Add from any GitHub repo

npx agentic-skills add user/repo --skill my-skill
`

📋 Commands

$3

| Command | Description |
|---------|-------------|
| add | Add a skill by name, URL, or local path |
| add --native | Direct install to all detected AI tools |
| list | List installed skills |
| list --registry | Browse available skills from registry |
| search | Search for skills (Full-text search) |
| update | Update all installed skills |
| remove | Remove a skill |
| manage | Interactive TUI for skill management |

$3

| Command | Description |
|---------|-------------|
| sync | Update AGENTS.md with installed skills |
| read | Read skill content to stdout (for AI agents) |
| export --all | Export skills to all detected AI tools |
| doctor | Diagnose environment and detect AI tools |

$3

| Command | Description |
|---------|-------------|
| init | Initialize project with skill support |
| create | Create a new skill from template |
| validate | Validate skill format and structure |

$3

| Command | Description |
|---------|-------------|
| enable | Enable a disabled skill |
| disable | Disable a skill without removing |
| toggle | Interactive skill enable/disable |
| lock | Generate lock file for reproducible installations |
| lock restore | Restore skills from lock file |
| import | Import skills from manifest file |
| config | Manage CLI configuration |

🩺 Doctor Command

Diagnose your environment and detect installed AI coding tools:

`bash
npx agentic-skills doctor
`

Output:
`
🩺 Agentic Skills Doctor

🔍 Detected AI Coding Tools:
✅ 🖱️ Cursor (v1.2.3)
Skills path: .cursor/rules
✅ 🤖 Claude Code
Skills path: .claude/skills

📂 Environment Summary:
📁 Project: /path/to/project
📦 Skills Directory: ✓ exists
📄 AGENTS.md: ✓ exists
🔢 Installed Skills: 5

💡 Recommendations:
• Run 'npx agentic-skills sync' to update AGENTS.md
`

📤 Multi-Agent Export

Export skills to all your AI coding tools at once:

`bash

Export to all detected tools

npx agentic-skills export --all

Export to specific tools

npx agentic-skills export --cursor --claude --copilot

Preview without changes

npx agentic-skills export --all --dry-run
`

🔒 Lock Files

Create reproducible skill installations (like package-lock.json):

`bash

Generate lock file

npx agentic-skills lock

Restore from lock file

npx agentic-skills lock restore

Check lock file status

npx agentic-skills lock check
`

📥 Bulk Import

Import multiple skills from a manifest file:

`bash

Import from skills.json

npx agentic-skills import skills.json

Generate manifest from installed skills

npx agentic-skills import --generate
`

skills.json format:
`json
{
"skills": [
{ "url": "https://github.com/user/repo/skills/my-skill" },
{ "id": "vercel-react-best-practices" }
]
}
`

🌐 Cross-Registry Support

We support fetching skills from both our registry and skills.sh. If a skill isn't found in our database, we automatically attempt to resolve it through the industry-standard well-known registry path.

⚙️ Configuration

Manage global CLI settings:

`bash

Show all settings

npx agentic-skills config list

Set a value

npx agentic-skills config set defaultScope universal

Interactive editor

npx agentic-skills config edit
`

Available settings:
- defaultScope - Where to install skills (universal|global|project)
- autoSync - Auto-sync AGENTS.md after install/remove
- registryUrl - Custom registry URL
- cacheEnabled - Enable registry caching
- cacheTTL - Cache time-to-live in hours

🌐 Web Interface

Browse skills through our beautiful web interface:

👉 agenticskills.org

Or run it locally:

`bash
npx agentic-skills serve
``

Features:
- Skills browser with grid layout
- SEO-friendly URLs (/skill/skill-name)
- Search and filter
- Mobile responsive

🎯 Supported AI Tools

| Tool | Detection | Export |
|------|-----------|--------|
| Cursor | ✅ | ✅ |
| VS Code + Copilot | ✅ | ✅ |
| Claude Code | ✅ | ✅ |
| Windsurf | ✅ | ✅ |
| Aider | ✅ | ✅ |
| Gemini CLI | ✅ | ✅ |
| OpenCode | ✅ | ✅ |
| OpenAI Codex CLI | ✅ | ✅ |

Related

- Ralphy.sh VS Code Extension - GUI-based skill management

License

MIT