vercel-labs/skills 源码：https://github.com/vercel-labs/skills # skills

开放智能体技能生态的 CLI。支持 OpenCode、Claude Code、Codex、Cursor 以及另外 41 种智能体。

安装一项技能

npx skills add vercel-labs/agent-skills

支持的源格式

# GitHub 简写（owner/repo）
npx skills add vercel-labs/agent-skills

# 完整 GitHub 地址
npx skills add https://github.com/vercel-labs/agent-skills

# 指向仓库内某个技能目录
npx skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

# GitLab 地址
npx skills add https://gitlab.com/org/repo

# 任意 git 地址
npx skills add [email protected]:vercel-labs/agent-skills.git

# 本地路径
npx skills add ./my-local-skills

选项

示例

# 列出仓库中的技能
npx skills add vercel-labs/agent-skills --list

# 安装指定技能
npx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# 安装名称含空格的技能（需加引号）
npx skills add owner/repo --skill "Convex Best Practices"

# 安装到指定智能体
npx skills add vercel-labs/agent-skills -a claude-code -a opencode

# 非交互式安装（适合 CI/CD）
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y

# 为所有智能体安装仓库全部技能
npx skills add vercel-labs/agent-skills --all

# 为指定智能体安装全部技能
npx skills add vercel-labs/agent-skills --skill '*' -a claude-code

# 为所有智能体安装指定技能
npx skills add vercel-labs/agent-skills --agent '*' --skill frontend-design

安装作用域

安装方式

交互安装时可选择：

其他命令

skills list

列出已安装技能，类似 npm ls。

# 列出全部（项目+全局）
npx skills list

# 仅全局
npx skills ls -g

# 按智能体过滤
npx skills ls -a claude-code -a cursor

skills find

交互或按关键词搜索技能。

# 交互式搜索（类 fzf）
npx skills find

# 按关键词
npx skills find typescript

skills update

# 升级全部（交互选择作用域）
npx skills update

# 升级单个
npx skills update my-skill

# 升级多个
npx skills update frontend-design web-design-guidelines

# 仅全局或仅项目
npx skills update -g
npx skills update -p

# 非交互（自动检测作用域）
npx skills update -y

skills init

# 在当前目录生成 SKILL.md
npx skills init

# 在子目录生成
npx skills init my-skill

skills remove

从智能体移除技能。

# 交互选择
npx skills remove

# 按名称移除
npx skills remove web-design-guidelines

# 移除多个
npx skills remove frontend-design web-design-guidelines

# 全局移除
npx skills remove --global web-design-guidelines

# 仅从指定智能体移除
npx skills remove --agent claude-code cursor my-skill

# 无确认移除全部
npx skills remove --all

# 从指定智能体移除全部技能
npx skills remove --skill '*' -a cursor

# 从所有智能体移除指定技能
npx skills remove my-skill --agent '*'

# 使用别名 rm
npx skills rm my-skill

什么是 Agent Skills？

Agent skills 是可复用的指令集，用于扩展你的编码智能体能力。它们通过 SKILL.md 文件定义，顶部包含 name 与 description 的 YAML 头信息。技能让智能体能够：

• 根据 git 历史生成发布说明
• 按团队规范创建 PR
• 集成外部工具（Linear、Notion 等）

