Codex 和 Claude Code 必装的 10 个 Skills

Skill 到底是什么

Skill 是给 Agent 用的可复用工作流。你把触发条件、执行步骤、检查清单、参考资料写进一个目录，Codex 或 Claude Code 在相关任务里按需加载。

它解决的不是“让 Agent 更聪明”，而是减少重复交代。比如代码审查先报问题、修 CI 先看日志、写 OpenAI 教程先查官方文档、前端改完必须看页面，这些都适合做成 Skill。

按这个分工来用：

• `AGENTS.md` / `CLAUDE.md`：项目长期规则。
• Skill：可复用工作流和检查清单。
• MCP：连接外部系统和实时数据。
• Hook：做强制拦截和自动校验。

Codex 怎么安装 Skill

Codex 的 Skill 是一个带 `SKILL.md` 的目录，可以附带 `scripts/`、`references/`、`assets/` 等支持文件。个人通用 Skill 放到个人目录，团队项目 Skill 放到项目目录。

如果你第一次写 Skill，先用 `$skill-creator` 生成骨架。要安装已有 Skill，可以用 `$skill-installer`。手动维护时，把目录放到 `.agents/skills/<skill-name>/SKILL.md`。

Claude Code 怎么安装 Skill

Claude Code 使用 `.claude/skills/` 目录。个人通用 Skill 放到 `~/.claude/skills/`，项目 Skill 放到当前仓库的 `.claude/skills/`。

Claude Code 支持手动调用 Skill。Codex 常用 `$skill-name`，Claude Code 使用 `/skill-name`。新建顶层 skills 目录后，如果当前会话没有识别，重启一次 Claude Code。

1. skill-creator：让 Agent 帮你写 Skill

第一个要装的是 `skill-creator`。它用来采访你：这个 Skill 解决什么问题、什么时候触发、需要哪些步骤、要不要脚本、要不要模板。

适合把这些重复要求固化下来：

第一次不要追求复杂目录。先让它生成只有 `SKILL.md` 的版本，确认能触发，再补 `scripts/` 或 `references/`。

• 每次代码审查都要先报风险。
• 每次写教程都要先查官方文档。
• 每次改 UI 都要做桌面和移动端检查。
• 每次写公众号稿都要去掉模板腔。

2. skill-installer：安装可信来源的 Skill

`skill-installer` 用来安装 curated skills 或可信仓库里的现成 Skill。新机器初始化、团队统一环境、试用第三方 Skill 时，它比手动复制目录更稳。

安装前先看来源。Skill 可能附带脚本、工具权限和动态上下文，不要把陌生仓库里的 Skill 直接塞进个人目录。

`skill-installer` 不一定要最先用。先知道自己缺什么，再去装别人写好的 Skill。否则目录里很快会堆出一批看起来都能用、真正任务里触发不了的 Skill。

3. code-review：让 Agent 按 reviewer 标准看代码

`code-review` 用来把 Agent 从“帮我看看”拉回真实 code review。它应该先报问题，再写总结，不要先夸改动。

重点看这些：

这个 Skill 适合 PR review、提交前自查、复杂 diff 检查。输出里最好有文件位置、风险等级和可复现理由。

• 真实 bug。
• 行为回归。
• 安全风险。
• 缺失测试。
• 迁移和兼容性问题。

4. fix-ci：处理本地通过但 CI 失败

`fix-ci` 用来处理 GitHub Actions、类型检查、构建失败、测试随机挂。它的价值是固定排查顺序，不让 Agent 一上来乱改代码。

排查顺序应该是：

如果你用 GitHub CLI，可以把 `gh pr checks`、`gh run view`、`gh run download` 这些命令写进 Skill 的脚本或步骤里。

• 先读失败日志。
• 找到最小失败用例。
• 本地复现或解释为什么不能复现。
• 小步修复。
• 只重跑相关检查。

5. openai-docs：写 OpenAI 和 Codex 内容先查官方文档

`openai-docs` 用来处理 OpenAI API、Codex CLI、Codex app、Responses API、Agents SDK、模型迁移和参数变化。

这类内容最容易过期。模型名、配置项、API 参数和产品入口都会变。Skill 要求 Agent 先查官方文档，找不到就说找不到，不要靠记忆补。

