📦 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

🛠️ 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": "@c