skills

开放 Agent 技能生态系统的 CLI 工具

支持 OpenCode、Claude Code、Codex、Cursor 等 40+ 种 Agent。

安装技能

npx skills add vercel-labs/agent-skills

来源格式

# GitHub 简写 (owner/repo)
npx skills add vercel-labs/agent-skills

# 完整 GitHub URL
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 URL
npx skills add https://gitlab.com/org/repo

# 任意 git URL
npx skills add git@github.com: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"

# 安装到指定 Agent
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

# 安装仓库中的所有技能到所有 Agent
npx skills add vercel-labs/agent-skills --all

# 安装所有技能到指定 Agent
npx skills add vercel-labs/agent-skills --skill '*' -a claude-code

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

安装范围

安装方式

交互式安装时，可以选择：

其他命令

skills list

# 列出所有已安装的技能（项目 + 全局）
npx skills list

# 仅列出全局技能
npx skills ls -g

# 按指定 Agent 过滤
npx skills ls -a claude-code -a cursor

skills find

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

# 按关键字搜索
npx skills find typescript

skills check / update

# 检查是否有已安装技能的更新
npx skills check

# 更新所有技能到最新版本
npx skills update

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

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

# 无确认移除所有已安装技能
npx skills remove --all

# 从特定 Agent 移除所有技能
npx skills remove --skill '*' -a cursor

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

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

什么是 Agent 技能？

Agent 技能是可重用的指令集，用于扩展编码 Agent 的能力。它们定义在包含 YAML frontmatter（包含 name 和 description）的 SKILL.md 文件中。

技能让 Agent 能执行专业化任务，例如：

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

在 skills.sh 发现更多技能

支持的 Agent

技能可以安装到以下任意 Agent：

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

CLI 会自动检测已安装的编码 Agent。如果没有检测到，系统会提示选择要安装的 Agent。

创建技能

技能是包含 SKILL.md 文件的目录，文件包含 YAML frontmatter：

---
name: my-skill
description: 这个技能的用途和使用场景
---

# 我的技能

当此技能激活时，Agent 遵循的指令。

## 使用场景

描述应该使用此技能的场景。

## 步骤

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/
• .agent/skills/
• .augment/skills/
• .claude/skills/
• ./skills/
• .codebuddy/skills/
• .commandcode/skills/
• .continue/skills/
• .cortex/skills/
• .crush/skills/
• .factory/skills/
• .goose/skills/
• .junie/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-plugin/marketplace.json
{
  "metadata": { "pluginRoot": "./plugins" },
  "plugins": [
    {
      "name": "my-plugin",
      "source": "my-plugin",
      "skills": ["./skills/review", "./skills/test"]
    }
  ]
}

这使得与 Claude Code 插件市场 生态系统兼容。

如果在标准位置未找到技能，将执行递归搜索。

兼容性

技能在 Agent 之间通常兼容，因为它们遵循共享的 Agent Skills 规范。但某些功能可能特定于某些 Agent：

问题排查

"未找到技能"

确保仓库包含有效的 SKILL.md 文件，frontmatter 中包含 name 和 description。

技能在 Agent 中未加载

• 验证技能已安装到正确路径
• 检查 Agent 的文档了解技能加载要求
• 确保 SKILL.md frontmatter 是有效的 YAML

权限错误

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

环境变量

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

遥测

此 CLI 收集匿名使用数据以帮助改进工具。不收集个人信息。

遥测在 CI 环境中自动禁用。

相关链接

• Agent Skills 规范
• 技能目录
• Vercel Agent Skills 仓库
• OpenClaw Skills 文档
• Cline Skills 文档
• Cursor Skills 文档
• Claude Code Skills 文档
• OpenCode Skills 文档
• Roo Code Skills 文档