SKILL.md 格式指南
解释什么是 SKILL.md、它应该写什么，以及为什么格式标准决定了 skill 的跨平台可移植性。
2026/03/08
SKILL.md 格式指南
SKILL.md 是大多数 Agent Skills 的核心文件。用户搜索 “skills md”“skill md” 时，通常不是在找一个品牌，而是在问这个文件规范到底是什么。最直接的帮助方式，就是先把格式解释清楚，再把用户导回合适的浏览入口。
一份 SKILL.md 至少应该说明什么
一份质量不错的 SKILL.md，通常要回答四个问题：
- 这个 skill 是做什么的
- 什么时候应该调用它
- 它需要哪些输入或上下文
- 代理在执行时应遵守哪些输出格式或规则
有些仓库还会附带脚本、示例或平台专属说明，但 SKILL.md 的核心仍然是工作流定义。
为什么格式会影响实际可用性
格式越清晰、平台耦合越低，一个 skill 就越容易在多个相关页面中获得合理归类，比如 Claude Code、Codex、Cursor、Gemini CLI。这不仅影响实际可用性，也影响搜索引擎如何理解页面与页面之间的关系。