Skills 安装教程：从 0 开始安装并使用 Skills

本文介绍如何从 0 开始安装 Skills，包括 Node.js、npm、npx、Git 等前置环境准备，Skills 的基础安装方式，以及如何安装特定 skill。文章还会结合实际交互界面说明安装时的关键选项，比如 agent 选择、Global 与 Project 的区别，以及为什么通常推荐 Symlink。最后会以 doc-coauthoring 为例，演示一条可直接执行的安装命令。

如果你平时会使用 Codex、Cursor、Claude Code、Cline、GitHub Copilot 这类 AI 编码工具，应该很快就会遇到一个问题：

单次对话很好用，但一旦任务开始重复、开始复杂、开始需要固定流程，纯靠 prompt 就不太够了。

这时候，Skills 就很适合用来补上这块能力。

可以把 Skill 理解成：给 AI agent 安装一个“专门的能力包”或者“固定工作流”。
安装之后，agent 在遇到对应任务时，就能按照预设好的流程、说明和规则来工作。

这篇文章就不讲太多抽象概念了，直接从实战出发，带大家完成一件事：

把 Skills 真正安装起来，并学会安装某个特定的 skill。

本文会重点演示这条命令：

npx skills add https://github.com/anthropics/skills --skill doc-coauthoring

如果你只是想先快速上手，可以记住一句话：

推荐先从 https://skills.sh 开始，文档和技能发现都比较方便。

---

一、什么是 Skills

Skills 可以理解为一层“可复用能力”。

比如，平时你可能会反复让 agent 做这些事：

• 写 PRD
• 写 RFC
• 写 proposal
• 分析仓库结构
• 生成测试方案
• 做网页自动化
• 处理文档格式

如果每次都重新写一大段 prompt，不仅麻烦，而且输出不稳定。
而 Skill 的作用，就是把这些固定流程沉淀下来，让 agent 在合适的时候自动使用。

换句话说：

Prompt 更像临时对话，Skill 更像长期可复用的能力模块。

---

二、为什么推荐从 skills.sh 开始

对于第一次接触 Skills 的读者，更推荐直接从 skills.sh 入手。

原因很简单：

1. 它既能用来找 skills，也能看安装文档
2. 可以直接复制安装命令
3. 对新手比纯 GitHub 仓库更友好

所以如果你是第一次接触这个生态，建议先打开：

https://skills.sh

先浏览一下有哪些 skill，再决定装什么。

---

三、安装 Skills 之前，需要准备什么

在安装 Skills 之前，先准备好基础环境。
如果这些前置环境没有装好，后面执行命令时大概率会报错。

1）安装 Node.js

因为 Skills 的常见安装方式是通过 npx 来执行，所以电脑里需要先安装 Node.js。

安装完成后，通常会自带：

• node
• npm
• npx

安装完后，可以在终端执行下面几个命令检查是否成功：

node -v
npm -v
npx -v

如果都能正常输出版本号，就说明这部分环境基本没问题。

2）安装 Git

很多 skills 都是从 GitHub 仓库安装的，所以建议提前装好 Git。

检查方法也很简单：

git --version

如果能正常输出版本号，就可以继续下一步。

---

四、Skills 最基础的安装方式

最常见、最推荐的安装方式就是：

npx skills add <仓库或技能地址>

例如：

npx skills add vercel-labs/agent-skills

这条命令的意思就是：
通过 skills CLI，把指定仓库里的 skills 安装到你的 agent 环境中。

如果你以前没接触过，可以先这样理解：

• npx：直接运行 CLI 工具
• skills add：安装 skill
• 后面的地址：skill 来源

---

五、安装特定 Skill：以 doc-coauthoring 为例

除了安装整个仓库，更常见的场景是：

只安装一个具体 skill。

比如，如果你只想安装一个专门用于文档协作写作的 skill，可以直接执行：

npx skills add https://github.com/anthropics/skills --skill doc-coauthoring

这个 doc-coauthoring 很适合这些场景：

• 写技术方案
• 写产品文档
• 写 PRD
• 写 RFC
• 写 proposal
• 写 spec

如果你平时经常让 agent 帮你一起整理文档、搭文档结构、完善思路，这个 skill 很值得装。

---

六、安装过程中怎么选：一步一步看懂交互界面

