Vercel开源skills：AI编程智能体技能共享生态

开放 Agent Skills 生态系统的 CLI。

支持 OpenCode、Claude Code、Codex、Cursor，以及 75 以上的更多工具。

npx skills add vercel-labs/agent-skills

不安装直接使用 Skill

为单个 Skill 生成 prompt，或以交互方式启动支持的 Coding Agent：

npx skills use vercel-labs/agent-skills@web-design-guidelines | claude
npx skills use vercel-labs/agent-skills --skill web-design-guidelines --agent claude-code

skills use 解析源的方式与 skills add 相同，将选定的 Skill 文件写入临时目录，除非提供了 --agent 参数，否则只将生成的 prompt 输出到标准输出。带上 --agent 时，会以交互方式启动一个支持的 Agent，并传入生成的 prompt。

添加 Skills

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

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

# 指向 repo 中某个 Skill 的直接路径
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

公开仓库和私有仓库使用同一套命令

CLI 使用仓库 URL 已配置好的认证方式：

# GitHub 简写形式或 HTTPS（依次尝试：git credential helper、GitHub CLI、SSH 回退）
npx skills add acme/private-skills

# GitHub、GitLab 或其他 Git 平台的 SSH 方式
npx skills add git@github.com:acme/private-skills.git
npx skills add ssh://git@git.example.com/acme/private-skills.git

# 任意 Git 平台的 HTTPS（使用已配置的 git credential helper）
npx skills add https://git.example.com/acme/private-skills.git

对于 GitHub HTTPS 和简写形式的源，skills 首先尝试正常的 Git 凭证。如果失败且已认证 GitHub CLI，则会尝试 gh repo clone，之后再尝试 SSH。CLI 不会执行 gh auth token，也不会将存储的 GitHub CLI 凭证复制到 Node.js 进程。

对于 GitHub tree 查找，skills 首先匿名尝试 API，其次是显式提供的环境变量 token，然后是 gh api。GitHub CLI 会应用其自身存储的认证并只返回 API 响应；凭证永远不会被 skills 打印或读取。如果 API 访问仍然失败，更新检查会回退到认证后的 Git 克隆。

GITHUB_TOKEN 或 GH_TOKEN 可以显式设置，用于 GitHub API 访问，包括私有仓库下载和更新检查。当 Git、GitHub CLI 或 SSH 认证已配置时，这些变量对安装是可选的。

安装特定的 Skills

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

# 安装特定的 skills
npx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# 安装名称中包含空格的 skill（必须加引号）
npx skills add owner/repo --skill "Convex Best Practices"

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

# 从一个 repo 安装所有 skills 到所有 agents
npx skills add vercel-labs/agent-skills --all

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

# 安装特定的 skills 到所有 agents
npx skills add vercel-labs/agent-skills --agent '*' --skill frontend-design

# 从直接 SKILL.md 或归档下载 URL 安装
npx skills add https://example.com/download/my-skill

直接下载 URL 会在常规发现流程之后尝试。可以指向单个有效的 SKILL.md 文件，或 .zip、.tar、.tar.gz、.tgz 归档文件；URL 不必包含文件扩展名。下载默认限制为 10 MiB，提取内容限制为 25 MiB，归档文件限制为 1000 个。在信任来源时，可以通过 SKILLS_DOWNLOAD_MAX_BYTES、SKILLS_EXTRACT_MAX_BYTES 和 SKILLS_EXTRACT_MAX_FILES 覆盖这些限制。

交互式安装时可以自行选择。

列出已安装的 Skills

列出所有已安装的 skills。类似于 npm ls。

# 列出所有已安装的 skills（项目级和全局）
npx skills list

# 只列出全局 skills
npx skills ls -g

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

搜索 Skills

以交互方式或按关键字搜索 skills。

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

# 按关键字搜索
npx skills find typescript

# 在某个组织或用户拥有的所有仓库中搜索
npx skills find react --owner vercel

更新 Skills

# 更新所有 skills（交互式范围提示）
npx skills update

# 更新单个指定名称的 skill
npx skills update my-skill

# 更新多个指定的 skills
npx skills update frontend-design web-design-guidelines

# 只更新全局或项目级 skills
npx skills update -g
npx skills update -p

# 非交互式（自动检测范围：位于项目中则为项目级，否则为全局）
npx skills update -y

初始化 Skill

# 在当前目录创建 SKILL.md
npx skills init

# 在子目录中创建新的 skill
npx skills init my-skill

移除 Skills

从 agents 中移除已安装的 skills。

# 交互式移除（从已安装的 skills 中选择）
npx skills remove

# 按名称移除特定的 skill
npx skills remove web-design-guidelines

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

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

# 只从特定 agents 移除
npx skills remove --agent claude-code cursor my-skill

# 移除所有已安装的 skills，无需确认
npx skills remove --all

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

# 从所有 agents 移除特定的 skill
npx skills remove my-skill --agent '*'

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

