Skills 技能市场 | skills.sh（npx skill）
- 一、npx skills 是什么
- 二、核心概念
- 三、第一次使用 npx skills
- 四、技能安装详解
- 来源格式
- （1）查看仓库有哪些技能
- （2）安装技能
- 方式 A：安装整个技能包
- 方式 B：安装指定技能
- 方式 C：非交互式安装
- 五、快速开始（整个交互流程）
- 流程一：选择要安装的技能
- 流程二：选择安装到哪个 AI 助手
- 流程三：选择安装范围
- 流程四：选择安装方式
- 六、其他常用命令
- 第一部分：项目级安装（仅影响当前目录）
- 1️⃣ 搜 – 查找可安装的技能 `find`
- 2️⃣ 增 – 添加/安装技能 `add`
- 3️⃣ 查 – 查看已安装的技能 `list`
- 4️⃣ 改 – 更新技能 `update` / `check`
- 5️⃣ 删 – 卸载技能 `remove`（别名 `rm`）
- 第二部分：全局级安装（影响所有项目）
- 1️⃣ 搜 – 查找可安装的技能 `find`
- 2️⃣ 增 – 添加/安装技能到全局 `add -g`
- 3️⃣ 查 – 查看全局已安装的技能 `list -g`
- 4️⃣ 改 – 更新全局技能 `update -g` / `check -g`
- 5️⃣ 删 – 卸载全局技能 `remove -g`
- 七、推荐技能包
- Superpowers（AI 工作流）
- Vercel 官方技能包
- Anthropic 官方技能包
- 八、常见问题
- 九、命令速查表
- 相关资源
一、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 为例）：
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）查看仓库有哪些技能
安装前先看看某个仓库里有哪些技能可选：
npx skillsaddvercel-labs/agent-skills--list（2）安装技能
方式 A：安装整个技能包
安装某个仓库包含的所有技能：
# 安装 obra/superpowers 的所有技能npx skillsaddobra/superpowers# 安装 vercel-labs/agent-skills 的所有技能npx skillsaddvercel-labs/agent-skills方式 B：安装指定技能
从仓库中只安装特定的一个或多个技能：
# 安装单个技能npx skillsaddvercel-labs/agent-skills-sfrontend-design# 安装多个指定技能npx skillsaddvercel-labs/agent-skills-sfrontend-design-sskill-creator# 安装带空格的技能名（必须加引号）npx skillsaddowner/repo--skill"Convex Best Practices"# 安装所有技能到指定助手npx skillsaddvercel-labs/agent-skills--skill'*'-aclaude-code方式 C：非交互式安装
建议先使用交互式安装熟悉流程后再使用此方式
使用-y跳过确认，-g全局安装，-a指定助手：
# 全局安装到指定助手，跳过确认npx skillsaddvercel-labs/agent-skills-aclaude-code-g-y# 安装指定技能，跳过确认npx skillsaddvercel-labs/agent-skills-sfrontend-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
npx skillsfind# 交互式浏览搜索，上下键选择，回车即装npx skillsfindreact# 按关键词搜索（如 react、pdf、api）2️⃣ 增 – 添加/安装技能add
npx skillsaddfrontend-design# 安装单个技能npx skillsaddobra/superpowers--skillbrainstorming--skillwriting-plans-y# 从仓库装多个技能npx skillsadd<技能名>--copy# 使用复制模式（不建立软链接）npx skillsadd<技能名>-aclaude-code# 只给指定的 AI 助手安装3️⃣ 查 – 查看已安装的技能list
npx skills list# 列出当前项目所有已安装的技能npx skills list-acursor# 只列出某个 AI 助手（cursor）下的技能4️⃣ 改 – 更新技能update/check
npx skills check# 检查有哪些技能可以更新（不实际更新）npx skills update# 更新当前项目的所有技能npx skills update frontend-design# 只更新指定的技能5️⃣ 删 – 卸载技能remove（别名rm）
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
npx skillsfind# 交互搜索，之后安装时会提示选择范围，选 globalnpx skillsfindpython# 关键词搜索注意：
find本身不区分项目/全局，但安装时可通过提示选择。若想直接装到全局，请用下面的add -g。
2️⃣ 增 – 添加/安装技能到全局add -g
npx skillsaddfrontend-design-g# 全局安装单个技能npx skillsaddobra/superpowers--skillbrainstorming--skillwriting-plans-g-y# 从仓库安装多个全局技能npx skillsadd<技能名>-g--copy# 使用复制模式全局安装npx skillsadd<技能名>-g-acursor# 只给全局中的某个 AI 助手安装3️⃣ 查 – 查看全局已安装的技能list -g
npx skills list-g# 列出所有全局安装的技能npx skills list-g-aclaude-code# 只列出全局中 Claude Code 的技能4️⃣ 改 – 更新全局技能update -g/check -g
npx skills check-g# 检查哪些全局技能有更新npx skills update-g# 更新所有全局技能npx skills update frontend-design-g# 只更新某个指定的全局技能5️⃣ 删 – 卸载全局技能remove -g
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 工作流）
npx skillsaddobra/superpowers包含技能：
test-driven-development：测试驱动开发systematic-debugging：系统化调试verification-before-completion：完成前验证
Vercel 官方技能包
npx skillsaddvercel-labs/agent-skills包含技能：
vercel-react-best-practices：React 最佳实践web-design-guidelines：Web 设计规范skill-creator：技能开发指南
Anthropic 官方技能包
npx skillsaddanthropics/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: 如何禁用遥测？
exportDISABLE_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 | 检查更新 |
相关资源
【1】技能目录：skills.sh
【2】CLI 源码：github.com/vercel-labs/skills
【3】npx skills 核心拆解
【4】npx skills核心功能速查及技能开发指南
【5】用一条命令为所有 AI Coding Agent 安装 Skills
【6】开放代理技能工具 - npx skills 的详解
