「Codex从入门到精通」系列 · 第8篇 前面我们讲了工作区、线程和 Codex 能做的 10 类工作。这一篇不讲概念,直接带你给 Codex 装上 Skills,并验证是否生效。
如果你已经用 Codex 做过几次任务,大概率会遇到一个问题:
同样的要求,总要反复说。
让它修 Bug,要提醒它先看报错、先列计划、少改文件、跑测试。让它写文章,要提醒它看规划、延续口吻、控制字数、插入文末二维码。让它整理会议纪要,要提醒它不要脑补负责人,不确定就写待确认。
Skill 解决的就是这个问题。
你可以把 Skill 理解成给 Codex 准备的一套专业工具。装好以后,Codex 会根据任务自动判断该用哪个 Skill,不需要你每次都把所有规则重新说一遍。
这一篇只做一件事:带你完成 Skills 的下载、安装和验证。
先看效果:装好以后有什么变化
安装 Skills 后,Codex 不再只是一个通用助手,而是更像带了一套工具箱。
比如你让它处理“项目启动失败”,它可以根据已安装的调试类 Skill,更稳定地按“读报错、找入口、列原因、最小修改、运行验证”的流程处理,而不是每次都靠临场发挥。
Skills 的价值主要有三个:
第一,少重复。很多固定要求可以提前写进 Skill。
第二,更专业。每个 Skill 里有对应场景的流程、检查点和输出格式。
第三,更稳定。你不是每次临时发挥,而是让 Codex 按一套固定方法办事。
但注意,Skill 不是越多越好。新手先装一批常用的,跑通流程,再慢慢筛选。
第一步:去 Skills 市场找 Skill
你可以先去 Skills 市场找现成的 Skill。
这类站点一般会收录大量来自 GitHub 的开源 Agent Skills,可以按名称、分类或热度去找。
新手不用一上来研究太多。
我建议先找这几类:
如果你不知道选哪个,优先选下载量高、说明清楚、来源可信的 Skill。不要随便装来路不明、会执行脚本或访问外部服务的 Skill。
第二步:选择并下载 Skill
点进某个 Skill 的详情页后,先看三件事:
一般下载后会得到一个 .zip 文件。解压以后,里面应该是一个文件夹,核心文件是:
SKILL.md
这个文件就是 Skill 的说明书。Codex 会根据里面的名称、描述和工作规则判断什么时候使用它。
第三步:把 Skill 放到正确目录
安装方法很简单:把解压后的 Skill 文件夹放到 Codex 的 skills 目录里。
macOS / Linux 常见路径:
~/.codex/skills/
Windows 常见路径:
C:\Users\<你的用户名>\.codex\skills\
如果你也使用 Claude,可以放到对应的 Claude skills 目录。这里我们先以 Codex 为主。
实际操作时,不需要运行复杂命令。
第一步,解压下载的 zip 文件。
第二步,把解压出来的整个文件夹拖进 skills 目录。
第三步,重启 Codex。
注意,是拖整个文件夹,不是只拖里面的 SKILL.md。
目录结构应该类似这样:
.codex/
└─ skills/
└─ frontend-design/
└─ SKILL.md
如果你放成下面这样,就不对:
.codex/
└─ skills/
└─ SKILL.md
因为 Codex 需要每个 Skill 有自己的文件夹。
第四步:验证 Skill 是否生效
装完以后,不要急着正式使用。
先验证它有没有被 Codex 加载。
重启 Codex 后,在输入框里输入:
/skills
如果加载成功,你会看到已加载的 Skills 列表,以及大致 token 数。看到列表,就说明安装成功。
如果没有看到新装的 Skill,优先检查这几件事:
- 文件夹是不是放到了
~/.codex/skills/ - 是不是把整个 Skill 文件夹放进去,而不是只放
SKILL.md
这一步很重要。很多人以为自己装好了,其实目录放错了,Codex 根本没加载。
第五步:怎么让 Codex 使用 Skill
正常情况下,你不需要记住每个 Skill 的名字。
Codex 会根据任务判断该用哪个。
比如你可以这样说:
请检查这个项目启动失败的原因。
先不要改文件,先列出排查计划。
如果你装了 debugging、confidence-check、test-driven-development 这类 Skill,它就有机会调用对应能力。
你也可以直接点名:
请使用 debugging Skill,帮我排查这个报错。
内容场景也一样。
比如你已经准备了一个公众号写作 Skill,就可以这样说:
请使用公众号写作 Skill,继续写 Codex 系列第 9 篇。
要求偏实用,给步骤、路径、验证方式,不要写成长篇概念文。
这就是 Skill 的真正价值:把你每次都要重复强调的工作规则,变成默认流程。
进阶:自己写一个 Skill
除了下载现成的,你也可以自己写。
一个最小 Skill,其实就是一个文件夹加一个 SKILL.md。
最小结构:
my-writing-skill/
└─ SKILL.md
SKILL.md 可以这样写:
---
name: practical-wechat-writing
description: Use when writing practical WeChat official account tutorials for AI tools, Codex, automation, and productivity topics.
---
# Practical WeChat Writing
Write practical tutorials, not abstract concept essays.
Rules:
- Start with a real user problem.
- Give exact steps, paths, commands, screenshots, or verification methods.
- Control article length.
- Do not generate screenshot checklist files.
- If images are needed, embed actual usable images.
- End with the public-account QR image.
- Do not append a final reference-verification section.
你看,Skill 并不神秘。
它本质上就是把“你希望 Codex 一直记住的工作方式”写下来。
等你发现某段提示词已经复制了三次,就可以考虑把它变成 Skill。
新手先装哪些 Skill
如果你不知道从哪开始,可以先按自己的工作选。
程序员优先:
内容创作者优先:
普通职场人优先:
不要一口气装几十个。
先装 5 到 10 个常用的,确认 /skills 能加载,再慢慢补。
今天做到这里就够了
这篇你只需要完成 4 件事:
第一,去 Skills 市场找一个可信的 Skill。
第二,下载 zip 并解压。
第三,把整个 Skill 文件夹放进 ~/.codex/skills/。
第四,重启 Codex,用 /skills 验证是否加载成功。
跑通这 4 步,你就真正把 Codex 从“通用助手”往“专业工作台”推进了一步。
下一篇,我们继续讲一个更重要的心法:
把 Codex 当同事,而不是搜索框。
星言星语Skill 不是给 AI 加特效,而是把你反复验证过的工作方法,变成下一次可以直接调用的能力。
星辰AI拾贝 | 一个 IT 人的 AI 学习记录站。
我会持续分享 AI 编程、Codex 入门、AI 效率提升、自动化办公这些真实踩过的坑和能直接抄的经验。
关注公众号回复codex橙皮书领取电子版