Vercel Skills

概述

skills 是一个用于开放式 Agent Skills 生态的命令行工具。它支持 OpenCode、Claude Code、Codex、Cursor 等数十款主流编码 Agent，能够从 GitHub、GitLab、Azure Repos、本地路径或任意 Git 地址安装、管理和搜索可复用的技能（Skill）。技能本质上是一组存放于 SKILL.md 中的指令集合，可让 Agent 完成生成发布说明、按团队规范创建 PR、对接 Linear 或 Notion 等专业任务。

安装一个技能

npx skills add vercel-labs/agent-skills

临时使用技能

skills use 会按与 skills add 相同的规则解析来源，把所选技能文件写入临时目录，并将生成的提示打印到标准输出。配合 --agent 时，则以交互方式启动指定 Agent。

# 生成提示并通过管道传给 claude
npx skills use vercel-labs/agent-skills@web-design-guidelines | claude

# 指定技能与 Agent，直接交互
npx skills use vercel-labs/agent-skills --skill web-design-guidelines --agent claude-code

支持的来源格式

CLI 支持 GitHub 简写（owner/repo）、完整 URL、仓库内子路径、GitLab、Azure Repos、任意 Git 仓库地址以及本地路径。私有仓库会复用本地已有的 Git 凭证：先尝试常规 Git 凭据，失败后再回退到 gh repo clone，最后回退到 SSH。GitHub HTTPS 与简写形式的 API 访问可由 GITHUB_TOKEN 或 GH_TOKEN 显式提供认证。

主要选项

选项	说明
-g, --global	安装到用户目录，而非当前项目
-a, --agent	指定目标 Agent，支持重复传入
-s, --skill	指定要安装的技能名，'*' 表示全部
-l, --list	仅列出可用技能，不安装
--copy	复制而非软链接到 Agent 目录
-y, --yes	跳过确认提示
--all	把所有技能安装到全部 Agent

安装作用域

默认安装到项目目录下的 ./<agent>/skills/，便于与团队共享；通过 -g 可安装到 ~/<agent>/skills/，对全部项目生效。

安装方式

交互式安装时可在「软链接（推荐）」与「复制」之间选择。软链接指向统一副本，利于更新；复制则互不依赖，适合不支持符号链接的环境。

其他命令

命令	作用
npx skills use <source>	不安装直接使用一个技能
npx skills list	列出已安装技能（别名 ls）
npx skills find [query]	按关键字或交互方式搜索技能
npx skills remove [skills]	从 Agent 中移除技能
npx skills update [skills]	将已安装技能升级到最新版
npx skills init [name]	生成 SKILL.md 模板

# 列出已安装的项目级技能
npx skills list

# 仅列出全局技能
npx skills ls -g

# 关键字搜索
npx skills find typescript

# 限定组织的全仓库搜索
npx skills find react --owner vercel

# 升级全部技能（自动检测作用域）
npx skills update -y

# 移除特定 Agent 上的某个技能
npx skills remove --agent claude-code cursor my-skill

什么是 Agent Skills

技能是可扩展编码 Agent 能力的可复用指令集，定义在带 YAML frontmatter 的 SKILL.md 文件中，必须包含 name 与 description 两个字段。可选 metadata.internal: true 字段用于隐藏进行中的内部技能，仅在设置 INSTALL_INTERNAL_SKILLS=1 时显示并安装。

CLI 会在仓库中递归查找符合以下条件的技能目录：根目录（若直接包含 SKILL.md）、skills/、skills/.curated/、skills/.experimental/、skills/.system/，以及各类 Agent 专属目录。每个技能容器目录最多向下遍历三层，覆盖扁平布局与最多两层分类布局。若仓库中存在 .claude-plugin/marketplace.json 或 .claude-plugin/plugin.json，其中声明的技能路径也会被发现，以兼容 Claude Code 插件市场。若标准位置未发现技能，则执行全仓库递归扫描。

支持的 Agent

工具已支持七十余款 Agent，包括 Claude Code、Codex、Cursor、OpenCode、GitHub Copilot、Windsurf、AiderDesk、Antigravity、Cline、Kiro CLI、Roo Code、Tabnine CLI、Grok Build 等。每个 Agent 都有对应的 --agent 标识与项目/全局安装路径，CLI 会自动检测本机已安装的 Agent；未检测到时会提示用户手动选择。Kiro CLI 默认从 .kiro/skills/ 加载技能，使用自定义 Agent 时需要在 .kiro/agents/<agent>.json 的 resources 中显式声明。

兼容性

技能遵循统一的 Agent Skills 规范，因此跨 Agent 通用。allowed-tools 几乎被所有 Agent 支持；context: fork 与 hooks 仅 Claude Code 完整支持；其它特性可能因 Agent 不同而存在差异。

环境变量

变量	说明
INSTALL_INTERNAL_SKILLS	设置为 1 以显示并安装内部技能
DISABLE_TELEMETRY 或 DO_NOT_TRACK	关闭匿名使用统计
GITHUB_TOKEN 或 GH_TOKEN	可选，显式提供 GitHub API 凭证

故障排查

• 找不到技能：确认仓库中存在合法的 SKILL.md，且 frontmatter 包含 name 和 description。
• Agent 未加载技能：核对安装路径、查阅 Agent 文档确认加载规则，并验证 frontmatter 格式正确。
• 权限错误：确保对目标目录具有写权限。

工具默认会收集匿名使用数据以辅助改进，不涉及个人信息。如需关闭，可设置 DISABLE_TELEMETRY=1 或 DO_NOT_TRACK=1。