
skills
CLI开放 Agent Skills 生态的包管理器:一条命令从 GitHub 等来源把技能安装到 Claude Code、Codex、Cursor 等数十种 agent,并支持搜索、更新与卸载。Vercel Labs 出品。
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:
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 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 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:
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:
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.
Lock File Content Hash
skills-lock.json (version 2) records a computedHash for each project skill. The hash covers the files the CLI installs into .agents/skills/<name>, so list, check, and install --frozen-lockfile can compare it with what is on disk. Tools that check skills themselves can compute the same value:
- Collect every file in the skill folder. Leave out
metadata.jsonfiles and the.git,__pycache__, and__pypackages__folders, because the installer does not copy them. A symlink counts as the file or folder it points to. Leave out a symlink that is broken, loops, or points outside the skill folder. - Give each file a path relative to the skill folder, with
/as the separator. - For a text file (a file that contains no NUL byte), replace each CRLF with LF. Do not change binary files.
- Sort the files by the UTF-8 bytes of their paths. Do not use a locale-aware sort.
- For each file in that order, feed
path, a NUL byte, the content length in bytes as decimal ASCII, a NUL byte, and the content into one SHA-256. The content length is counted after step 3. - The hash is the lowercase hex digest.
Test vectors:
| Files | computedHash |
|---|---|
| none | e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 |
SKILL.md = # hi\n | 93c36952d8843b33e68ae970ebabcc03e1687c9bb0dd1ecaf357060318952f55 |
SKILL.md = a\n, docs/b.md = b\n | b22c4d22aa319d2924312fa18fcbfedc88fa89c74dbd8f298c683e1caf7b7f24 |
The last vector equals printf 'SKILL.md\0002\000a\ndocs/b.md\0002\000b\n' | sha256sum.
For a Git source, the entry also records the commit the skill came from. skills install (with or without --frozen-lockfile) fetches that commit, not the latest commit on ref, so a restore still matches computedHash after the source repository changes. skills update moves commit forward, and it adds a commit to an older entry that has none. The server must allow fetching a commit by its SHA. GitHub and GitLab allow this.
A skill installed with --rename is hashed as it is installed: its SKILL.md has the new name in the frontmatter, so the hash differs from the upstream folder's hash.
A version 1 lock is upgraded when it is read, without network access. An installed skill whose files still match its version 1 hash gets a new hash computed from those files. Any other entry gets an empty hash, because there is nothing trusted to check it against. skills install fetches those skills again and records new hashes, and --frozen-lockfile fails until that is done.
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
- Programmatic API: install and manage skills from your own tools with
import { installSkills } from 'skills'
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.
Related Links
License
This project is licensed under the MIT License.
相關資源

CLI-Anything
CLI港大数据智能实验室(HKUDS)出品:通过 Claude Code、Codex 等 agent 的插件或技能,为 GIMP、Blender、LibreOffice 等软件生成 agent 可调用的命令行;配套的 CLI-Hub 包管理器(cli-hub)可检索、安装社区现成的 CLI。需要 Python 3.10+。
HKUDS/CLI-Anything62.3k
Pi Coding Agent
CLI极简、可扩展的终端 AI Agent:可让它自己编写提示词模板、技能、扩展与主题,支持 print / JSON / RPC 模式供脚本调用,并提供 TypeScript SDK。需要 Node.js 22.19+。
earendil-works/pi123k
Bun
CLI一体化的 JavaScript/TypeScript 工具链:单个 bun 可执行文件同时是 Node.js 兼容运行时、包管理器、测试运行器与脚本运行器,安装依赖与跑测明显更快。
oven-sh/bun96.8k
uv
CLIAstral 出品的 Python 包与项目管理器,用 Rust 编写、速度极快,可替代 pip、pipx、poetry、pyenv 等;支持锁文件与多版本 Python,uvx 可免安装直接运行 Python 工具。
astral-sh/uv92.5k
Homebrew
CLImacOS 与 Linux 上的包管理器:agent 可以用 brew install 安装命令行工具和桌面应用(cask),也可以用 brew bundle 按 Brewfile 批量还原开发环境。
Homebrew/brew50.4k
Find Skills
Skill当用户问「有没有做某事的技能」时,用 skills CLI 搜索 skills.sh 生态,推荐并安装合适的技能。Vercel Labs 维护,与 skills CLI 同仓库发布。
vercel-labs/skills40.3k