一条命令搞定 Agent Skills：npx skills 上手指南

如果你最近在用 Claude、Cursor 或 Claude Code，大概率已经听过一个词——Skill（技能）。它正在成为给 AI 装上"专业能力"的事实标准。但很多人卡在了第一步：技能到底怎么装？要不要写代码？装错地方会不会用不了？

这篇文章想把这件事讲透。先说清楚 Skill 的本质，再带你用 Vercel 出品的 npx skills 命令行工具，把"发现、安装、管理"技能这件事一次性搞定。

---

一、先搞懂：Skill 到底是什么

抛开各种花哨的包装，一个 Skill 本质上就是一个文件夹。文件夹里通常包含三类东西：

• 一个 SKILL.md 文件（必需）。它由 YAML 头部（name 和 description）加上 Markdown 正文组成，告诉 AI"这个技能是干什么的、什么时候该用、怎么用"。
• 一些脚本（可选，常放在 scripts/ 里）。比如处理 PDF、操作表格的可执行代码。
• 一些参考资料和素材（可选，常放在 references/、assets/ 里）。比如模板、规范文档、示例。

典型的目录长这样：

my-skill/
├── SKILL.md        # 必需：说明 + 元数据
├── scripts/        # 可选：辅助脚本
├── references/     # 可选：参考文档
└── assets/         # 可选：模板、素材

这里有个关键设计叫按需加载（渐进式披露）。AI 平时只读 SKILL.md 里那几行简短的描述，知道"有这么个技能存在"。只有当你的任务真正用得上它时，AI 才会去翻开正文、调用脚本、读取素材。这样既不占用宝贵的上下文窗口，又能在需要时调出完整能力。

一句话总结：Skill 不是插件、不是 API，就是一个能被 AI 按需读取的文件夹。

---

二、Skill 能在哪里用

Skill 最大的优势之一是"一次编写，到处可用"。它跨越了三大类完全不同的运行环境：

第一类，GUI 聊天应用。 也就是 Claude、ChatGPT 这种带图形界面的对话 App。你在网页或桌面端聊天框里就能用上技能。

第二类，编程 IDE 与 TUI/CLI 工具。 比如 Cursor 这类编辑器，以及 Claude Code 这类跑在终端里的命令行助手。开发者在写代码、跑命令的过程中随时调用技能。

第三类，Agent Harness（智能体运行框架）。 比如 OpenClaw 这类把多个工具、记忆、技能编排到一起的智能体系统。技能在这里成为可被自动化调度的能力单元。

同一个技能文件夹，在这三类环境里都能用——区别只在于它该被放到哪个目录。这就引出了下一个核心问题。

---

三、安装的本质：把文件夹放对地方

这是整篇文章最值得记住的一句话：

安装 Skill 的本质，就是把技能对应的文件夹，放到目标工具能识别的特定目录下，让 AI 能按需加载和使用。

没有什么神秘的"安装程序"，也不需要构建步骤。工具会在会话开始时直接读取那个目录里的文件夹。所以安装无非两条路：

方式一：在 App 里安装

对于 GUI 聊天应用，目前主要有两种途径：

• 通过 App 自带的技能商店安装——点一下就好，最省事。
• 通过上传压缩包安装——把技能文件夹打包上传，适合官方商店里没有收录的技能。

方式二：在编程工具里安装

对于 IDE / CLI / Agent Harness，你完全可以手动操作：把技能文件夹复制到对应的目录里即可。比如 Claude Code 的全局技能目录就在 ~/.claude/skills/ 下：

cp -r my-skill ~/.claude/skills/

问题在于，每个工具认的目录名都不一样（Claude Code、Cursor、opencode……各有各的约定），项目级和全局级路径也不同。手动复制很容易放错地方。

于是就有了那个让一切变简单的工具——npx skills。

---

四、npx skills：技能的"包管理器"

npx skills 是 Vercel 推出的官方命令行工具（仓库见 vercel-labs/skills）。你可以把它理解成"技能世界里的 npm"：它自动帮你识别当前用的是哪个工具、该把文件夹放到哪个路径，号称兼容 40 多种 AI 智能体。

因为是用 npx 调用，你不需要预先全局安装，每次直接跑就行。下面按使用频率过一遍核心命令。

1. 发现技能：find

不知道有没有现成的技能能解决你的问题？先搜一搜：

npx skills find typescript
npx skills find pdf

它会去技能市场索引里检索相关技能。一个实用建议：装之前先看清楚安装量。优先选择安装数过千的技能，几十次安装的要谨慎对待——这是判断一个技能是否"靠谱、经得起实战"的简单标准。

2. 安装技能：add

这是最常用的命令。它会从指定的 GitHub 仓库克隆技能文件夹，并自动复制到当前工具对应的路径：

