一、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 |
检查更新 |
|