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

# 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

# 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

Core Commands

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

Agent Integration

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

Project Setup

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

Advanced

| Command | Description | |---------|-------------| | enable <skill> | Enable a disabled skill | | disable <skill> | 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 <file> | Import skills from manifest file | | config | Manage CLI configuration |

🩺 Doctor Command

Diagnose your environment and detect installed AI coding tools:

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:

# 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):

# 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:

# Import from skills.json
npx agentic-skills import skills.json

# Generate manifest from installed skills
npx agentic-skills import --generate

skills.json format:

{
  "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:

# 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:

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