SkillMap

Jun 3, 2026

用 skills CLI 在 70+ 工具中安装 Agent Skills

通过 vercel-labs/skills（npx skills）从任意 GitHub 仓库列出、安装与试用 Skill，无需猜测各 Agent 的路径。

#tutorial#getting-started#developer-tools#claude-code

手工复制 Skill 目录在只用一个 Agent 时还行；一旦要支持 Claude Code、Codex、Cursor、OpenCode 等多家客户端，路径和符号链接会很快变成负担。vercel-labs/skills 提供的 npx skills CLI 是开放 Agent Skills 生态的通用安装器：一条命令完成解析与落盘。

为什么值得用

多数 Skill 仓库默认你知道「自家 Agent 把技能放在哪」。skills CLI 替你完成映射，并支持：

  • GitHub 简写（owner/repo）与完整 URL
  • 只安装 monorepo 里的某一个 Skill（tree/main/skills/...）
  • 项目级（随仓库提交）或全局级（-g）
  • 安装前列出 Skill（--list）
  • 不安装先试用（skills use）

如果你每周都会装新 Skill，这套流程能省掉重复的拷贝与软链操作。

安装 CLI

CLI 以 npm 包形式发布，不必克隆仓库即可使用。

npx skills --help

无需全局安装。CI 里可用 npx skills@latest 固定版本。

实战：为 Claude Code 安装单个 Skill

目标：在 Next.js 项目里安装 Vercel 的前端设计 Skill。

步骤 1：列出仓库内 Skill

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

从输出里确认准确的 Skill 文件夹名。名称含空格时，后面安装命令里要加引号。

步骤 2：安装到当前项目的 Claude Code 目录

npx skills add vercel-labs/agent-skills \
  --skill frontend-design \
  -a claude-code \
  -y
参数作用
--skill只装指定 Skill，不装整库
-a claude-code写入本项目下的 Claude Code 技能目录
-y跳过交互确认（适合脚本）

重启 Claude Code 或开新会话，让发现阶段加载新目录。

步骤 3：在会话中验证

先问 Agent 已加载哪些 Skill，再执行应触发该 Skill 的任务，例如：

Apply the frontend design skill to review the homepage layout in src/app/page.tsx

若 Agent 仍按通用方式回答，在提示里点名 Skill 名称。

实战：先试用再决定是否安装

你在评估陌生仓库里的 Skill，还不想在 ~/.claude/skills/ 里堆满目录。

npx skills use vercel-labs/agent-skills --skill nextjs --agent claude-code

skills use 会解析仓库、把 Skill 放到临时目录，并可带生成好的提示启动 Agent。适合一次性体验，再决定是否写入项目。

实战：团队统一项目级 Skill

团队希望每个服务仓库都带同一套三个 Skill。

cd ~/my-service
npx skills add anthropics/skills \
  --skill write-git-commit \
  --skill code-review \
  -a claude-code \
  -y

把生成的 .claude/skills/（或对应路径）提交进 Git，新同事 clone 即可对齐。团队规范用项目级（默认），个人偏好才用 -g。

文档或 CI 可用非交互命令：

npx skills add owner/repo --skill my-skill -a claude-code -g -y

支持的来源格式

# 完整 GitHub URL
npx skills add https://github.com/vercel-labs/agent-skills

# 仓库内单个 Skill 路径
npx skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

# 本地开发中的 Skill
npx skills add ./my-local-skills

一个仓库根目录下有很多 Skill 时，用 tree/... 只装你需要的那一个。

技巧

  • 每次从新仓库安装前先 --list，Skill 名往往和你猜的目录名不一致。
  • 优先 --skill，慎用 --all；整库安装会拖慢发现阶段并占上下文。
  • -g 只留给「每台机器都要」的个人 Skill；团队标准放项目级。
  • 含空格的 Skill 名要加引号：--skill "Convex Best Practices"。
  • 在 SkillMap 排行榜 找仓库，再用 npx skills add 安装。

何时不必使用

组织禁止 npx 或访问 npm registry 时，只能按厂商文档手工拷贝 SKILL.md 目录。

若你长期只用一个 Agent、只装一个 Skill，手工拷贝也够用。CLI 的价值在 Agent、仓库或队友数量变多时才会明显。

更多安装方式见 SkillMap 排行榜。