skills

skills

面向开放 agent skills 生态系统的 CLI。

支持 OpenCode、Claude Code、Codex、Cursor 以及另外 75 个。

安装 Skill

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 输出到 stdout。使用 --agent 时，它会带着生成的 prompt 以交互方式启动一个受支持的 agent。

来源格式

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

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

# Direct path to a skill in a repo
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

# Any git URL
npx skills add git@github.com:vercel-labs/agent-skills.git

# Local path
npx skills add ./my-local-skills

私有仓库

公开仓库和私有仓库使用相同的命令。CLI 会使用已为仓库 URL 配置好的认证方式：

# GitHub shorthand or HTTPS (Git credential helper, GitHub CLI, then SSH fallback)
npx skills add acme/private-skills

# SSH on GitHub, GitLab, or another Git host
npx skills add git@github.com:acme/private-skills.git
npx skills add ssh://git@git.example.com/acme/private-skills.git

# HTTPS on any Git host (uses your configured Git credential helper)
npx skills add https://git.example.com/acme/private-skills.git

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

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

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

选项

选项	说明
-g, --global	安装到用户目录，而非项目目录
-a, --agent <agents...>	指定目标 agents（例如 claude-code、codex）。参见支持的 Agent
-s, --skill <skills...>	按名称安装指定 skills（使用 '*' 表示所有 skills）
-l, --list	列出可用 skills，但不安装
--copy	复制文件，而不是在 agent 目录中创建符号链接
-y, --yes	跳过所有确认提示
--all	无需提示，将所有 skills 安装到所有 agents

示例

# List skills in a repository
npx skills add vercel-labs/agent-skills --list

# Install specific skills
npx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# Install a skill with spaces in the name (must be quoted)
npx skills add owner/repo --skill "Convex Best Practices"

# Install to specific agents
npx skills add vercel-labs/agent-skills -a claude-code -a opencode

# Non-interactive installation (CI/CD friendly)
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y

# Install all skills from a repo to all agents
npx skills add vercel-labs/agent-skills --all

# Install all skills to specific agents
npx skills add vercel-labs/agent-skills --skill '*' -a claude-code

# Install specific skills to all agents
npx skills add vercel-labs/agent-skills --agent '*' --skill frontend-design

# Install from a direct SKILL.md or archive download 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 覆盖这些限制。

安装范围

范围	参数	位置	使用场景
项目	（默认）	./<agent>/skills/	随项目提交，与团队共享
全局	-g	~/<agent>/skills/	在所有项目中可用

安装方式

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

方式	说明
符号链接（推荐）	为每个 agent 创建指向规范副本的符号链接。单一数据源，便于更新。
复制	为每个 agent 创建独立副本。在不支持符号链接时使用。

其他命令

命令	说明
npx skills use <source>	在不安装的情况下使用单个 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。

# List all installed skills (project and global)
npx skills list

# List only global skills
npx skills ls -g

# Filter by specific agents
npx skills ls -a claude-code -a cursor

skills find

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

# Interactive search (fzf-style)
npx skills find

# Search by keyword
npx skills find typescript

# Search across every repository owned by an organization or user
npx skills find react --owner vercel

skills update

# Update all skills (interactive scope prompt)
npx skills update

# Update a single skill by name
npx skills update my-skill

# Update multiple specific skills
npx skills update frontend-design web-design-guidelines

# Update only global or project skills
npx skills update -g
npx skills update -p

# Non-interactive (auto-detects scope: project if in a project, else global)
npx skills update -y

选项	说明
-g, --global	仅更新全局 skills
-p, --project	仅更新项目 skills
-y, --yes	跳过范围提示（自动检测：若在项目目录中则为项目，否则为全局）
[skills...]	按名称更新指定 skills，而非全部

skills init

# Create SKILL.md in current directory
npx skills init

# Create a new skill in a subdirectory
npx skills init my-skill

skills remove

从 agents 中移除已安装的 skills。

# Remove interactively (select from installed skills)
npx skills remove

# Remove specific skill by name
npx skills remove web-design-guidelines

# Remove multiple skills
npx skills remove frontend-design web-design-guidelines

# Remove from global scope
npx skills remove --global web-design-guidelines

# Remove from specific agents only
npx skills remove --agent claude-code cursor my-skill

# Remove all installed skills without confirmation
npx skills remove --all

# Remove all skills from a specific agent
npx skills remove --skill '*' -a cursor

# Remove a specific skill from all agents
npx skills remove my-skill --agent '*'

# Use 'rm' alias
npx skills rm my-skill

选项	说明
-g, --global	从全局范围（~/）移除，而非项目
-a, --agent	从指定 agents 中移除（使用 '*' 表示全部）
-s, --skill	指定要移除的 skills（使用 '*' 表示全部）
-y, --yes	跳过确认提示
--all	--skill '*' --agent '*' -y 的简写

什么是 Agent Skills？

Agent skills 是可复用的指令集，用于扩展你的 coding agent 的能力。它们定义在 SKILL.md 文件中，通过 YAML frontmatter 包含 name 和 description。

Skill 让 agent 能够执行诸如以下专门任务：

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

在 skills.sh 发现 skills

支持的 Agent

Skill 可以安装到以下任意 agent：

Agent	--agent	项目路径	全局路径
AiderDesk	aider-desk	.aider-desk/skills/	~/.aider-desk/skills/
Amp, Replit, Universal	amp, replit, universal	.agents/skills/	~/.config/agents/skills/
Antigravity	antigravity	.agents/skills/	~/.gemini/antigravity/skills/
Antigravity CLI	antigravity-cli	.agents/skills/	~/.gemini/antigravity-cli/skills/
AstrBot	astrbot	data/skills/	~/.astrbot/data/skills/
Autohand Code CLI	autohand-code	.autohand/skills/	~/.autohand/skills/
Augment	augment	.augment/skills/	~/.augment/skills/
IBM Bob	bob	.bob/skills/	~/.bob/skills/
Claude Code	claude-code	.claude/skills/	~/.claude/skills/
OpenClaw	openclaw	skills/	~/.openclaw/skills/
Cline, Dexto, Kimi Code CLI, Loaf, Sarvam Code, Warp, Zed	cline, dexto, kimi-code-cli, loaf, sarvam-code, warp, zed	.agents/skills/	~/.agents/skills/
CodeArts Agent	codearts-agent	.codeartsdoer/skills/	~/.codeartsdoer/skills/
CodeBuddy	codebuddy	.codebuddy/skills/	~/.codebuddy/skills/
Codemaker	codemaker	.codemaker/skills/	~/.codemaker/skills/
Code Studio	codestudio	.codestudio/skills/	~/.codestudio/skills/
Codex	codex	.agents/skills/	~/.codex/skills/
Command Code	command-code	.commandcode/skills/	~/.commandcode/skills/
Continue	continue	.continue/skills/	~/.continue/skills/
Cortex Code	cortex	.cortex/skills/	~/.snowflake/cortex/skills/
Crush	crush