README

skills

The CLI for the open agent skills ecosystem.

Agent skills are reusable instructions that teach coding agents how to perform tasks,
from reviewing code to working with a library. Discover skills at skills.sh.


Supports OpenCode, Claude Code, Codex, Cursor, and 75 more.



  
  
  
  
  


 Install a Skill

Requires Node.js 22.20 or later. Run this from your project:

bash
npx skills add vercel-labs/agent-skills


Choose the skills and coding agents to install to. Skills are installed to the current
project by default; add -g to make them available across projects.

bash
 Choose one skill and agent
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code

 Browse available skills
npx skills find


See the installation reference for source formats,
private repositories, and all options.

 Other Commands

| Command                           | Description                      |
| --------------------------------- | -------------------------------- |
| npx skills find [query]         | Search for skills                |
| npx skills list                 | List installed skills            |
| npx skills use @ | Use one skill without installing |
| npx skills check                | Check for available updates      |
| npx skills update [skills...]   | Update installed skills          |
| npx skills remove [skills...]   | Remove installed skills          |
| npx skills init [name]          | Create a skill template          |

Read the CLI reference or run npx skills --help for examples and options. Experimental commands are listed below.

 Use a Skill Without Installing

Generate a prompt for a skill, or launch a supported coding agent with it:

bash
npx skills use vercel-labs/agent-skills@web-design-guidelines --agent claude-code


Omit --agent to print the prompt instead. See skills use.

 Experimental Features


Commands prefixed with experimental_ are previews. Their names, options, and behavior may change or be removed in any release without notice.

| Command                           | Description                                               |
| --------------------------------- | --------------------------------------------------------- |
| npx skills experimental_sync    | Sync skills shipped by npm dependencies into your project |
| npx skills experimental_install | Restore project skills recorded in skills-lock.json     |

Some npm packages bundle instructions for your agent alongside their code. Sync links them into your project so they update with the dependency, and also installs skill packs declared in package.json:

bash
npm install -D skills agent-browser
npx skills experimental_sync -y


See the experimental commands reference for options, the skills field, and the RFC behind it.



 Supported Agents

The CLI detects installed agents and lets you choose where skills are installed.
See all supported agents, installation paths, and compatibility.

 Creating Skills

bash
npx skills init my-skill


Edi

Top issues

Latest release

Changelog

- fix(installer): confine symlinks nested inside linked directories (2652)
- Install pinned public pack skills from their original repo (2651)

 Contributors

@quuu