Agent Skills CLI

Install, update and manage AI agent skills across 45 coding agents from one command line.

skills finds skills in the agentskills.in marketplace, in GitHub and private Git repositories, and in npm packages. It installs them into the skill directory of each agent you choose, such as Claude Code, Cursor, GitHub Copilot or Windsurf.

The marketplace indexes over 222,000 skills from more than 21,000 authors.

Highlights

• Every source. Marketplace, GitHub, private Git (SSH or token), and npm registries.
• 45 agents. One install can write to every agent you select, or to all of them with --all.
• Scanned before install. Every command that installs skills checks them for security issues before copying them.
• Built for teams. Project config with .skillsrc, lockfile installs with skills frozen, and quality scoring.

Contents

• Installation
• Quick start
• Commands
• Installing skills
• MCP servers, subagents and plugins
• Security
• Context budget and token cost
• Supported agents
• Configuration
• Environment variables and telemetry
• Creating a skill
• Contributing
• License

Installation

npm install -g agent-skills-cli

Requires Node.js 18 or later. Run skills --version to confirm the install.

Quick start

# Search the marketplace and pick skills interactively
skills search python

# Install a skill to the agents detected on this machine
skills install @facebook/verify

# Install to specific agents
skills install @facebook/verify -a claude,cursor

# See what is installed, then keep it up to date
skills list
skills update --all

Commands

Command	What it does
skills search <query>	Find skills in the marketplace. Add -i for an interactive picker.
skills install	Install from the marketplace, a GitHub repo, a Git URL, an npm package or a local folder. skills add is an alias.
skills list	List discovered skills. Use --table for token costs or --json for scripts.
skills check	Show installed skills with their source and version.
skills update [skills...]	Update skills from their source. Use --all, and --prune to remove stale ones.
skills remove [skills...]	Remove skills. Use -a to remove from one agent only.
skills doctor	Diagnose the setup. Add --deep to detect conflicting skills.
skills audit [path]	Security-scan installed skills, or a folder you specify.
skills score	Score a skill's quality from 0 to 100.
skills budget -b <tokens>	Load only the skills that fit a context budget.
skills submit-repo <owner/repo>	Submit a GitHub repository for marketplace indexing.

Run skills --help or skills <command> --help for the full list of commands and options.

Install options