Vercel Labs Skills：AI 编程安装「技能Skills」的工具

🛠️ Vercel Labs Skills：AI 编程安装「技能Skills」的工具

本文介绍 vercel-labs/skills ------ 一个通过 npx skills 为多种 AI 编程代理（如 Cursor、Codex、Claude Code、OpenCode 等）统一安装、管理「技能」的 CLI 工具，并配有快速开始与图文示例。

📑 目录

[💡 Skills 是什么？](#💡 Skills 是什么？)
[⚡ 快速开始](#⚡ 快速开始)
[📦 安装技能](#📦 安装技能)
[🖼️ 安装过程说明](#🖼️ 安装过程说明)
[⌨️ 其他常用命令](#⌨️ 其他常用命令)
[🔍 以 find-skills 为例：技能的工作流程与原理](#🔍 以 find-skills 为例：技能的工作流程与原理)
[🤖 支持的代理](#🤖 支持的代理)

💡 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. 从官方示例仓库安装一个技能（交互式）

bash 复制代码

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

执行后会：

克隆仓库并识别技能
询问「安装到哪些代理」
显示安装路径与安全评估
确认后完成安装

2. 一键安装到指定代理（非交互，适合脚本/CI）

若只想装到 Codex 和 Cursor ，并全局安装 、跳过确认 ，可加 -g、-a、-y：

bash 复制代码

npx skills add vercel-labs/skills --skill find-skills -g -a codex -a cursor -y

-g：安装到用户目录（全局），所有项目可用
-a codex -a cursor：只装到这两个代理
-y：跳过所有确认提示

3. 查看已安装的技能

bash 复制代码

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`	安装仓库中所有技能到所有代理（无交互）

示例：

bash 复制代码

# 只列出技能，不安装
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：交互式安装（项目内）

使用命令：

bash 复制代码

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）

使用命令：

bash 复制代码

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 模板

示例：

bash 复制代码

# 只列全局技能
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 会自动检测本机已安装的代理；若未检测到，会提示你选择要安装到的代理。