Agent Skills CLI 🚀
One CLI. 175,000+ skills. 45 AI agents.
Install skills from the world's largest marketplace and sync them to 45 AI agents including Cursor, Claude Code, GitHub Copilot, Windsurf, Cline, Gemini CLI, Zed, and more — all with a single command.
What's new in v1.1.9: -a now accepts comma-separated agent lists (-a claude,cursor), unknown agent names show a clear error instead of crashing on undefined lookup. Thanks to @10432mztn for the fix.
🌐 Website: agentskills.in
npm install -g agent-skills-cli
skills install @anthropic/xlsx
✨ Features
- 175,000+ Skills — Access the largest collection of AI agent skills
- 42 AI Agents — Cursor, Claude, Copilot, Windsurf, Cline, Gemini CLI, Zed, and 35+ more
- FZF Interactive Search — Real-time search with keyboard navigation:
skills search -i
- Conflict Detection — Find contradictions and overlaps across skills:
skills doctor --deep
- Context Budget — Smart token-aware skill selection for your project:
skills budget -b 8000
- Skill Diff — Section-aware comparison of two skills:
skills diff A B
- Frozen Installs — Deterministic lockfile-based installs (like
npm ci): skills frozen
- Skill Compose — Merge, chain, or conditionally combine skills:
skills compose A B -o C
- Skill Testing — 10 built-in quality assertions + custom tests:
skills test --all
- Sandbox Preview — Quality + conflicts check before install:
skills sandbox @owner/repo
- Watch Mode — Auto-sync skills to agents on file changes:
skills watch
- Skill Splitter — Split large skills into focused sub-skills:
skills split my-skill
- Benchmarking — Compare skill quality across your collection:
skills bench --all
- Private Git Repos — GitLab, Bitbucket, SSH, self-hosted Git:
skills install git@host:team/repo
- npm Packages — Install from npm registries:
skills install npm:@scope/package
.skillsrc Config — Enterprise config files for custom registries, tokens, and defaults- Quality Scoring — 4-dimension skill scoring (0–100):
skills score
- Lock File Tracking — Track all installations in
~/.skills/skills.lock
- Platform Targeting — Install to specific platforms with
-t claude,cursor
📦 Installation
npm install -g agent-skills-cli
Requirements: Node.js 18+
🚀 Quick Start
# ⭐ Install a skill (auto-detects platforms)
skills install @facebook/verify
# ⭐ Install from a GitHub repo
skills add vercel-labs/agent-skills
# ⭐ Install from private Git (auto-detects credentials)
skills install git@gitlab.com:team/internal-skills.git
skills install https://git.company.com/team/skills --token $GIT_TOKEN
# ⭐ Install from npm registry
skills install npm:@company/skills
skills install npm:@company/skills --registry https://npm.company.com
# Install to specific platforms
skills install @facebook/verify -a claude,cursor
# Install to ALL 42 platforms at once
skills install @lobehub/typescript --all
# Install globally (home directory)
skills install pdf -g -a claude
# Install specific skill from repo
skills add anthropic/skills@xlsx
# List skills in a repo
skills add owner/repo --list
# Remove installed skills
skills remove xlsx
# Check installed skills
skills check
# Update skills from source
skills update --all
# Search and install skills interactively (multi-select)
skills search python
# Search + auto-install all results to an agent
skills search python -a claude -y
# Search + install to specific agents
skills search react -a cursor claude
🌐 Browse 175,000+ skills at agentskills.in/marketplace
🛠️ Commands
Core Commands
| Command | Description |
|---|
skills install <name> | Install a skill from marketplace |
skills add <source> | Install from Git repo (owner/repo or URL) |
skills search <query> | Search and install skills (multi-select) |
skills search -i | FZF-style interactive search with keyboard navigation |
skills search <query> -a <agent> -y | Search and bulk-install all results to an agent |
skills check | Check installed skills with source and version info |
skills update | Update skills from their source repos |
skills remove | Remove installed skills (interactive multi-select) |
skills score [path] | Score skill quality (0–100, grades F–A) |
skills submit-repo <repo> | Submit a GitHub repo for marketplace auto-indexing |
skills doctor | Diagnose issues (--deep for conflict detection) |
Power Tools (v1.1.4)
| Command | Description |
|---|
skills budget -b <tokens> | Smart context budget — load only relevant skills within limit |
skills diff <A> <B> | Section-aware skill comparison |
skills compose <skills...> | Merge/chain/conditional skill composition |
skills test [skills...] | Run quality assertions against skills |
skills frozen | Deterministic install from lockfile |
skills sandbox <source> | Preview skill quality + conflicts before installing |
skills watch [dir] | Auto-sync skills to agents on file changes |
skills split <skill> | Split large skills into focused sub-skills |
skills bench [skills...] | Benchmark and compare skill quality |
Install Options
skills install @facebook/verify # Auto-detect platforms (prompts)
skills install @facebook/verify -a cursor # Install to Cursor only
skills install @lobehub/typescript -a cursor,claude # Install to multiple
skills install @facebook/verify --all # Install to all 45 agents
skills install pdf -g -a claude # Install globally (~/.claude/skills/)
skills install -s verify -a cursor # Install by skill name
skills add @facebook/verify -a cursor # 'add' is an alias for 'install'
# Bulk install all skills from a repo (no prompts)
skills install @ComposioHQ/awesome-claude-skills -a claude -y
skills install @github/awesome-copilot -a cursor,claude -y
skills install @owner/repo --all -y # All skills to all agents
Git URL Install (skills add)
skills add owner/repo # GitHub shorthand
skills add owner/repo@skill-name # Install specific skill directly
skills add https://github.com/user/repo # Full URL
skills add https://gitlab.com/org/repo # GitLab
skills add owner/repo --list # List skills in repo
skills add owner/repo -s skill-name # Install specific skill
skills add owner/repo -y -g # Non-interactive, global
skills add owner/repo -a claude -y # Install ALL skills to claude (no prompt)
Private Git Repos
# SSH (auto-detects SSH keys)
skills install git@github.com:team/private-repo.git
skills install git@gitlab.com:team/internal-skills.git
# HTTPS with token
skills install https://git.company.com/team/repo --token=xxx
# Token from environment variable
GITLAB_TOKEN=xxx skills install https://gitlab.com/team/repo
BITBUCKET_TOKEN=xxx skills install https://bitbucket.org/team/repo
# Bitbucket
skills install https://bitbucket.org/team/skills-repo
Auth resolution order: --token flag → env vars (GH_TOKEN, GITLAB_TOKEN, BITBUCKET_TOKEN, GIT_TOKEN) → SSH keys → git credential helper → .netrc
npm Packages
# Public npm packages
skills install npm:chalk
skills install npm:@anthropic/skills
# Scoped package with version
skills install npm:@company/skills@1.1.2
# Private npm registry
skills install npm:@company/skills --registry https://npm.company.com
Other Commands
skills init <name> # Create new skill from template
skills validate <path> # Validate a SKILL.md file
skills export # Export skills to agents
skills sync # Sync to Antigravity workflows
skills info # Show installation status
Quality Scoring
skills score ./my-skill # Score a skill (0–100, grade F–A)
skills score ./my-skill --verbose # Show individual check details
skills score ./my-skill --json # Machine-readable output
Dimensions: Structure (30%), Clarity (30%), Specificity (30%), Advanced (10%)
Submit Repos to Marketplace
skills submit-repo Jeffallan/claude-skills # Auto-index all skills in repo
skills submit-repo vercel-labs/agent-skills # Skills appear on marketplace
🤖 Supported Platforms (45 Agents)
| Platform | Project Dir | Global Dir |
|---|
| Cursor | .cursor/skills/ | ~/.cursor/skills/ |
| Claude Code | .claude/skills/ | ~/.claude/skills/ |
| GitHub Copilot | .github/skills/ | ~/.github/skills/ |
| OpenAI Codex | .codex/skills/ | ~/.codex/skills/ |
| Windsurf | .windsurf/skills/ | ~/.codeium/windsurf/skills/ |
| Cline | .cline/skills/ | ~/.cline/skills/ |
| Gemini CLI | .gemini/skills/ | ~/.gemini/skills/ |
| Zed | .zed/skills/ | ~/.config/zed/skills/ |
| Antigravity | .agent/skills/ | ~/.gemini/antigravity/skills/ |
| OpenCode | .opencode/skill/ | ~/.config/opencode/skill/ |
+32 more agents: Amp, Kilo, Roo, Goose, CodeBuddy, Continue, Crush, Clawdbot, Droid, Kiro, MCPJam, Mux, OpenHands, Pi, Qoder, Qwen Code, Trae, Zencoder, Neovate, Command Code, Ara, Aide, Alex, BB, CodeStory, Helix AI, Meekia, Pear AI, Adal, Pochi, Sourcegraph Cody, Void AI
⚙️ Configuration (.skillsrc)
Create a .skillsrc or .skillsrc.json file in your project root or home directory to configure private sources and defaults:
{
"sources": [
{
"name": "company-gitlab",
"type": "git",
"url": "https://gitlab.company.com",
"auth_env": "COMPANY_GIT_TOKEN"
},
{
"name": "company-npm",
"type": "npm",
"registry": "https://npm.company.com",
"scope": "@company"
}
],
"defaults": {
"agent": "cursor",
"global": false
}
}
Config is loaded from: project .skillsrc → home ~/.skillsrc (first found wins).
🔐 Environment Variables
| Variable | Purpose |
|---|
GH_TOKEN / GITHUB_TOKEN | GitHub private repo authentication |
GITLAB_TOKEN / GL_TOKEN | GitLab private repo authentication |
BITBUCKET_TOKEN / BB_TOKEN | Bitbucket private repo authentication |
GIT_TOKEN | Generic Git authentication (any host) |
DISABLE_TELEMETRY / DO_NOT_TRACK | Opt out of anonymous telemetry |
Telemetry is automatically disabled in CI environments.
📚 Creating Skills
Create a SKILL.md file:
---
name: my-skill
description: What this skill does
---
# Instructions
Your skill instructions here...
Then install locally:
skills validate ./my-skill
skills export
🔗 Links
👤 Author
Karanjot Singh
📄 License
MIT © Karanjot Singh