第一次安装时，很多人不是不会敲命令，而是不知道交互界面该怎么选。
这一部分就结合实际安装流程，讲清楚几个关键选项。

---

1）选择安装到哪些 agents

运行安装命令后，通常会先看到一个 agent 选择界面。
这里会列出当前支持的一批 agent，例如：

• Amp
• Cline
• Codex
• Cursor
• Gemini CLI
• GitHub Copilot
• Kimi Code CLI
• OpenCode
• Warp

有些工具会默认出现在通用列表里，另外还有一些会在 Additional agents 里出现。

这一步的意思是：

你想把这个 skill 装给哪些 AI 工具用。

如果你只在 Codex 里用，那就只选 Codex。
如果你平时会在 Codex、Cursor、Claude Code 之间切换，那建议选择Antigravity。

图 1：安装时可以选择 skill 要安装到哪些 agents。

---

2）选择安装范围：Project 还是 Global

选完 agent 之后，通常会继续让你选择安装范围。

常见会看到两个选项：

• Project
• Global

这两个很好理解：

Project

只在当前项目里可用。
适合某个 skill 只服务于当前仓库或当前团队项目。

Global

安装到用户目录，在所有项目中都可用。
适合个人长期使用，一次安装，后面多个项目都能直接复用。

如果你只是个人使用，或者你希望以后每个项目都能直接用到这个 skill，通常更推荐选：

Global

图 2：如果希望 skill 在所有项目中都可用，一般选择 Global。

---

3）选择安装方式：Symlink 还是 Copy

接下来一般还会看到安装方式选择，常见有两个：

• Symlink
• Copy to all agents

这一步也非常关键。

Symlink

推荐选择。
它的思路是：只保留一份 skill 的真实内容，然后在各个 agent 目录里建立符号链接。

优点是：

• 只有一份源文件
• 后续更新更方便
• 多个 agent 共用同一份 skill
• 不容易出现多个副本不一致的问题

Copy

把 skill 直接复制到每个 agent 目录中。

这种方式也能用，但后续维护成本更高。
除非你的环境对符号链接支持不好，否则一般不需要优先选它。

所以大多数情况下，更推荐：

Symlink

图 3：通常推荐使用 Symlink，便于后续统一更新和维护。

---

七、安装完成后，怎么确认有没有装成功

安装完成后，最好检查一下 skill 是否真的已经装好了。

可以执行：

npx skills list

如果想看全局安装的 skills，也可以继续查对应环境里的安装位置。
通常来说，只要安装过程没有报错，并且列表里能看到目标 skill，就说明安装成功了。

---

八、安装完成后怎么用

这也是很多人第一次会问的问题：

“装完之后，我还需要手动调用它吗？”

一般来说，不需要你每次都显式“打开插件”。
安装完成后，当 agent 遇到相关任务时，就会更容易匹配到对应的 skill。

这里也建议直接告诉你的agent应该使用哪种skill。

以 doc-coauthoring 为例，安装之后，当你开始做这些事情时，它就更容易发挥作用：

• 让 agent 帮你写 PRD
• 让 agent 帮你整理 RFC
• 让 agent 帮你搭技术方案结构
• 让 agent 帮你写 proposal
• 让 agent 帮你完善文档逻辑

也就是说，装好 skill 之后，你的 agent 在对应任务上的表现会更“像有方法论”，而不是每次都从零开始组织。

---

九、推荐值得先装的 Skills

如果是第一次接触 Skills，不知道应该先装哪一个，我更推荐先安装：

npx skills add https://github.com/vercel-labs/skills --skill find-skills

find-skills 的作用很实用：
它不是直接帮你完成某一类具体任务，而是帮你更快找到适合当前场景的 skill。

很多人刚开始用 Skills 时，最大的难点其实不是“不会安装”，而是：

• 不知道有哪些 skill 可用
• 不知道当前任务适合哪个 skill
• 不知道应该先装哪一个

这时候，find-skills 就很适合作为第一个安装的 skill。
因为它更像一个“技能发现器”或者“技能导航器”，可以帮助用户在真正开始使用 Skills 生态时，先解决“找 skill”这个问题。

如果把 Skills 生态比作一个工具箱，那么 find-skills 的作用就是：

先帮你找到该拿哪把工具。