夜雨聆风学习资料网

ARTICLE · 1258943

Codex Skills 安装教程

Codex Skills 安装教程

SKILLS 入门 · 安装篇

Codex Skills
安装教程

从装环境到装好第一个 Skill
把交互界面里的每个选项都讲清楚

一条核心命令  ·  九个部分  ·  真实截图对照

TL;DR — 三步速通

1装好 Node.js 和 Git

2执行 npx skills add 加地址

3弹窗里选 Global + Symlink

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

可以把 Skill 理解成:给 AI agent 安装一个「专门的能力包」,或者一套「固定工作流」。

PART 01

什么是 Skill

Skills 可以理解为一层「可复用能力」。Prompt 更像临时对话,Skill 更像长期可复用的能力模块。

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

写 PRD、RFC、proposal

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

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

PROMPT
SKILL
临时对话
长期能力模块
每次重写一遍
装一次,长期复用
输出不稳定
流程固定,结果稳定

一句话:Prompt 是聊天,Skill 是装备

PART 02

为什么推荐从 skills.sh 开始

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

入口

skills.sh

公众号正文里的网址不能点。复制这个域名,粘到浏览器地址栏打开。

PART 03

安装之前,先准备两样东西

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

01安装 Node.js

因为 Skills 的常见安装方式是通过 npx 来执行,所以电脑里需要先装 Node.js。安装完成后,通常会自带 node、npm、npx。

装完重开终端,执行下面几个命令检查:

●●●  终端

$ node -v$ npm -v$ npx -v

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

02安装 Git

很多 skills 都是从 GitHub 仓库安装的,所以建议提前装好 Git。检查方法也很简单:

●●●  终端

$ git --version
命令
通过标准
node -v
输出版本号
npm -v
输出版本号
npx -v
输出版本号
git --version
输出版本号

提示「不是内部或外部命令」,先关掉终端重开一次。还不行就是安装时 PATH 没勾上,卸载重装。

PART 04

Skills 最基础的安装方式

最常见、最推荐的安装方式就是这一条:

●●●  基础命令

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

例如:

●●●  实际例子

$ npx skills add vercel-labs/agent-skills

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

拆开看,三个部分

npx直接运行 CLI 工具,不用先全局安装

skills add安装 skill 的子命令

地址skill 的来源,仓库或具体技能

记住这三段,后面所有命令都是它的变体

PART 05

只装一个:以 doc-coauthoring 为例

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

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

●●●  安装单个 skill

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

关键在结尾的 --skill,它把「整个仓库」收窄成「点名那一个」。

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

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

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

PART 06

安装过程中怎么选

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

① agent  →  ② 范围  →  ③ 方式  →  完成

01选择安装到哪些 agents

运行安装命令后,通常会先看到一个 agent 选择界面,列出当前支持的一批 agent:

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

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

图 1|安装第一步:选择 agent。绿色圆点是已勾选,箭头由空格键切换

用 ↑↓ 移动,空格勾选,回车确认——别按成 Esc,那会直接退出安装。

02选择安装范围:Project 还是 Global

选完 agent 之后,通常会继续让你选择安装范围。常见会看到两个选项:

Project

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

Global 推荐

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

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

图 2|安装范围。光标默认停在 Project,记得移到 Global

03选择安装方式:Symlink 还是 Copy

接下来一般还会看到安装方式选择,常见有两个:Symlink 和 Copy to all agents。

Symlink 推荐

只保留一份 skill 的真实内容,然后在各个 agent 目录里建立符号链接。

✓  只有一份源文件

✓  后续更新更方便

✓  多个 agent 共用同一份 skill

✓  不容易出现多个副本不一致

Copy to all agents

把 skill 直接复制到每个 agent 目录中。这种方式也能用,但后续维护成本更高。除非你的环境对符号链接支持不好,否则一般不需要优先选它。

图 3|安装方式。Symlink 后面标了 Recommended

所以大多数情况下,更推荐:Symlink。

PART 07

怎么确认有没有装成功

安装完成后,最好检查一下 skill 是否真的已经装好了。可以执行:

●●●  查看已安装

$ npx skills list

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

PART 08

装完之后怎么用

这也是很多人第一次会问的问题:「装完之后,我还需要手动调用它吗?」

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

更省事的做法:直接告诉你的 agent 该用哪种 skill。它会更准确地命中,而不是自己猜。

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

01  让 agent 帮你写 PRD

02  让 agent 帮你整理 RFC

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

04  让 agent 帮你写 proposal

05  让 agent 帮你完善文档逻辑

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

PART 09

第一个该装什么:find-skills

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

●●●  推荐第一个安装

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

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

很多人刚开始用 Skills 时,最大的难点其实不是「不会安装」,而是:

不知道有哪些 skill 可用

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

不知道应该先装哪一个

这时候,find-skills 就很适合作为第一个安装的 skill。因为它更像一个「技能发现器」或者「技能导航器」,可以帮你先解决「找 skill」这个问题,再谈怎么用。

Skill 真正的价值不是「装上了」,而是你终于可以把「每次都要跟它说一遍」的东西,变成「装一次就一直在」。

安装只是入口,用完第一次之后,你才会知道它到底省了你多少事。

下一步

装好 find-skills,让它替你找第二个

问它一句「我现在要做 XX,该用哪个 skill」——这比自己翻文档快得多。

相关学习资料