Vercel Labs Skills：AI 编程代理技能管理 CLI 工具

示例：

# 只列出技能，不安装
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 

📍 安装范围与方式

安装时还可选择：

• Symlink（推荐）：为各代理创建符号链接，单一数据源，便于更新。
• Copy：复制文件到各代理目录，适用于不支持符号链接的环境。

🖼️ 安装过程说明

📷 图 1：交互式安装（项目内）

使用命令：

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

终端会依次显示：

1. 来源：Source: https://github.com/vercel-labs/skills.git
2. 仓库与技能：Repository cloned → Found 1 skill → Selected 1 skill: find-skills
3. 代理选择：41 agents，并询问 Which agents do you want to install to?（如 Amp, Codex, Cursor, Gemini CLI, GitHub Copilot 等）
4. 安装范围与方法：例如 Installation scope: Project、Installation method: Symlink (Recommended)
5. 安装摘要：路径如 .\.agents\skills\find-skills，以及将安装到的代理列表
6. 安全评估：Gen（安全）、Socket（0 alerts）、Snyk（可能为 Med Risk），以及详情链接 https://skills.sh/vercel-labs/skills
7. 确认：Proceed with installation? Yes → Installation complete → Installed 1 skill
8. 提示：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 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 里把「帮用户找技能」拆成四个步骤，代理会按这个流程执行：

整体原理是：先理解意图 → 用统一 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 可安装到多种代理，例如（节选）：

完整列表见官方仓库 Supported Agents。CLI 会自动检测本机已安装的代理；若未检测到，会提示你选择要安装到的代理。