vercel-labs/skills（npm 包名就叫 skills）是 Vercel Labs 出品的开源 CLI，定位是「开放 agent skill 生态的包管理器」：一条命令，把别人写好的 skill 装进你正在用的编码代理（agent），支持 Claude Code、Codex、Cursor、OpenCode 等 80 多个代理。

一个心智模型：skill 界的 npm

如果你用过 npm，这个工具的行为几乎不用学：

skills CLI	npm 里对应的概念	作用
npx skills add <源>	npm install	把 skill 安装到代理的技能目录
npx skills find	npm search	交互式搜索 / 关键词找 skill
npx skills update	npm update	更新已安装的 skill
npx skills remove	npm uninstall	移除 skill
npx skills list	npm ls	列出已装 skill（项目级 + 全局）
npx skills init	脚手架	生成 SKILL.md 模板，开始写自己的 skill
skills.sh	npm registry	skill 发现站点

最有特色的一个命令是 skills use——不安装、直接用：它把选中的 skill 生成为一段 prompt 喂给你指定的代理，适合临时借用一次、不想落盘的场景。

安装语义：作用域 × 方式

装一个 skill 时有两个维度要选：

作用域（装到哪）：

• 项目级（默认）：装进 ./<agent>/skills/ 一类的项目目录，随仓库提交、团队共享
• 全局级（-g）：装进 ~/<agent>/skills/，所有项目可用

安装方式（怎么装）：

• Symlink（推荐）：各代理目录里放符号链接，指向同一份规范副本——单一事实源，更新一次全代理生效
• Copy：每个代理各复制一份独立副本，适合不支持符号链接的环境

什么是 agent skill

README 里的定义很干脆：skill 是可复用的指令集，用来扩展编码代理的能力。每个 skill 就是一个 SKILL.md 文件，头部 YAML frontmatter 里写 name 和 description，正文写工作流指令。典型用途比如：从 git 历史生成发布说明、按团队规范创建 PR、对接 Linear / Notion 等外部工具。

阅读 README（英中对照）

以上只是速览。它的 README 本身就是一份完整文档——除了安装和命令速查，还包括：私有仓库的凭据处理、SKILL.md 的必填 / 可选字段全表、代理运行时的 skill 发现机制、插件清单发现、各代理兼容性矩阵、常见故障排除。我在这里放了完整的英中对照版，左边英文原文、右边中文译文，逐段对齐阅读：

阅读 skills CLI 官方 README（英中对照）

中键点击或按住修饰键点击，则会在新标签打开 GitHub 英文原文。