一、npx skills 是什么
npx skills 是 Vercel 推出的 AI Agent 技能管理工具，让 AI 编程助手（Claude Code、Cursor、Windsurf 等）获得专业能力。它就像 AI 助手的"应用商店"，一次安装，多个助手共享。
- 技能市场：https://skills.sh/
- CLI 源码：https://github.com/vercel-labs/skills
二、核心概念
| 概念 | 说明 | 示例 |
|---|---|---|
| 技能包 | GitHub 仓库，包含多个技能 | obra/superpowers、vercel-labs/agent-skills |
| 技能 | 具体的技能项，从技能包中选取安装 | test-driven-development、frontend-design |
结构关系（以 obra/superpowers 为例）：
|
1 2 3 4 5 |
obra/superpowers（技能包/仓库） ├── test-driven-development（技能 1） ├── systematic-debugging（技能 2） ├── verification-before-completion（技能 3） └── ... |
三、第一次使用 npx skills
第一次运行 npx skills 命令时，npx 会提示你是否下载 skills 工具包。输入 y 确认即可，之后 npx 会缓存这个包。
四、技能安装详解
来源格式
npx skills add <仓库来源>
| 格式 | 示例 |
|---|---|
| GitHub 短名 | vercel-labs/agent-skills |
| GitHub URL | https://github.com/vercel-labs/agent-skills |
| 本地路径 | ./my-skills |
（1）查看仓库有哪些技能
安装前先看看某个仓库里有哪些技能可选：
|
1 |
npx skills add vercel-labs/agent-skills --list |
（2）安装技能
方式 A：安装整个技能包
安装某个仓库包含的所有技能：
|
1 2 3 4 |
# 安装 obra/superpowers 的所有技能 npx skills add obra/superpowers # 安装 vercel-labs/agent-skills 的所有技能 npx skills add vercel-labs/agent-skills |
方式 B：安装指定技能
从仓库中只安装特定的一个或多个技能：
|
1 2 3 4 5 6 7 8 9 10 11 |
# 安装单个技能 npx skills add vercel-labs/agent-skills -s frontend-design
# 安装多个指定技能 npx skills add vercel-labs/agent-skills -s frontend-design -s skill-creator
# 安装带空格的技能名（必须加引号） npx skills add owner/repo --skill "Convex Best Practices"
# 安装所有技能到指定助手 npx skills add vercel-labs/agent-skills --skill '*' -a claude-code |
方式 C：非交互式安装
建议先使用交互式安装熟悉流程后再使用此方式
使用 -y 跳过确认，-g 全局安装，-a 指定助手：
|
1 2 3 4 5 |
# 全局安装到指定助手，跳过确认 npx skills add vercel-labs/agent-skills -a claude-code -g -y
# 安装指定技能，跳过确认 npx skills add vercel-labs/agent-skills -s frontend-design -y |
五、快速开始（整个交互流程）
以 obra/superpowers 仓库举例
运行 npx skills add obra/superpowers后，CLI 会依次询问：
流程一：选择要安装的技能
- 空格：单独勾选/取消当前这一个技能
- a：一键全选全部技能
- u：一键清空所有勾选（全部取消选中）
- i：反向颠倒勾选（选中变不选，不选变选中）
- 回车：确认勾选，开始批量安装
流程二：选择安装到哪个 AI 助手
按照你的选择安装到相应的AI目录里面去（支持多选）
当然如果没有找到的话，也可以不勾选（因为会默认创建一个.agents文件夹）
| AGENT | SKILLS 路径 | 项目指令文件 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | CLAUDE.md |
| Qwen Code | ~/.qwen/skills/ | QWEN.md / AGENTS.md |
| OpenCode | ~/.agents/skills/ | AGENTS.md |
| GitHub Copilot | - | .github/copilot-instructions.md |
| Gemini CLI | - | GEMINI.md |
流程三：选择安装范围
| 选项 | 说明 |
|---|---|
| Project（项目级） | 安装到当前项目，随 Git 提交，团队共享 |
| Global（全局级） | 安装到用户目录，所有项目可用 |
流程四：选择安装方式
| 选项 | 说明 |
|---|---|
| Symlink（符号链接） | 推荐，更新一处同步所有 |
| Copy（复制） | 独立副本 |
六、其他常用命令
第一部分：项目级安装（仅影响当前目录）
默认操作范围是当前项目，所有命令不加 -g。
1?? 搜 – 查找可安装的技能find
|
1 2 |
npx skills find # 交互式浏览搜索，上下键选择，回车即装 npx skills find react # 按关键词搜索（如 react、pdf、api） |
2?? 增 – 添加/安装技能add
|
1 2 3 4 |
npx skills add frontend-design # 安装单个技能 npx skills add obra/superpowers --skill brainstorming --skill writing-plans -y # 从仓库装多个技能 npx skills add <技能名> --copy # 使用复制模式（不建立软链接） npx skills add <技能名> -a claude-code # 只给指定的 AI 助手安装 |
3?? 查 – 查看已安装的技能list
|
1 2 |
npx skills list # 列出当前项目所有已安装的技能 npx skills list -a cursor # 只列出某个 AI 助手（cursor）下的技能 |
4?? 改 – 更新技能update/check
|
1 2 3 |
npx skills check # 检查有哪些技能可以更新（不实际更新） npx skills update # 更新当前项目的所有技能 npx skills update frontend-design # 只更新指定的技能 |
5?? 删 – 卸载技能remove（别名rm）
|
1 2 3 4 5 |
npx skills remove # 交互式选择卸载（空格多选，回车确认） npx skills remove frontend-design # 直接卸载指定技能 npx skills remove brainstorming writing-plans # 同时卸载多个 npx skills remove --all # ?? 删除当前项目的所有技能（危险） npx skills remove frontend-design -y # 静默卸载，不询问 |
第二部分：全局级安装（影响所有项目）
全局安装的技能对所有项目都生效。所有命令都必须加上 -g 参数。
1?? 搜 – 查找可安装的技能find
|
1 2 |
npx skills find # 交互搜索，之后安装时会提示选择范围，选 global npx skills find python # 关键词搜索 |
注意：find 本身不区分项目/全局，但安装时可通过提示选择。若想直接装到全局，请用下面的 add -g。
2?? 增 – 添加/安装技能到全局add -g
|
1 2 3 4 |
npx skills add frontend-design -g # 全局安装单个技能 npx skills add obra/superpowers --skill brainstorming --skill writing-plans -g -y # 从仓库安装多个全局技能 npx skills add <技能名> -g --copy # 使用复制模式全局安装 npx skills add <技能名> -g -a cursor # 只给全局中的某个 AI 助手安装 |
3?? 查 – 查看全局已安装的技能list -g
|
1 2 |
npx skills list -g # 列出所有全局安装的技能 npx skills list -g -a claude-code # 只列出全局中 Claude Code 的技能 |
4?? 改 – 更新全局技能update -g/check -g
|
1 2 3 |
npx skills check -g # 检查哪些全局技能有更新 npx skills update -g # 更新所有全局技能 npx skills update frontend-design -g # 只更新某个指定的全局技能 |
5?? 删 – 卸载全局技能remove -g
|
1 2 3 4 5 |
npx skills remove -g # 交互式选择卸载全局技能（空格多选） npx skills remove frontend-design -g # 直接卸载指定的全局技能 npx skills remove brainstorming writing-plans -g # 同时卸载多个全局技能 npx skills remove --all -g # ?? 删除所有全局技能（极度危险） npx skills remove frontend-design -g -y # 静默卸载 |
七、推荐技能包
Superpowers（AI 工作流）
|
1 |
npx skills add obra/superpowers |
包含技能：
- test-driven-development：测试驱动开发
- systematic-debugging：系统化调试
- verification-before-completion：完成前验证
Vercel 官方技能包
|
1 |
npx skills add vercel-labs/agent-skills |
包含技能：
- vercel-react-best-practices：React 最佳实践
- web-design-guidelines：Web 设计规范
- skill-creator：技能开发指南
Anthropic 官方技能包
|
1 |
npx skills add anthropics/skills |
包含技能：
- frontend-design：前端设计
- pdf：PDF 处理
八、常见问题
Q1: 第一次运行很慢？
首次运行时 npx 需要下载 skills 包，之后会使用缓存。
Q2: 安装太多技能会怎样？
AI 启动时需要加载技能元数据，安装太多会影响响应速度。建议只安装常用的。
Q3: 安装后 AI 没有用到技能？
- 重启 AI 助手
- 运行 npx skills list 确认安装成功
- 检查技能是否安装到正确目录
Q4: 团队如何共享技能？
- 项目级安装（不加 -g）
- 把 skills-lock.json 提交到 Git
- 团队成员拉取后运行 npx skills add
Q5: 如何禁用遥测？
|
1 |
export DISABLE_TELEMETRY=1 |
九、命令速查表
| 命令 | 作用 |
|---|---|
| npx skills add <仓库> --list | 查看仓库有哪些技能 |
| npx skills add <仓库> | 安装整个技能包 |
| npx skills add <仓库> -s 技能名 | 安装指定单个技能 |
| npx skills add <仓库> -s 技能1 -s 技能2 | 安装多个指定技能 |
| npx skills add <仓库> -s 技能名 -y | 非交互式安装 |
| npx skills list | 查看已安装技能 |
| npx skills find <关键词> | 搜索技能 |
| npx skills update | 更新所有技能 |
| npx skills update <技能名> | 更新指定技能 |
| npx skills remove <技能名> | 卸载技能 |
| npx skills check | 检查更新 |
