Hermes Agent 技能作者

解决什么问题

在仓库中直接编写 SKILL.md 时，团队常面临几个实际问题：frontmatter 字段缺失或格式不统一，导致解析器报错；技能结构随意，后续维护者难以理解边界；描述写得含糊，触发条件不清晰。这些并不是能力问题，而是缺少一套可执行的规范与校验手段。

技能如何工作

Hermes Agent Skill Authoring 围绕四个核心能力展开：

• Frontmatter 规范：明确 name、description、version、author、license、platforms 等字段的写法与顺序，避免 description 过于笼统。
• 校验器：提供 validator 脚本或规则，在提交前检查 SKILL.md 是否符合约定，快速定位缺少字段或格式错误。
• 结构约定：规定技能应包含哪些章节，例如前置说明、使用示例、边界条件，让不同作者产出的文件结构一致。
• 写作质量原则：强调描述要具体说明触发条件与限制，而不是堆砌关键词；示例应可复现；变更记录要可追溯。

关键步骤大致是：先确定技能的触发范围并写好 frontmatter，再跑一遍校验器，然后按结构模板填充正文，最后用写作原则做一次自查。

适用边界与注意点

本技能面向仓库内的 SKILL.md 编写，不负责技能分发或运行时调度。它不会自动修复已有错误，只提供规则与检查入口；实际修改仍需人工确认。涉及 related_skills 等元数据时，建议与仓库内已有技能保持一致，避免产生循环引用。