在 skills.sh (https://skills.sh) 发现更多技能。

支持的智能体

技能可安装到以下任意智能体：

Kiro CLI 用户： 安装后需手动在 .kiro/agents/<agent>.json 的 resources 中加入：

{
  "resources": ["skill://.kiro/skills/**/SKILL.md"]
}

CLI 会自动检测已安装的编码智能体；若未检测到，会提示选择。

创建技能

技能是包含 SKILL.md 的目录，顶部为 YAML 头信息：

---
name: my-skill
description: 技能作用与使用时机
---

# My Skill
智能体激活此技能时应遵循的指令。

## 何时使用
描述应调用此技能的场景。

## 步骤
1. 首先，做这件事
2. 然后，做那件事

必需字段

• name：唯一标识（小写，可用连字符）
• description：简短说明

可选字段

• metadata.internal: 设为 true 可在默认发现中隐藏。仅当 INSTALL_INTERNAL_SKILLS=1 时才可见，适合内部或半成品技能。

---
name: my-internal-skill
description: 默认隐藏的私有技能
metadata:
  internal: true
---

技能发现

CLI 会在以下位置搜索：

• 根目录（含 SKILL.md）
• skills/
• skills/.curated/
• skills/.experimental/
• skills/.system/
• .agents/skills/
• .augment/skills/
• .bob/skills/
• .claude/skills/
• ./skills/
• .codebuddy/skills/
• .commandcode/skills/
• .continue/skills/
• .cortex/skills/
• .crush/skills/
• .factory/skills/
• .goose/skills/
• .junie/skills/
• .iflow/skills/
• .kilocode/skills/
• .kiro/skills/
• .kode/skills/
• .mcpjam/skills/
• .vibe/skills/
• .mux/skills/
• .openhands/skills/
• .pi/skills/
• .qoder/skills/
• .qwen/skills/
• .roo/skills/
• .trae/skills/
• .windsurf/skills/
• .zencoder/skills/
• .neovate/skills/
• .pochi/skills/
• .adal/skills/

若存在 .claude-plugin/marketplace.json 或 .claude-plugin/plugin.json，也会解析其中声明的技能，兼容 Claude Code 插件市场（https://code.claude.com/docs/en/plugin-marketplaces）。若标准位置未找到，将递归搜索。

兼容性

技能遵循统一的 Agent Skills 规范（https://agentskills.io），跨智能体基本通用，但部分特性可能受限：

故障排除

“未找到技能”

确保仓库存在含有效 name 与 description 的 SKILL.md。

智能体未加载技能

• 确认安装路径正确
• 查阅对应智能体文档
• 检查 YAML 头信息格式

权限错误

确保对目标目录有写权限。

环境变量

# 安装内部技能
INSTALL_INTERNAL_SKILLS=1 npx skills add vercel-labs/agent-skills --list

遥测

CLI 会收集匿名使用数据以改进产品，不含任何个人信息；CI 环境自动禁用。

相关链接

• Agent Skills 规范（https://agentskills.io）
• 技能目录（https://skills.sh）
• Amp 技能文档（https://ampcode.com/manual#agent-skills）
• Antigravity 技能文档（https://antigravity.google/docs/skills）
• Factory AI / Droid 技能文档（https://docs.factory.ai/cli/configuration/skills）
• Claude Code 技能文档（https://code.claude.com/docs/en/skills）
• OpenClaw 技能文档（https://docs.openclaw.ai/tools/skills）
• Cline 技能文档（https://docs.cline.bot/features/skills）
• CodeBuddy 技能文档（https://www.codebuddy.ai/docs/ide/Features/Skills）
• Codex 技能文档（https://developers.openai.com/codex/skills）
• Command Code 技能文档（https://commandcode.ai/docs/skills）
• Crush 技能文档（https://github.com/charmbracelet/crush?tab=readme-ov-file#agent-skills）
• Cursor 技能文档（https://cursor.com/docs/context/skills）
• Firebender 技能文档（https://docs.firebender.com/multi-agent/skills）
• Gemini CLI 技能文档（https://geminicli.com/docs/cli/skills/）
• GitHub Copilot 智能体技能（https://docs.github.com/en/copilot/concepts/agents/about-agent-skills）
• iFlow CLI 技能文档（https://platform.iflow.cn/en/cli/examples/skill）
• Kimi Code CLI 技能文档（https://moonshotai.github.io/kimi-cli/en/customization/skills.html）
• Kiro CLI 技能文档（https://kiro.dev/docs/cli/custom-agents/c