skills – 面向 Open‑Agent Skills 生态系统的命令行工具

它是什么 – skills 是一个命令行工具（通过 npx 或 npm 安装），可让您发现、安装、更新和运行 agent skills。技能是为编程助手（Claude Code、Cursor、Codex、OpenCode 等）定义在 SKILL.md 文件中的小型可复用指令集。

为什么重要 – 现代 AI 驱动的编程助手可以通过自定义提示进行扩展。skills 提供了一种统一的工作流程，可从任何 Git 仓库（GitHub、GitLab、Azure Repos 或直接 URL）获取这些提示包，将其放置在目标代理期望的位置，甚至可以使用生成的提示交互式启动代理。

核心概念

概念	解释
技能	包含带有 YAML front-matter（`name`、`description`）的 `SKILL.md` 文件以及代理将遵循的提示文本的目录。
代理	您想要扩展的 AI 编程助手（例如 `claude-code`、`cursor`、`opencode`）。CLI 知道每个代理存储其技能文件的位置。
范围	技能可以安装为项目本地（`./<agent>/skills/`）或全局（`~/<agent>/skills/`）。
来源	技能从任何 Git 仓库（GitHub 简写、完整 URL、GitLab、Azure、SSH 或本地文件夹）或直接下载 URL（zip/tar）中拉取。

典型工作流程

查找技能 – 浏览 https://skills.sh 上的公共目录或本地搜索：
```
npx skills find web‑design
```
安装 – 将技能拉取到所需的代理中：
```
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code -g -y
```
-g 使其成为全局，-a 选择代理，-y 跳过提示。
无需安装即可使用 – 生成提示并将其直接传递给代理：
```
npx skills use vercel-labs/agent-skills@web-design-guidelines | claude
```
更新 – 刷新已安装的技能到最新版本：
```
npx skills update -y
```

移除 – 清理不需要的技能：

npx skills remove web-design-guidelines -a claude-code

主要命令

命令	功能
`skills add <source>`	从仓库或 URL 安装一个或多个技能。支持 `--skill`、`--agent`、`--global`、`--copy` 等。
`skills use <source>`	解析技能，输出生成的提示，或使用 `--agent` 交互式启动选定的代理。
`skills list` (`ls`)	显示当前安装的所有技能（项目或全局）。
`skills find [query]`	在发现的技能中进行交互式或关键字搜索，可选择限制在某个 GitHub 所有者。
`skills update [skills…]`	拉取已安装技能的更新版本；可以限定范围（`-g`、`-p`）或以非交互方式运行（`-y`）。
`skills remove [skills…]`	删除已安装的技能；标志可让您针对特定代理、范围或删除所有内容。
`skills init [name]`	为编写自己的技能搭建新的 `SKILL.md` 模板。

支持的代理（摘录）

CLI 支持 75+ 个代理，从流行的如 claude-code、cursor、codex、opencode 到许多社区维护的代理（例如 aider-desk、astrbot、kilo、zcode）。每个代理都有一个预定义的项目和全局目录，CLI 在其中放置符号链接（默认）或技能文件的副本。

安装与使用

# 一次性使用 – 无需永久安装
npx skills add vercel-labs/agent-skills

# 通过 npm 全局安装（可选）
npm i -g skills

该工具依赖您已配置的 Git 凭据（Git 凭据助手、GitHub CLI、SSH 密钥等）。对于私有仓库，您可以提供 GITHUB_TOKEN/GH_TOKEN，或让 CLI 回退到您现有的身份验证。

何时考虑使用

标准化提示 – 在使用相同编程助手的开发团队中标准化提示。
共享可复用工作流程（发布说明生成、PR 脚手架、与 Linear 或 Notion 等工具的集成）。
快速原型设计 – 无需提交到仓库即可快速原型设计新提示；skills use 让您随时测试。
CI/CD 流水线 – 非交互标志（--yes、--global）使其在自动化环境中安全安装技能。

限制与注意事项

CLI 仅管理提示文件；它不执行代码或为代理提供运行时。
除非使用 --full-depth，否则技能发现仅限于三级目录深度。
出于安全考虑，大型下载设有上限（默认 10 MiB）；如果您信任来源，可以通过环境变量提高限制。

摘要

skills 是一个轻量级的跨代理 CLI，可让您为广泛的 AI 编程助手获取、安装和运行基于提示的扩展（技能）。它适用于任何 Git 主机，支持私有仓库，并可在交互式和 CI 流水线中使用。

vercel-labs/skills