一句话看懂：一位开发者写了 50 个 Claude Code Skill 后复盘发现，前 30 个因设计思路错误基本作废；与此同时 OpenAI Codex 也开始采用几乎相同的 SKILL.md 格式，Skill 正在从 Anthropic 的私有玩法变成 AI 编程工具的事实标准。
事件核心：发生了什么
这篇来自掘金的技术复盘，作者是「码哥字节」，记录了他从 2025 年 11 月起陆续编写 50 多个 Claude Code Skill 的经历。他的核心结论是：前面 30 个 Skill 的设计哲学从一开始就错了，基本可以全部删除。
具体触发点是 Claude 反复「绕过」他精心撰写的 Skill。他最终发现，问题出在对 Skill 的定位上——他误以为 Skill 是 prompt 模板的升级版，而它真正的设计逻辑并非如此。
素材同时提到两个可核查的行业信号：OpenAI Codex CLI 的 Skill 仓库 awesome-codex-skills 一周涨了 4290 星，其 SKILL.md 的 frontmatter 格式与 Anthropic 版本几乎一致；而 anthropics/skills 为 127k 星，与前者形成 21 倍差距。Anthropic 在 2025 年 10 月 16 日上线 Skill，OpenAI 侧则由社区在 2026 年 4 月大规模搬运推广，中间相隔约半年。官方 frontend-design Skill 截至今年 3 月已被安装 27.7 万次。
为什么重要
Skill 格式趋同，意味着它可能像当年的 Spring 之于 Java EE 一样，从单一厂商的私有约定演变为跨平台的能力包标准。对开发者而言，这意味着写一次 Skill 有机会在 Claude Code 和 Codex CLI 等不同工具中复用，降低迁移成本。
更重要的是，它把「提示词工程」推向了工程化阶段。作者总结的 7 个反模式——SKILL.md 写成长篇 prompt、description 只讲功能不讲触发条件、把工具调用塞进 Skill 而不走 MCP、多个 Skill 边界重叠、不写 Gotchas、示例用伪代码、不区分项目级与用户级——本质上是软件工程里的老问题在新载体上重演。
对用户/开发者/创作者的影响
对开发者来说，最直接的可用信息是：主营 SKILL.md 主体建议控制在 500 行以内，作者本人已压到 200 行以内；description 应写「什么时候用我」，而非「我能做什么」；工具调用应交由 MCP 暴露，Skill 只负责编排。此外，项目级 Skill 应放在仓库根目录，个人偏好放在用户级目录，避免换个项目就带上无关规范。
AI 工具推荐
想把多个 AI 模型放在一个入口？
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。
推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。
对使用 AI 编程工具的普通用户，这意味着未来看到「技能包」类产品时，可以重点看它的触发条件是否清晰、是否附带 Anti-patterns 章节，而不是被功能列表吸引。
值得关注的后续
目前公开信息显示，OpenAI 官方尚未就 Skill 格式做正式表态，Codex 侧的生态主要由社区推动。后续可观察三点：一是 SKILL.md 是否会形成跨厂商的正式规范文档；二是 MCP 与 Skill 的分工是否会被更多工具采纳为默认范式；三是当格式统一后，Skill 的分发与安装量是否会成为新的竞争指标。
来源：juejin
