Vercel Labs Skills：AI 编程安装「技能Skills」的工具
🛠️ Vercel Labs Skills：AI 编程安装「技能Skills」的工具
本文介绍 vercel-labs/skills —— 一个通过 npx skills 为多种 AI 编程代理（如 Cursor、Codex、Claude Code、OpenCode 等）统一安装、管理「技能」的 CLI 工具，并配有快速开始与图文示例。📑 目录
💡 Skills 是什么？
Skills 是 Vercel Labs 开源的「开放代理技能生态」的 CLI 工具，核心能力包括：
- 统一安装：从 GitHub 等来源为多种 AI 编程代理安装技能（一段可复用的指令集）。
- 多代理支持：支持 OpenCode、Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot 等 40+ 种代理。
- 安全与透明：安装前会展示安全风险评估（如 Gen、Socket、Snyk），并提示「技能以完整代理权限运行，使用前请审查」。
无需单独配置每个 IDE 或代理，一条 npx skills add 即可把技能装到当前项目或用户目录，并自动识别本机已安装的代理。
⚡ 快速开始
前提：已安装 Node.js，能使用 npx。
1. 从官方示例仓库安装一个技能（交互式）
npx skills add https://github.com/vercel-labs/skills --skill find-skills 执行后会：
- 克隆仓库并识别技能
- 询问「安装到哪些代理」
- 显示安装路径与安全评估
- 确认后完成安装
2. 一键安装到指定代理（非交互，适合脚本/CI）
若只想装到 Codex 和 Cursor，并全局安装、跳过确认，可加 -g、-a、-y：
npx skills add vercel-labs/skills --skill find-skills -g -a codex -a cursor -y -g：安装到用户目录（全局），所有项目可用-a codex -a cursor：只装到这两个代理-y：跳过所有确认提示
3. 查看已安装的技能
npx skills list 更多命令见 其他常用命令。
📦 安装技能
⚙️ 常用选项
| 选项 | 说明 |
|---|---|
-g, --global | 安装到用户目录而不是当前项目 |
-a, --agent <agents...> | 指定代理，如 -a claude-code -a codex |
-s, --skill <skills...> | 只安装指定技能，如 --skill find-skills，'*' 表示全部 |
-l, --list | 只列出仓库中的技能，不安装 |
--copy | 复制文件而非符号链接 |
-y, --yes | 跳过所有确认 |
--all | 安装仓库中所有技能到所有代理（无交互） |
示例：
# 只列出技能，不安装 npx skills add vercel-labs/skills --list # 安装多个指定技能 npx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator # 安装到指定代理 npx skills add vercel-labs/skills -a claude-code -a cursor # 非交互：指定技能 + 全局 + 指定代理 + 跳过确认 npx skills add vercel-labs/skills --skill find-skills -g -a codex -a cursor -y 📍 安装范围与方式
| 范围 | 参数 | 安装位置 | 适用场景 |
|---|---|---|---|
| 项目 | 默认 | ./<agent>/skills/ | 随项目提交，团队共享 |
| 全局 | -g | ~/<agent>/skills/ | 本机所有项目共用 |
安装时还可选择：
- Symlink（推荐）：为各代理创建符号链接，单一数据源，便于更新。
- Copy：复制文件到各代理目录，适用于不支持符号链接的环境。
🖼️ 安装过程说明
📷 图 1：交互式安装（项目内）
使用命令：
npx skills add https://github.com/vercel-labs/skills --skill find-skills 终端会依次显示：
- 来源：
Source: https://github.com/vercel-labs/skills.git - 仓库与技能：
Repository cloned→Found 1 skill→Selected 1 skill: find-skills - 代理选择：
41 agents，并询问Which agents do you want to install to?（如 Amp, Codex, Cursor, Gemini CLI, GitHub Copilot 等） - 安装范围与方法：例如
Installation scope: Project、Installation method: Symlink (Recommended) - 安装摘要：路径如
.\.agents\skills\find-skills，以及将安装到的代理列表 - 安全评估：Gen（安全）、Socket（0 alerts）、Snyk（可能为 Med Risk），以及详情链接
https://skills.sh/vercel-labs/skills - 确认：
Proceed with installation? Yes→Installation complete→Installed 1 skill - 提示：
Done! Review skills before use; they run with full agent permissions.
📷 图 2：全局 + 非交互安装（-g -y）
使用命令：
npx skills add vercel-labs/skills --skill find-skills -g -y - Source / 仓库 / 技能：与上面一致。
- 安装目标：例如
Installing to: Codex, Cursor（若本机只装了这两个，或通过-a指定）。 - 安装摘要：路径为
~\.agents\skills\find-skills，并列出兼容代理（如 Codex, Cursor, Amp, Gemini CLI, GitHub Copilot 等）。 - 安全评估：同样会显示 Gen、Socket、Snyk 及详情链接。
- 完成：
Installation complete、Installed 1 skill，以及「使用前请审查技能」的提示。
⌨️ 其他常用命令
| 命令 | 说明 |
|---|---|
npx skills list（或 ls） | 列出已安装的技能 |
npx skills find [关键词] | 交互或按关键词搜索技能 |
npx skills remove [技能名] | 移除已安装的技能 |
npx skills check | 检查是否有可用更新 |
npx skills update | 更新所有已安装技能到最新版本 |
npx skills init [名称] | 在当前目录（或子目录）创建 SKILL.md 模板 |
示例：
# 只列全局技能 npx skills ls -g # 按代理筛选 npx skills ls -a claude-code -a cursor # 交互式搜索 npx skills find# 按关键词搜索 npx skills find typescript # 移除指定技能 npx skills remove find-skills # 检查 / 更新技能 npx skills check npx skills update 🔍 以 find-skills 为例（最有用的skills）：技能的工作流程与原理
安装好 find-skills 后，代理会多出一份「发现并安装其他技能」的能力。下面以该技能的 SKILL.md 为例，说明一个技能里通常包含哪些关键内容、工作流程和设计思路，便于理解「技能」如何指导代理行为。
🎯 find-skills 是做什么的？
- 名称：
find-skills - 定位：当用户问「怎么实现 X」「有没有能做 X 的技能」「能不能帮我做 X」或想扩展代理能力时，引导用户发现并安装现成的技能。
- 触发场景（节选自 SKILL.md）：
- 问「how do I do X」，且 X 可能有现成技能
- 问「find a skill for X」「is there a skill for X」
- 问「can you do X」且 X 是某种专项能力
- 想扩展代理能力、搜索工具/模板/工作流
- 提到希望在某领域（设计、测试、部署等）得到帮助
🔄 技能内的工作流程（四步）
SKILL.md 里把「帮用户找技能」拆成四个步骤，代理会按这个流程执行：
| 步骤 | 内容 | 说明 |
|---|---|---|
| Step 1：理解需求 | 弄清用户要什么 | 识别：领域（如 React、测试、设计）、具体任务（如写测试、做动画、PR 审查）、以及这是否属于「很可能已有现成技能」的常见需求。 |
| Step 2：搜索技能 | 用 CLI 查技能 | 执行 npx skills find [关键词]，用与需求相关的关键词搜索。例如：「怎么让 React 更快」→ npx skills find react performance；「帮我做 PR 审查」→ npx skills find pr review。命令会返回可安装的 owner/repo@skill 及 skills.sh 链接。 |
| Step 3：呈现结果 | 把选项说清楚 | 向用户说明：技能名称与作用、安装命令（如 npx skills add <owner/repo@skill>）、以及 skills.sh 上的详情链接，方便用户决定是否安装。 |
| Step 4：代为安装（可选） | 用户同意后安装 | 若用户确认要装，可执行 npx skills add <owner/repo@skill> -g -y（-g 全局、-y 跳过确认），帮用户完成安装。 |
整体原理是：先理解意图 → 用统一 CLI 搜索 → 清晰呈现选项 → 按需代为安装，这样用户不需要自己记命令和仓库名，也能在对话中完成「发现技能 → 安装技能」。
📄 技能里还会写什么？
- Skills CLI 简介：说明
npx skills是技能生态的「包管理器」，并列出常用命令（find、add、check、update）和 skills.sh 导航。 - 常见技能分类：给代理一张「领域 → 搜索关键词」表，例如：
- Web 开发：react, nextjs, typescript, css, tailwind
- 测试：testing, jest, playwright, e2e
- DevOps：deploy, docker, kubernetes, ci-cd
- 文档：docs, readme, changelog, api-docs
- 代码质量：review, lint, refactor, best-practices
- 设计：ui, ux, design-system, accessibility
- 效率：workflow, automation, git
- 搜索技巧：用更具体的关键词（如 “react testing” 优于单纯 “testing”）；可尝试同义词（deploy / deployment / ci-cd）；可优先看常见来源（如
vercel-labs/agent-skills、ComposioHQ/awesome-claude-skills）。 - 找不到技能时：承认没有现成技能、说明仍可用通用能力直接帮忙、并建议用户用
npx skills init my-xyz-skill自建技能。
💡 小结：技能 = 说明书 + 流程
可以把 SKILL.md 理解成一份给代理的说明书：既有「什么时候用」（When to Use）、「用什么命令」（CLI），也有「按什么顺序做」（Step 1→2→3→4）和「遇到边界情况怎么办」（如搜不到、用户想自己建技能）。这样，安装 find-skills 后，代理在对话里就能按同一套流程和原则，帮你发现并安装其他技能，而不必死记每个仓库和命令。
🤖 支持的代理
Skills 可安装到多种代理，例如（节选）：
| 代理 | --agent | 项目路径示例 | 全局路径示例 |
|---|---|---|---|
| Cursor | cursor | .agents/skills/ | ~/.cursor/skills/ |
| Codex | codex | .agents/skills/ | ~/.codex/skills/ |
| Claude Code | claude-code | .claude/skills/ | ~/.claude/skills/ |
| OpenCode | opencode | .agents/skills/ | ~/.config/opencode/skills/ |
| Gemini CLI | gemini-cli | .agents/skills/ | ~/.gemini/skills/ |
| GitHub Copilot | github-copilot | .agents/skills/ | ~/.copilot/skills/ |
完整列表见官方仓库 Supported Agents。CLI 会自动检测本机已安装的代理；若未检测到，会提示你选择要安装到的代理。
