Codex 的 Skills 列表里装了十几个包，真正做任务时却仍靠一段很长的提示词，这是“已经安装”和“能稳定调用”之间的差距。扩展实用 Skills 不是追求数量，而是让 Codex 在正确范围发现它、在正确请求触发它，并保留脚本与引用文件完成整条工作流。

把扩展拆成发现、触发、执行

发现

Codex 先读取 Skill 的名称、描述和文件路径。放错目录时，内容写得再好也不会出现。

触发

任务匹配 description 时可隐式调用；也能在 CLI 或 IDE 用 /skills 或输入 $ 显式选择。描述过宽会误触发，过窄则总要手动点名。

执行

选中后 Codex 才读取完整 SKILL.md，并按需使用同目录脚本、引用和素材。缺少附件时，复杂 Skill 只能执行一部分。

安装范围决定谁能看到

范围	当前 Codex 发现位置	更合适的用法
当前目录	$CWD/.agents/skills	只服务某个模块或临时工作区
仓库根	$REPO_ROOT/.agents/skills	团队共用、随代码评审的工作流
个人	$HOME/.agents/skills	跨多个项目反复使用
系统	/etc/codex/skills	机器或容器统一提供的能力

khazix-skills 的旧速查文件还写着 ~/.codex/skills。当前 Codex 环境若没有从那里发现包，不必继续试探软链接，直接用系统的 $skill-installer 安装外部目录，或按现行文档放到 .agents/skills。路径变化是兼容问题，不是 Skill 内容损坏。

把 khazix-skills 放进 Codex，有两条实用路线

1. 个人试用。调用 $skill-installer，给出某个子目录地址，并要求安装前报告目标文件。适合先试 neat-freak 或 aihot。
2. 项目固化。把经过审阅的单个 Skill 放进仓库级 .agents/skills，随项目一起版本控制。若脚本会写文件或联网，团队应在合并前看完权限边界。

按工作节点路由，不要把五个包同时叫醒

• 开发结束、文档可能漂移：显式选择 $neat-freak，或说“整理当前项目文档并审计规则”。
• 需要当天 AI 动态：选择 $aihot，给出明确时间窗和主题。
• 需要系统研究：选择 $hv-analysis，写清研究对象、动机和特别关注点。
• 已有可信素材，要写公众号长文：选择 $khazix-writer，同时说明目标读者和篇幅。

如果一次提示同时要求“查新闻、做竞品研究、写文章、整理项目”，多个描述都会命中，Agent 很难判断先后关系。更稳的做法是拆成独立任务，每一步验收产物后再交给下一步。

装得多，也会有上下文成本

Codex 会把可用 Skills 的初始列表控制在上下文预算内；数量很大时，会先缩短描述，仍超出则可能省略部分 Skill 并给出提示。某个包安装成功却不在首屏，不代表文件消失。先用 /skills 或 $ 显式选择，再考虑删掉长期不用的包。

一次有效扩展至少满足四点：名称可见、路径明确、最小任务能触发、脚本依赖能完成。只验证“目录已经存在”，还不足以证明工作流真的可用。