写教程、改集成、解释 Codex surface、比较模型能力时，都应该先触发这个 Skill。

6. browser：前端改完必须真看页面

`browser` 用来阻止 Agent 只跑构建就说 UI 没问题。前端项目需要真实打开页面。

它应该要求 Agent 做这些检查：

React、Vue、Next、Nuxt、管理后台、小游戏、落地页、组件库都该加这一关。

• 启动本地服务。
• 打开目标页面。
• 截图检查。
• 点击关键交互。
• 看移动端布局。
• 确认没有空白、遮挡、溢出。

7. frontend-design：约束 Agent 的默认 UI 审美

`frontend-design` 用来约束 Agent 的默认 UI 输出。它应该写清按钮、表单、卡片、密度、颜色、动效、移动端断点和可访问性要求。

可以明确禁止这些默认坏味道：

做页面、改 UI、生成 dashboard、写落地页时，用它统一审美和验收标准。

• 大面积蓝紫渐变。
• 空洞 hero 文案。
• 卡片套卡片。
• 一屏只有装饰没有功能。
• 按钮文字挤出容器。
• 移动端元素互相遮挡。

8. docs-writer：把项目文档写到能跑起来

`docs-writer` 用来写 README、SDK 文档、内部接入文档、升级说明。目标不是写得漂亮，而是让读者能跑起来。

文档顺序应该固定：

如果 README 只有概念，没有安装命令、运行命令和错误处理，这个 Skill 就应该把它重写到可执行。

• 这个项目解决什么问题。
• 最短安装路径。
• 最小运行命令。
• 常见错误。
• 真实示例。

9. stop-slop：清掉公众号和 PR 描述里的模板腔

`stop-slop` 用来处理公众号、PR 描述、产品文案和技术文章。它不是把文章改得更“高级”，而是删掉无信息量的 AI 写作痕迹。

重点删这些：

技术文章要保留版本、错误日志、命令、验证标准和证据来源。删掉的是噪音，不是事实。

• “接下来我们将”。
• “值得注意的是”。
• “这是一场范式转移”。
• 空泛转折。
• 没有信息量的金句。
• 看起来会总结但不给下一步的段落。

10. security-check：拦住 Agent 写进代码里的风险

`security-check` 用来检查 Agent 补功能时顺手引入的风险。后端接口、MCP server、脚本工具、部署配置、自动化任务都需要这一层。

至少盯住这些点：

这个 Skill 最好在提交前手动触发一次。高风险项目不要完全依赖自动判断。

• 命令注入。
• 路径穿越。
• 硬编码密钥。
• SSRF。
• 过宽 CORS。
• 不安全反序列化。
• 日志里泄露 token。
• Agent 工具权限过宽。

推荐安装顺序

今天只装一轮，就按这个顺序：

`skill-installer` 放最后，是因为你要先知道自己缺什么，再去装别人写好的 Skill。否则很容易堆出一批目录，真正任务里却触发不了。

• skill-creator
• code-review
• fix-ci
• openai-docs
• browser
• frontend-design
• docs-writer
• stop-slop
• security-check
• skill-installer

description 决定 Skill 会不会触发

大多数 Skill 失效，不是正文写得不够长，而是 `description` 太泛。Agent 先看 description，再决定是否加载。

不要写：

写成这样：

description: Use when building or reviewing web UI. Enforce responsive layout, readable spacing, real interaction states, and visual QA with browser screenshots.

Skill 不要装太多

Skill 装太多会增加判断成本。Codex 官方文档说明，Codex 会把可用 Skill 的初始列表放进上下文，但这个列表有预算限制；如果装得太多，描述可能被截短，甚至有些 Skill 进不了初始列表。

Claude Code 也有上下文成本。Skill 正文只在使用时加载，但一旦加载，长说明仍然会占用会话空间。

按这几条控制规模：

先把这 10 个用起来。后面遇到真实重复问题，再加新的 Skill。

• 个人目录只放通用能力。
• 项目目录只放项目流程。
• 高风险动作设成手动触发。
• 带脚本的 Skill 只装可信来源。
• 每个 Skill 只做一件事。

参考来源

相关文章