一、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 skills add vercel-labs/agent-skills --list

---

（2）安装技能

方式 A：安装整个技能包

安装某个仓库包含的所有技能：

# 安装 obra/superpowers 的所有技能
npx skills add obra/superpowers

# 安装 vercel-labs/agent-skills 的所有技能
npx skills add vercel-labs/agent-skills

方式 B：安装指定技能

从仓库中只安装特定的一个或多个技能：

# 安装单个技能
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 指定助手：

# 全局安装到指定助手，跳过确认
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 会依次询问：

流程一：选择要安装的技能

1. 空格：单独勾选/取消当前这一个技能
2. a：一键全选全部技能
3. u：一键清空所有勾选（全部取消选中）
4. i：反向颠倒勾选（选中变不选，不选变选中）
5. 回车：确认勾选，开始批量安装

流程二：选择安装到哪个 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 skills find               # 交互式浏览搜索，上下键选择，回车即装
npx skills find react         # 按关键词搜索（如 react、pdf、api）

2️⃣ 增 – 添加/安装技能 add

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

npx skills list                # 列出当前项目所有已安装的技能
npx skills list -a cursor      # 只列出某个 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 skills find               # 交互搜索，之后安装时会提示选择范围，选 global
npx skills find python        # 关键词搜索

注意：find 本身不区分项目/全局，但安装时可通过提示选择。若想直接装到全局，请用下面的 add -g。

2️⃣ 增 – 添加/安装技能到全局 add -g

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

npx skills list -g                # 列出所有全局安装的技能
npx skills list -g -a claude-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 skills add obra/superpowers

包含技能：

• test-driven-development：测试驱动开发
• systematic-debugging：系统化调试
• verification-before-completion：完成前验证

Vercel 官方技能包

npx skills add vercel-labs/agent-skills

包含技能：

• vercel-react-best-practices：React 最佳实践
• web-design-guidelines：Web 设计规范
• skill-creator：技能开发指南

Anthropic 官方技能包

npx skills add anthropics/skills

包含技能：

• frontend-design：前端设计
• pdf：PDF 处理

---

八、常见问题

Q1: 第一次运行很慢？

首次运行时 npx 需要下载 skills 包，之后会使用缓存。

Q2: 安装太多技能会怎样？

AI 启动时需要加载技能元数据，安装太多会影响响应速度。建议只安装常用的。

Q3: 安装后 AI 没有用到技能？

1. 重启 AI 助手
2. 运行 npx skills list 确认安装成功
3. 检查技能是否安装到正确目录

Q4: 团队如何共享技能？

1. 项目级安装（不加 -g）
2. 把 skills-lock.json 提交到 Git
3. 团队成员拉取后运行 npx skills add

Q5: 如何禁用遥测？

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

---

相关资源

【1】技能目录：skills.sh
【2】CLI 源码：github.com/vercel-labs/skills
【3】npx skills 核心拆解
【4】npx skills核心功能速查及技能开发指南
【5】用一条命令为所有 AI Coding Agent 安装 Skills
【6】开放代理技能工具 - npx skills 的详解