什么是 Agent Skills？
Agent skills 是可重用的指令集，能够扩展你的 AI 编程助手的能力。它们定义在带有 YAML 前置数据的 SKILL.md 文件中，包含名称和描述。
技能可以让助手执行各种专业化任务，例如：
- 从 Git 提交历史生成发布说明
- 遵循团队规范创建 Pull Request
- 集成外部工具（如 Linear、Notion 等）
核心价值
通过模块化的技能体系，你可以将最佳实践固化为机器可理解的指令，让 AI 真正成为你团队中熟悉流程的一员。
使用指南
来源格式
<source> 参数支持多种格式：
# GitHub 简写
npx add-skill vercel-labs/agent-skills
# 完整的 GitHub URL
npx add-skill https://github.com/vercel-labs/agent-skills
# 指定仓库中的某个技能路径
npx add-skill https://github.com/vercel-labs/agent-skills/tree/main/skills/frontend-design
# 其他 Git 仓库
npx add-skill git@github.com:vercel-labs/agent-skills.git
配置选项
| 选项 | 描述 |
|---|---|
| -g, --global | 安装到用户全局目录而非当前项目 |
| -a, --agent <agents...> | 指定目标代理：opencode, claude-code, codex, cursor, antigravity |
| -s, --skill <skills...> | 通过名称安装特定技能 |
| -l, --list | 仅列出可用技能，不进行安装 |
| -y, --yes | 跳过所有确认提示 |
实际案例
列出仓库中的技能
npx add-skill vercel-labs/agent-skills --list
安装特定技能
npx add-skill vercel-labs/agent-skills --skill frontend-design
全局安装到特定代理
npx add-skill vercel-labs/agent-skills -g -a claude-code
一键安装全部技能
npx add-skill vercel-labs/agent-skills -y -g
安装路径
CLI 会根据作用域和代理类型将技能安装到不同位置：
项目级别 (默认)
安装在当前工作目录。建议将其提交到 Git 仓库与团队共享。
项目路径映射
OpenCode.opencode/skill/
Claude Code.claude/skills/
Cursor.cursor/skills/
Antigravity.agent/skills/
全局级别 (--global)
安装在用户根目录。在所有项目中均可使用。
全局路径映射
OpenCode~/.config/opencode/skill/
Claude Code~/.claude/skills/
Cursor~/.cursor/skills/
Antigravity~/.gemini/antigravity/skills/
助手自动检测
CLI 会通过检查各个助手的配置目录，自动检测您当前系统中已安装的编程助手。 如果未检测到任何助手，工具会主动提示您手动选择需要安装的目标平台。
创建技能
技能是包含 SKILL.md 文件的目录，文件必须包含 YAML 前置数据：
---
name: my-skill
description: 描述此技能的功能以及何时使用它
---
# 我的技能
当此技能被激活时，AI 助手需要遵循的指令。
## 使用场景
描述此技能应该在哪些场景下被调用。
## 步骤
1. 首先，执行此操作
2. 然后，执行彼操作
必需字段
- name: 唯一标识符（小写，允许连字符）
- description: 技能功能的简要说明
技能发现
CLI 会在仓库的多个标准路径（如 skills/, .cursor/skills/ 等）搜索技能。如果未找到，将进行递归搜索。
核心兼容性
| 功能特性 | OpenCode | Claude Code | Codex | Cursor | Antigravity |
|---|---|---|---|---|---|
| 基础技能支持 | Yes | Yes | Yes | Yes | Yes |
| 工具白名单 (allowed-tools) | Yes | Yes | Yes | Yes | Yes |
| Hooks 钩子 | No | Yes | No | No | No |
故障排除
未发现技能？
确保仓库包含有效的 SKILL.md 文件，且 YAML 前置数据包含 name 和 description。
技能未加载？
验证安装路径是否正确，并检查代理的官方文档以了解技能加载的具体要求。
权限错误？
确保你对目标安装目录具有写入权限，尤其是在使用全局安装 (-g) 时。