使用 npx add-skill 安装开源 Skill 到本地

`add-skill`是 `Vercel` 发布 AI 技能管理工具，[官方链接](https://github.com/vercel-labs/add-skill)。主要用于快速将`git` 仓库上的`skill` 下载到本地并指定安装到对应`agent` 目录，其中包括`opencode,claude-code,codex,cursor,antigravity,gitub-copilot,ro

关关长语

1429人浏览 · 2026-01-21 00:17:33

关关长语 · 2026-01-21 00:17:33 发布

add-skill是 Vercel 发布 AI 技能管理工具，官方链接。主要用于快速将git 仓库上的skill 下载到本地并指定安装到对应agent 目录，其中包括opencode,claude-code,codex,cursor,antigravity,gitub-copilot,roo 。

仓库目录

可以查看github 对应仓库为vercel-labs/agent-skills
Pasted image 20260120230146.png

对应存在一个Skills 目录。
Pasted image 20260120230228.png

常用命令

帮助指令

npx add-skill --help

输出如下：

Usage: add-skill [options] <source>
Install skills onto coding agents (OpenCode, Claude Code, Codex, Cursor, Antigravity, Github Copilot, Roo Code)
Arguments:
  source                   Git repo URL, GitHub shorthand (owner/repo), local path (./path), or direct path to skill
Options:
  -V, --version            output the version number
  -g, --global             Install skill globally (user-level) instead of project-level
  -a, --agent <agents...>  Specify agents to install to (opencode, claude-code, codex, cursor, antigravity,
                           gitub-copilot, roo)
  -s, --skill <skills...>  Specify skill names to install (skip selection prompt)
  -l, --list               List available skills in the repository without installing
  -y, --yes                Skip confirmation prompts
  --all                    Install all skills to all agents without any prompts (implies -y -g)
  -h, --help               display help for command

获取`skills`列表

npx add-skill vercel-labs/agent-skills --list

输出如下：

┌   skills
│
◇  Source: https://github.com/vercel-labs/agent-skills.git
│
◇  Repository cloned
│
◇  Found 2 skills

再以anthropics/skills 为例。

npx add-skill anthropics/skills --list

输出结果如下：

┌   skills
│
◇  Source: https://github.com/anthropics/skills.git
│
◇  Repository cloned
│
◇  Found 17 skills

指定路径下载

npx add-skill [source]

完整仓库路径，案例vercel-labs/agent-skills

npx add-skill https://github.com/vercel-labs/agent-skills

短称仓库路径。

npx add-skill vercel-labs/agent-skills

通过git 下载。

npx add-skill git@github.com:vercel-labs/agent-skills.git

下载指定`skill`

npx add-skill [source] -s [skill_name]

例如：

npx add-skill vercel-labs/agent-skills -s vercel-react-best-practices

也可以直接指定skill 完整路径。

npx add-skill [source]

例如：

npx add-skill https://github.com/vercel-labs/agent-skills/tree/main/skills/vercel-react-best-practices

指定`agent`安装`skill`

npx add-skill [source] -a [agent_name]

[agent_name] 支持如下：

opencode,claude-code,codex,cursor,antigravity,gitub-copilot,roo

全局级安装

默认当前目录行安装，则为项目级别生效，可以使用-g/--global进行全局指定。

npx add-skill -g [source]

`skill` 资源

官方提供了一些，知名平台提供的skills仓库。

集成平台

也可以使用一些skills 仓库集成平台。

注意事项

使用add-skill 为opencode 添加skill 时，不管是全局(用户)层面还是项目层面 .opencode/skills/[skill_name]，都需要修改为.opencode/skill/[skill_name]，当前opencode 版本1.1.28存在问题，并不是官方文档中说的那样在.opencode/skills/ 目录下。
高版本中，add-skill 命令变更为了skills add，读者需要注意。