Codex 新增 skill-creator 样本：文件夹 + YAML 技能子系统对标 Claude Skills，开发者切换成本大降
OpenAI 官方 Codex 仓库里多了一份 skill-creator 样本，等于承认 Codex 有了自己的技能子系统，而且目录结构和 Claude Skills 高度同构。对用 AI 跑选品、文案、客服自动化的跨境团队来说，这意味着自建技能以后换工具不用重写。
技能就是一个文件夹：SKILL.md 加 YAML frontmatter
样本落在 openai/codex 仓库的 codex-rs/skills/src/assets/samples/skill-creator/ 路径下，文件本身就是一份"用技能教人写技能"的元技能。按它的定义，一个技能不是一段提示词，而是一个文件夹：根目录下必须有 SKILL.md，头部是一段 YAML frontmatter，其中 name 与 description 两个字段是必需的——它们也是 Codex 在挑选技能时唯一会读到的内容，因此描述写得准不准，直接决定这个技能会不会被正确触发。正文是 Markdown 指令，只在技能被触发之后才加载。文件夹里还可以带 scripts/、references/、assets/ 与 agents/openai.yaml 四个可选子目录，分别放可执行脚本、按需加载的文档、输出用素材和界面元数据。命名规则很硬：小写字母加连字符，长度不超过 64 个字符；默认安装位置是 $CODEX_HOME/skills，没有设置环境变量时回退到 ~/.codex/skills。
三级渐进披露与「自动调用」开关
样本把技能的加载拆成三段：选择阶段只暴露 name 和 description；技能被判定适用时才读 SKILL.md 正文；只有任务真的需要时，才去读 references 里的补充文档。这套设计的目标是省上下文——样本的第一条核心原则写得很直白："假设 Codex 本身已经足够能干"，只补充它不知道的信息，并要求逐条自问"这段解释值不值它的 token 成本"。调用策略上，自动选择默认开启；如果希望技能只在被点名时生效，可以在 agents/openai.yaml 里写 policy: allow_implicit_invocation: false，此后只有用户在对话里输入 $skill-name 才会加载。权限口径也写在样本里："完成任务的授权不等于扩大它的范围或执行权限"，涉及外部改动的重试流程，必须定义与风险相称的停止条件。
随样本附带的三个脚本，以及 quick_validate 的诚实边界
技能目录里带了三个可执行脚本：init_skill.py 负责生成技能脚手架，generate_openai_yaml.py 负责产出 agents/openai.yaml，quick_validate.py 负责校验。除此之外还附了 openai_yaml.md 参考文档、一个 SVG 图标和许可证文件。真正值得留意的是样本对校验能力的态度——它明确写着自己只检查 frontmatter、命名和未完成的脚手架占位符，"不能证明这个技能能做出好的判断"。这句话把工程界线划得很清楚：格式合规是机器能保证的，效果好不好只能靠拿真实任务去跑。样本还专门用一节讲验证的完整性，建议迭代时用子代理做独立评测，但不要把预期答案、可疑 bug、预想的修法或自己此前的结论喂给验证方，否则测出来的只是它能不能复述你的答案，而不是技能能不能泛化。
与 Claude Skills 同构：切换成本降在哪里
把两边的目录摆在一起看，差别小到可以忽略：同样是一个文件夹、同样一份带 YAML frontmatter 的 SKILL.md、同样把可执行脚本和参考文档分到 scripts/ 与 references/，连校验脚本的名字都叫 quick_validate.py。Anthropic 用这套格式定义 Claude Skills，OpenAI 现在用几乎同一套格式定义 Codex Skills。对开发者的实际意义是：为一个 coding agent 写好的技能资产，迁移到另一个 agent 时主要改的是调用语法的细节，而不是推倒重来。Codex 侧多出来的部分主要是 agents/openai.yaml 这类界面元数据，以及显式的 $skill-name 调用方式。技能层级上，Codex 支持个人、仓库、系统与内置四层，同名技能不会被合并，而是同时出现在可选列表里，允许在个人层覆盖团队或系统层的实现。
注意事项
本文事实来自 Codex 官方仓库中的 skill-creator 样本文件及第三方技能目录站点的整理，未做代码级实测。落盘位置、脚本清单与校验能力描述均以仓库当前内容为准，OpenAI 尚未就此发布正式产品公告，后续路径与字段可能调整。样本自述的校验边界尤需认真对待：quick_validate.py 通过并不等于技能可用。目录位置、命名规则与调用开关属配置约定，不同 Codex 版本可能不一致，落地前请在本地实测。
FAQ
Q：这份 skill-creator 样本对不写代码的跨境卖家有什么用？ A：直接用处有限，但间接价值明确。如果你的团队在做店铺自动化、批量文案或多语言客服，通常会把流程沉淀成技能包；格式统一之后，这些资产不必绑定某一家 agent，换工具的成本从"重写"降到"改配置"。
Q：技能里为什么要把可执行脚本单独放进 scripts/ 目录？ A：为了省上下文。脚本是可被调用的确定性代码，不需要整段塞进提示词；模型只在需要执行时调用它。这样既避免把大段逻辑变成 token 成本，也降低模型每次自行重写逻辑带来的不确定性。
Q：自动调用和 $skill-name 显式调用，应该怎么选？ A：看容错要求。流程固定、触发条件清晰的技能适合自动调用；一旦技能会改动文件、调用外部接口或涉及费用，建议关掉隐式调用，改成显式点名，避免在不该触发的场景里被自动加载。
参考来源
- GitHub（openai/codex 官方仓库）：《codex-rs/skills/src/assets/samples/skill-creator/SKILL.md》
- AI Weekly：《OpenAI Codex ships skill-creator sample for reusable agent instructions》
- Skillselion（技能目录，收录 openai/codex 官方技能）：《Skill Creator》
- 格律诗的软件世界：《VSC Skills – VSC 社区 5 个 AIGC 创作 Skill｜Codex 提示词 Skill 合集》
- 尧图网站制作：《从零构建 Codex 智能体技能：解锁复杂任务自动化》