用途:指导在 hermes-agent 仓库内编写并提交 SKILL.md 技能文件。技能可放在用户本地 ~/.hermes/skills/(用 skill_manage(action='create') 创建,不共享),或仓库内 skills/<category>/<name>/SKILL.md 与 optional-skills/<category>/<name>/SKILL.md(随包发布,需用 write_file 加 git add,skill_manage 的 create 不作用于该目录)。
主要能力:区分 bundled(skills/,日常高频、通用)与 optional(optional-skills/,垂直或重型,经 hermes skills install official/<category>/<skill> 安装),拿不准时选 optional;按工具本质而非感觉选分类,不随意新增顶层分类;不写路由/索引类技能。
frontmatter 要求:文件首字节为 ---,以 \n---\n 结束,可解析为 YAML 映射,含 name、description,正文非空;仓库标准还要求 version、author、license、platforms、metadata.hermes.tags 与 related_skills。description 硬性不超过 60 字符、一句话、以句号结尾、不含营销词,含冒号需加双引号;author 先署人类贡献者再写 Hermes Agent;related_skills 必须指向仓库内真实存在的技能。platforms 需按脚本实际依赖审计,而非照抄。
正文结构:标题加 2-3 句简介,随后 When to Use、Prerequisites、How to Run、Quick Reference、Procedure、Pitfalls、Verification;步骤需有可检查的完成标准。引用 Hermes 工具(terminal、read_file、write_file、patch、search_files 等)而非裸 shell 工具,禁止机器本地路径。
限制与流程:SKILL.md 上限 100000 字符,简单技能约 100 行;大块内容放 references/、templates/、scripts/。仓库技能需在 tests/skills/test_<skill>_skill.py 提供测试,运行 scripts/run_tests.sh,并执行 python website/scripts/generate-skill-docs.py 后仅保留自身改动。当前会话加载器有缓存,新技能需新会话才可见。其他细节资料未提供。