什么是 Agent Skills？

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

Skills 使 agents 能够执行专业任务，例如：

• 根据 git 历史生成更新日志
• 按照团队规范创建 PR
• 集成外部工具（Linear、Notion 等）

在 skills.sh 发现更多 skills。

支持的 Agents

Skills 可以安装到以下任意 Agent 中：

Kiro CLI 用户：默认 Agent 自动从 .kiro/skills/ 和 ~/.kiro/skills/ 加载 skills——无需配置。如果使用自定义 Agent，请在 .kiro/agents/<agent>.json 中将 skills 添加到其 resources：

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

CLI 会自动检测已安装的 Coding Agent。如果未检测到任何 Agent，系统会提示你选择要安装到的 Agent。

SKILL.md 格式

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

---
name: my-skill
description: What this skill does and when to use it
---

# My Skill

Instructions for the agent to follow when this skill is activated.

## When to Use

Describe the scenarios where this skill should be used.

## Steps

1. First, do this
2. Then, do that

name：唯一标识符（小写，允许用连字符）

description：简要说明该 skill 的功能及使用场景

metadata.internal：设为 true 可在正常发现中隐藏该 skill。Internal skills 只有在设置了 INSTALL_INTERNAL_SKILLS=1 时才可见和可安装。适用于正在开发中的 skills 或仅供内部工具使用的 skills。

---
name: my-internal-skill
description: An internal skill not shown by default
metadata:
  internal: true
---

仓库中的 Skills 查找位置

CLI 在仓库的以下位置搜索 skills。单个 skill 容器目录最多向上遍历三层，覆盖扁平布局（skills/<name>/SKILL.md）和含一至两层分类目录的目录布局（skills/<category>/<name>/SKILL.md 或 skills/<category>/<category>/<name>/SKILL.md）。在较浅层级发现的 SKILL.md 会遮蔽其下方嵌套的任何内容。使用 --full-depth 也可以发现这些容器目录之外的 SKILL.md 文件（例如在 examples/ 或 tests/ 下）。

• 根目录（如果包含 SKILL.md）
• skills/.experimental/
• .codeartsdoer/skills/
• .posit/assistant/skills/
• .tabnine/agent/skills/

插件清单发现

如果存在 .claude-plugin/marketplace.json 或 .claude-plugin/plugin.json，其中声明的 skills 也将被发现：

// .claude-plugin/marketplace.json
{
  "metadata": { "pluginRoot": "./plugins" },
  "plugins": [
    {
      "name": "my-plugin",
      "source": "my-plugin",
      "skills": ["./skills/review", "./skills/test"]
    }
  ]
}

这实现了与 Claude Code 插件市场生态系统的兼容性。清单中声明的 Skill 路径按其声明的深度搜索，不受上述有界深度-3 目录遍历的限制。

如果在标准位置未找到任何 skills，则执行递归搜索。

兼容性

Skills 遵循通用的 Agent Skills 规范，因此通常在不同的 agents 之间是兼容的。但某些功能可能是特定于某个 Agent 的：

• 确保仓库包含有效的 SKILL.md 文件，且 frontmatter 中包含 name 和 description
• Skill 在 Agent 中不加载：验证该 skill 已安装到正确路径；检查该 Agent 的文档以了解其 skill 加载要求；确保 SKILL.md frontmatter 是有效的 YAML；确保你对目标目录有写权限

环境变量

# 安装 internal skills
INSTALL_INTERNAL_SKILLS=1 npx skills add vercel-labs/agent-skills --list

遥测

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

GitHub 仓库和 Skill 标识符仅针对 GitHub 确认为公开的仓库发送。其他远程源类型可能因无法通过 GitHub 检查其可见性，而在安装遥测中包含源和 Skill 标识符。安全审计请求仅限已确认公开的 GitHub 仓库。设置 DISABLE_TELEMETRY=1 或 DO_NOT_TRACK=1 可完全禁用遥测。

相关链接

Agent Skills 规范

Amp Skills 文档

Antigravity Skills 文档

Factory AI / Droid Skills 文档

Claude Code Skills 文档

OpenClaw Skills 文档

Cline Skills 文档

CodeBuddy Skills 文档

Codex Skills 文档

Command Code Skills 文档

Crush Skills 文档

Cursor Skills 文档

Firebender Skills 文档

Gemini CLI Skills 文档

GitHub Copilot Agent Skills

iFlow CLI Skills 文档

Kimi Code CLI Skills 文档

Kiro CLI Skills 文档

Kode Skills 文档

OpenCode Skills 文档

Qwen Code Skills 文档

OpenHands Skills 文档

Pi Skills 文档

Posit Assistant Skills 文档

Qoder Skills 文档

Replit Skills 文档

Roo Code Skills 文档

Trae Skills 文档

Vercel Agent Skills 仓库

本项目采用 MIT 协议授权。