# 从 GitHub 安装（支持 owner/repo 简写、完整 URL、本地路径）
npx skills add vercel-labs/agent-skills

# 先列出某个仓库里都有哪些技能
npx skills add vercel-labs/agent-skills --list

# 只安装指定的某几个技能
npx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# 安装一个仓库里的全部技能
npx skills add vercel-labs/agent-skills --all

如果技能名里带空格，记得用引号包起来：

npx skills add owner/repo --skill "Convex Best Practices"

3. 全局还是项目级：-g 的取舍

每个工具都支持两种安装范围，这点很重要：

• 项目级：技能只在当前项目里可用。适合那种"只跟这个代码库相关"的专用技能。
• 全局级（加 -g 或 --global）：技能对当前用户的每个会话都生效，跟在哪个项目无关。适合通用能力。

# 装到全局
npx skills add vercel-labs/agent-skills -g

4. 指定给哪些工具：--agent

如果你同时用好几个工具，可以精确控制技能装给谁：

# 同时安装给 Claude Code 和 Cursor
npx skills add vercel-labs/agent-skills -a claude-code -a cursor

# CI/CD 场景下的非交互式安装（-y 跳过确认）
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y

5. 查看、检查、更新

装完之后的日常管理：

npx skills list            # 列出已安装的技能
npx skills ls -g           # 只看全局技能
npx skills ls -a cursor    # 只看 Cursor 下的技能

npx skills check           # 检查有没有可用更新
npx skills update          # 把所有技能升级到最新

6. 卸载技能：remove

# 交互式选择要删的技能
npx skills remove

# 删除指定技能（rm 是它的别名）
npx skills remove web-design-guidelines
npx skills rm my-skill

# 从全局范围删除
npx skills remove --global web-design-guidelines

# 只从指定工具里删
npx skills remove --agent claude-code cursor my-skill

7. 团队协作的"锁文件"

npx skills 借鉴了 npm 的思路，会维护一个锁文件（项目级的 skills-lock.json 可以提交进 Git）。它记录了每个技能的来源和版本，作用跟 package-lock.json 一样：让团队成员在不同机器上还原出完全一致的技能配置。

# 类似 npm ci：按锁文件还原全部技能
npx skills experimental_install

这意味着你可以把技能配置当成项目的一部分纳入版本管理，新同事克隆仓库后一条命令就能装齐所有技能。

---

五、去哪里找好用的技能

光会装还不够，关键是知道哪些技能值得装。几个推荐的发现渠道：

• skills.sh 排行榜（Vercel 出品）：直观展示当前最受欢迎的技能仓库和单个技能的使用情况，支持按"历史总量"“24 小时趋势”"热门"等维度筛选。装之前先来这里看一眼安装量，能避开很多坑。
• 第三方技能商店：比如 skillsmp，它自动抓取了 GitHub 上几乎所有的技能项目，并按分类、更新时间、Star 数等标签整理好，适合系统性地浏览。
• 官方技能集：Anthropic 官方的 anthropics/skills 收录了文档处理（docx、pptx、xlsx、pdf）、前端设计等高质量技能；Vercel 的 vercel-labs/agent-skills 则覆盖 React、Next.js、网页设计等方向，单个技能动辄十万级安装量。

挑选时记住那条朴素的标准：优先选安装量高、经过大量实战验证的技能。

---

六、一个完整的上手流程

把上面的命令串成一条真实的使用路径，大概是这样：

# 第一步：搜一下有没有现成技能
npx skills find "frontend design"

# 第二步：先看看官方仓库里有哪些技能
npx skills add vercel-labs/agent-skills --list

# 第三步：选中需要的，装到全局，指定给 Claude Code
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code

# 第四步：确认装好了
npx skills list

# 之后定期检查更新
npx skills check
npx skills update

整个过程没有写一行配置，没有手动找目录——这正是 npx skills 的价值：把"放对文件夹"这件容易出错的事自动化掉。

---

小结

回到最开始那两句话，它们其实就是理解整个 Skill 生态的钥匙：

1. Skill 跨环境通用——同一个技能既能在 Claude、ChatGPT 这类 GUI App 里用，也能在 Cursor、Claude Code 这类 IDE 和命令行里用，还能跑在 OpenClaw 这类 Agent Harness 上。
2. 安装的本质是放对文件夹——把技能文件夹放到目标工具识别的特定目录，让 AI 按需加载即可。

而 npx skills 做的，就是把第二件事变成一条命令。无论你是想快速试用别人的技能，还是要在团队里统一管理技能配置，它都是目前最省心的入口。

下次再想给你的 AI"加点本事"，不妨先打开终端敲一句 npx skills find，看看社区里已经有什么现成的好东西在等你。