vercel-labs skills

skills

开放 agent skills 生态系统的 CLI。支持 OpenCode、Claude Code、Codex、Cursor 以及另外 75 个工具。

安装 Skill

npx skills add vercel-labs/agent-skills

不安装直接使用 Skill

为单个 skill 生成提示词，或以交互方式启动受支持的编码 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 文件写入临时目录，并且只将生成的提示词输出到 stdout，除非提供了 --agent。使用 --agent 时，它会以交互方式启动一个受支持的 agent 并传入生成的提示词。

来源格式

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

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

# 仓库中 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

# Azure Repos（Azure DevOps Services 或 Server）
npx skills add https://dev.azure.com/org/project/_git/repo
npx skills add https://dev.azure.com/org/project/_git/repo?path=/skills/web-design&version=GBmain

# 任意 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
npx skills add https://dev.azure.com/org/project/_git/private-skills

对于 GitHub HTTPS 和简写来源，skills 首先使用常规 Git 凭据。如果失败且 GitHub CLI 已认证，它会尝试 gh repo clone，然后尝试 SSH。它不会执行 gh auth token，也不会将存储的 GitHub CLI 凭据复制到 Node.js 进程中。

对于 GitHub tree 查询，skills 首先匿名尝试 API，然后使用显式提供的环境令牌，最后使用 gh api。GitHub CLI 应用其自身存储的认证并仅返回 API 响应；凭据永远不会被打印给 skills 或被 skills 读取。如果 API 访问仍然失败，更新检查会回退到经过认证的 Git clone。

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

选项

| 选项 | 描述 | |------|------| | -g, --global | 安装到用户目录而非项目目录 | | -a, --agent | 指定目标 agent（例如 claude-code、codex）。参见支持的 Agents | | -s, --skill | 按名称安装特定 skills（使用 '*' 表示所有 skills） | | -l, --list | 列出可用 skills 而不安装 | | --copy | 复制文件而非符号链接到 agent 目录 | | -y, --yes | 跳过所有确认提示 | | --all | 无提示地将所有 skills 安装到所有 agents |

示例

# 列出仓库中的 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

# 将仓库中所有 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 会在 well-known 发现之后尝试。它们可以指向单个有效的 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/ | 随项目提交，与团队共享 | | 全局 | -g | ~//skills/ | 在所有项目中可用 |

安装方式

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

| 方式 | 描述 | |------|------| | 符号链接（推荐） | 从每个 agent 创建符号链接到规范副本。单一数据源，易于更新。 | | 复制 | 为每个 agent 创建独立副本。在不支持符号链接时使用。 |

其他命令

| 命令 | 描述 | |------|------| | npx skills use | 使用一个 skill 而不安装 | | npx skills list | 列出已安装的 skills（别名：ls） | | npx skills find [query] | 以交互方式或按关键词搜索 skills | | npx skills remove [skills] | 从 agents 中移除已安装的 skills | | npx skills update [skills] | 将已安装的 skills 更新到最新版本 | | npx skills init [name] | 创建新的 SKILL.md 模板 |

skills list

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

# 列出项目已安装的 skills
npx skills list

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

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

skills find

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

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

# 按关键词搜索
npx skills find typ