一句话定位

skills 是 Agent Skills 的命令行管理器，用来发现、安装、临时使用、更新和移除可复用的 agent 能力包。

高频命令

需求	命令
搜索 skill	npx skills find typescript
查看仓库 skills	npx skills add owner/repo --list
安装指定 skill	npx skills add owner/repo --skill skill-name
安装到 Codex	npx skills add owner/repo --skill skill-name -a codex
全局安装	npx skills add owner/repo --skill skill-name -g -y
临时使用，不落盘	npx skills use owner/repo@skill-name
临时启动 Codex	npx skills use owner/repo@skill-name --agent codex
查看已安装	npx skills ls
更新	npx skills update
删除	npx skills rm skill-name

Source 写法

# GitHub 简写
npx skills add vercel-labs/agent-skills

# GitHub URL / Git URL / 本地路径
npx skills add https://github.com/vercel-labs/agent-skills
npx skills add git@github.com:vercel-labs/agent-skills.git
npx skills add ./my-local-skills

# 单个 skill
npx skills add owner/repo@skill-name
npx skills use owner/repo@skill-name

# 指定分支或标签
npx skills add owner/repo#main
npx skills add owner/repo#v1.2.0
npx skills add owner/repo#main@skill-name

add 安装

npx skills add <source> [options]

别名：a、install、i。

参数	作用
-g, --global	安装到全局用户目录
-a, --agent <agents...>	指定目标 agent，如 codex、claude-code、opencode
-s, --skill <skills...>	只安装指定 skill；'*' 表示全部
-l, --list	只列出可用 skills，不安装
-y, --yes	跳过确认
--copy	复制文件，而不是创建符号链接
--all	全部 skills、全部 agents、自动确认
--full-depth	深度搜索子目录中的 SKILL.md

常用例子：

npx skills add vercel-labs/agent-skills --list
npx skills add vercel-labs/agent-skills --skill frontend-design
npx skills add vercel-labs/agent-skills --skill frontend-design -a codex
npx skills add vercel-labs/agent-skills --skill '*' -a claude-code
npx skills add vercel-labs/agent-skills --all

use 临时使用

skills use 会下载所选 skill 到临时目录，输出可喂给 agent 的 prompt，不会安装到项目或全局目录。

npx skills use vercel-labs/agent-skills@web-design-guidelines
npx skills use vercel-labs/agent-skills@web-design-guidelines | claude
npx skills use vercel-labs/agent-skills@web-design-guidelines --agent codex
npx skills use vercel-labs/agent-skills@web-design-guidelines > /tmp/skill-prompt.txt

[!warning]
skills use --agent 目前只支持 claude-code 和 codex。其他 agent 用 stdout prompt 自行接入。

多 skill 仓库必须指定 skill：

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

其他命令

命令	用法
find	npx skills find、npx skills find react performance
list / ls	npx skills ls、npx skills ls -g、npx skills ls -a codex、npx skills ls --json
update	npx skills update、npx skills update my-skill、npx skills update -g、npx skills update -p、npx skills update -y
remove / rm	npx skills rm my-skill、npx skills remove --global my-skill、npx skills remove --agent claude-code cursor my-skill

update 别名：upgrade、check。

删除全部或批量删除：

npx skills remove --all
npx skills remove --skill '*' -a cursor
npx skills remove my-skill --agent '*'

Skill 文件最小结构

一个 skill 是带 SKILL.md 的目录。SKILL.md 必须有 frontmatter：

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

## Instructions

1. Do the task.

推荐目录：

repo/
└── skills/
    └── my-skill/
        ├── SKILL.md
        ├── scripts/
        ├── references/
        └── assets/

CLI 会扫描常见位置：

SKILL.md
skills/
skills/.curated/
skills/.experimental/
skills/.system/
.agents/skills/
.claude/skills/
.codex/skills/

如果 SKILL.md 藏得很深：

npx skills add owner/repo --full-depth

安装位置

Agent	参数名	项目路径	全局路径
Codex	codex	.agents/skills/	~/.codex/skills/
Claude Code	claude-code	.claude/skills/	~/.claude/skills/
OpenCode	opencode	.agents/skills/	~/.config/opencode/skills/
Cursor	cursor	.agents/skills/	~/.cursor/skills/
Gemini CLI	gemini-cli	.agents/skills/	~/.gemini/skills/
GitHub Copilot	github-copilot	.agents/skills/	~/.copilot/skills/

项目级安装会维护 skills-lock.json，全局安装会维护用户级 .skill-lock.json。

安装方式：

方式	适合场景
Symlink	默认推荐；多个 agent 指向同一份 skill，方便更新
Copy	不支持符号链接，或希望各 agent 独立修改

强制复制：

npx skills add owner/repo --copy

相关链接

• vercel-labs/skills
• Skills Directory
• Agent Skills Specification
• Codex Skills Documentation
• Claude Code Skills Documentation
• OpenCode Skills Documentation