Agent Skills CLI 🚀

May 17, 2026 · View on GitHub

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

Website: agentskills.in
Marketplace: agentskills.in/marketplace
Documentation: agentskills.in/docs
CLI GitHub: github.com/Karanjot786/agent-skills-cli
Website GitHub: github.com/Karanjot786/agent-skills-UI
npm: npmjs.com/package/agent-skills-cli

👤 Author

Karanjot Singh