Codex 如何安装 Skills？npx skills 使用方法详解

在 Codex 里装 Skills，目标不是“把仓库塞进去”这么简单，而是让 Codex 在合适的任务里自动读到对应能力说明。`npx skills` 适合处理这件事：它能从仓库、URL 或本地路径解析 Skill，再安装到目标 Agent 的技能目录。对 Codex 用户来说，关键不是命令有多短，而是安装范围和目标 Agent 是否选对。

先判断 Codex 是否真的需要这个 Skill

Codex 已经能写代码、读文件、跑测试，但某些重复流程仍适合做成 Skill，比如项目专用发布规范、前端组件验收、性能排查清单、团队内部 API 调用步骤。适合安装的信号是：这个流程会反复出现，并且每次都需要相同判断标准。不适合安装的情况是单次问答。把一次性需求做成 Skill，后面只会增加上下文负担。

Codex 场景下的安装顺序

1. 先用 `npx skills add --list` 看仓库里有哪些 Skill。
2. 确认要装的 Skill 名称，再用 `--skill` 精确安装。
3. 如果只给 Codex 用，安装时指定对应 agent；如果团队还用 Claude Code，再决定是否同时安装。
4. 团队项目优先项目级安装，个人常用规则再考虑 `-g`。

这个顺序的好处是少装无关能力。失败场景也直接：没有先 list，结果把仓库里所有 Skill 都装上，Codex 每次任务都要面对一堆不相关说明，输出反而变慢、变散。

装完怎么确认 Codex 读到了

不要只看命令执行成功。可以让 Codex 做一个很小的任务，观察它是否按 Skill 的要求行动。比如安装了测试流程 Skill，就让它处理一个小 bug，看它是否先定位用例、再运行测试、最后说明风险。如果它完全没提 Skill 里的流程，优先检查安装目录、agent 参数和当前项目路径。很多时候不是 Codex 不听话，而是 Skill 没装到它会读取的位置。

项目里要留下可追踪痕迹

Codex 场景里，我更倾向把团队共享 Skill 放在项目级，而不是只放个人全局目录。原因很直接：项目级安装更容易被同事看到，也更容易在代码评审里讨论。比如一个仓库要求 Codex 修改数据库迁移前先跑本地检查，这种流程就应该跟项目走。失败场景是某个成员全局装了强约束 Skill，写出的改动很谨慎，另一个成员没有这个 Skill，生成逻辑完全不同，团队还以为是模型差异。

如果只是个人习惯，例如“回答前先列风险”或“提交前帮我整理清单”，全局安装更轻。两类不要混。把团队规则装全局，会让项目失去可复查性；把个人偏好提交到项目，又会打扰其他人。`npx skills` 给了安装范围，真正要做选择的是使用者。

更新和移除也要进流程

Codex 项目跑久了，Skill 会变成隐形依赖。建议把 `npx skills list`、`npx skills update` 和 `npx skills remove` 当成维护动作，而不是临时命令。版本旧了会让 Agent 继续按旧规范做事；无用 Skill 留太多，会干扰新任务判断。安装只是第一步，能定期清理，Codex 才不会被过期规则拖住。