Codex Skills 安装教程

单次对话很好用，但一旦任务开始重复、开始复杂、开始需要固定流程，纯靠 prompt 就不太够了，可以把 Skill 理解成，给 AI agent 安装一个“专门的能力包”或者“固定工作流”。​

一、什么是 Skill，​

​

😀

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

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

​

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

•

写 PRD、 RFC、proposal​

•

分析仓库结构、生成测试方案、做网页自动化、处理文档格式​

如果每次都重新写一大段 prompt，不仅麻烦，而且输出不稳定。​

而 Skill 的作用，就是把这些固定流程沉淀下来，让 agent 在合适的时候自动使用。​

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

对于第一次接触 Skills 的读者，更推荐直接从 skills.sh 入手，它既能用来找 skills，也能看安装文档，可以直接复制安装命令​

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

​

代码块​

Plain Text

h*****//skills.sh​

​

​

​

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

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

1）安装 Node.js​

2）安装 Git​

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

检查方法也很简单：​

​

代码块​

Plain Text

​

四、Skills 最基础的安装方式​

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

​

代码块​

Plain Text

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

​

例如：​

​

代码块​

Plain Text

npx skills add vercel-labs/agent-skills​

​

这条命令的意思就是：​

通过 skills CLI，把指定仓库里的 skills 安装到你的 agent 环境中。​

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

•

npx：直接运行 CLI 工具​

•

skills add：安装 skill​

•

后面的地址：skill 来源​

​

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

除了安装整个仓库，更常见的场景是：只安装一个具体 skill。​

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

​

代码块​

Plain Text

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 、Kimi Code CLI、OpenCode、Warp​

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

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

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

常见会看到两个选项：Project、Global​

​

😀

Project​

只在当前项目里可用。​

适合某个 skill 只服务于当前仓库或当前团队项目。​

Global​

安装到用户目录，在所有项目中都可用。​

适合个人长期使用，一次安装，后面多个项目都能直接复用。​

​

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

​

代码块​

Plain Text

Global​

​

​

​

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

接下来一般还会看到安装方式选择，常见有两个：Symlink、Copy to all agent​

​

😀

Symlink​

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

优点是：​

只有一份源文件​

后续更新更方便​

多个 agent 共用同一份 skill​

​

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

​

​

​

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

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

可以执行：​

​

代码块​

Plain Text

npx skills list​

​

如果想看全局安装的 skills，也可以继续查对应环境里的安装位置。​

通常来说，只要安装过程没有报错，并且列表里能看到目标 skill，就说明安装成功了。​

​

八、安装完成后怎么用​

这也是很多人第一次会问的问题：“装完之后，我还需要手动调用它吗？”​

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

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

​

以 doc-coauthoring 为例​

安装之后，当你开始做这些事情时，它就更容易发挥作用：​

让 agent 帮你写 PRD​

让 agent 帮你整理 RFC​

让 agent 帮你搭技术方案结构​

让 agent 帮你写 proposal​

让 agent 帮你完善文档逻辑​

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

​

​

九、推荐值得先装的 Skills​

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

​

代码块​

Plain Text

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

​

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

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

不知道有哪些 skill 可用​

不知道当前任务适合哪个 skill​

不知道应该先装哪一个​

这时候，find-skills 就很适合作为第一个安装的 skill。​

因为它更像一个“技能发现器”或者“技能导航器”，可以帮助用户在真正开始使用 Skills 生态时，先解决“找 skill”这个问题。​