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.

<p> <a href="https://vercel.com/labs#labs-products"><img alt="Vercel Labs Product" src="https://img.shields.io/badge/LABS-PRODUCT-0a0a0a.svg?style=for-the-badge&logo=Vercel&labelColor=000000" height="28"></a> <a href="https://www.npmjs.com/package/skills"><img alt="npm version: skills" src="https://img.shields.io/npm/v/skills.svg?style=for-the-badge&labelColor=000000" height="28"></a> <a href="https://github.com/vercel-labs/skills/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/github/license/vercel-labs/skills.svg?style=for-the-badge&labelColor=000000" height="28"></a> <a href="https://www.npmjs.com/package/skills"><img alt="npm downloads per month: skills" src="https://img.shields.io/npm/dm/skills.svg?style=for-the-badge&labelColor=000000&label=npm%20downloads" height="28"></a> <a href="https://skills.sh/vercel-labs/skills"><img alt="skills.sh" src="https://skills.sh/b/vercel-labs/skills?style=for-the-badge" height="28"></a> </p>

Install a Skill

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

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.

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](docs/commands.md#skills-add) 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 <source>@<skill>` | 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](docs/commands.md) or run `npx skills --help` for examples and options. Experimental commands are listed [below](#experimental-features).

## 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

<details> <summary>Commands prefixed with <code>experimental_</code> are previews. Their names, options, and behavior may change or be removed in any release without notice.</summary>

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:

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.

</details>

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

npx skills init my-skill

Edit the generated SKILL.md with instructions for your agent. See creating and sharing skills for the format and discovery rules.

Documentation

CLI reference: installation, command examples, and experimental features
Supported agents: agent names, skill directories, and compatibility
Creating skills: frontmatter, repository layouts, and plugins
Troubleshooting and configuration: common problems, environment variables, and telemetry

Telemetry

The CLI collects anonymous usage data. Set DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1 to disable telemetry and security-audit requests. See what is collected.

License

This project is licensed under the MIT License.