词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"Hermes Agent Skill 编写——在仓库中编写 SKILL"
Hermes Agent Skill 编写
Skill 元数据
| 来源 | 内置（默认安装） |
| 路径 | skills/software-development/hermes-agent-skill-authoring |
| 版本 | 1.0.0 |
| 作者 | Hermes Agent |
| 许可证 | MIT |
| 平台 | linux, macos, windows |
| 标签 | skills, authoring, hermes-agent, conventions, skill-md |
| 相关 skill | writing-plans, requesting-code-review |
参考：完整 SKILL.md
信息
编写 Hermes-Agent Skills（仓库内）
概述
1.
~/.hermes/skills/<maybe-category>/<name>/SKILL.md — 个人使用，不共享。通过 skill_manage(action='create') 创建。2.
/home/bb/hermes-agent/skills/<category>/<name>/SKILL.md — 已提交，随包一起发布。使用 write_file + git add。skill_manage(action='create') 不针对此目录树。使用时机
/home/bb/hermes-agent/skills/ 下的现有 skill（小改动用 patch，重写用 write_file；skill_manage 对仓库内 skill 的 patch 仍有效，但 create 无效）必需的 Frontmatter
tools/skill_manager_tool.py::_validate_frontmatter。硬性要求：--- 作为首字节开头（无前导空行）。\n---\n 结束。name 字段。description 字段，且 ≤ 1024 个字符（MAX_DESCRIPTION_LENGTH）。--- 后有非空正文。skills/software-development/ 下每个 skill 使用的对等匹配格式：version / author / license / metadata 不受验证器强制约束，但每个同类 skill 都有这些字段——省略会使你的 skill 显得格格不入。大小 限制
MAX_SKILL_CONTENT_CHARS，约 36k token）。software-development/ 中的同类 skill 大小在 8-14k 字符之间。以此为目标范围。若超过 20k，请拆分为 references/*.md 并在 SKILL.md 中引用。对等匹配结构
# <Title>
## Overview
One or two paragraphs: what and why.
## When to Use
- Bulleted triggers
- "Don't use for:" counter-triggers
## <Topic sections specific to the skill>
- Quick-reference tables are common
- Code blocks with exact commands
- Hermes-specific recipes (tests via scripts/run_tests.sh, ui-tui paths, etc.)
## Common Pitfalls
Numbered list of mistakes and their fixes.
## Verification Checklist
- [ ] Checkbox list of post-action verifications
## One-Shot Recipes (optional)
Named scenarios → concrete command sequences.Overview + When to Use + 可操作正文 + 常见问题至少要有，skill 才能与同类看齐。目录放置
skills/<category>/<skill-name>/SKILL.mdls skills/ 确认）：autonomous-ai-agents、creative、data-science、devops、dogfood、email、gaming、github、leisure、mcp、media、mlops/*、note-taking、productivity、red-teaming、research、smart-home、social-media、software-development。工作流
1.
ls skills/<category>/2.
tools/skill_manager_tool.py 中的验证器约束。3.
write_file 写入 skills/<category>/<name>/SKILL.md。4.
5.
6.
skill_view / skills_list 在新会话开始前不会看到新 skill。这是预期行为，不是 bug。交叉引用其他 Skill
metadata.hermes.related_skills 在加载时会合并两个目录树（仓库内 skills/ 和 ~/.hermes/skills/）。你可以从仓库内 skill 引用用户本地 skill，但对于全新克隆仓库的其他用户，该引用无法解析。仓库内 skill 优先只引用仓库内 skill。如果某个频繁被引用的 skill 仅存在于 ~/.hermes/skills/，请考虑将其提升到仓库中。编辑现有仓库内 Skill
skill_manage(action='patch', name=..., old_string=..., new_string=...) 对仓库内 skill 同样有效。write_file 写入完整 SKILL.md。skill_manage(action='edit') 也可以，但需要提供完整的新内容。write_file 写入 skills/<category>/<name>/references/<file>.md、templates/<file> 或 scripts/<file>。skill_manage(action='write_file') 也可以，并会强制执行 references/templates/scripts/assets 子目录白名单。常见问题
1.
skill_manage(action='create')。 它会写入 ~/.hermes/skills/，而非仓库目录树。仓库内创建请使用 write_file。2.
--- 前有前导空白。 验证器检查 content.startswith("---")；任何前导空行或 BOM 都会导致验证失败。3.
4.
5.
ls skills/<category>/ 并打开 2-3 个同类 skill。优先扩展现有 skill，而非创建功能狭窄的兄弟 skill。6.
skill_view 使用精确路径进行验证。7.
related_skills: [some-user-local-skill] 对你有效，但对其他克隆用户会失效。优先只使用仓库内链接。验证清单
skills/<category>/<name>/SKILL.md（不在 ~/.hermes/skills/ 中）--- 开头，以 \n---\n 结束name、description、version、author、license、metadata.hermes.{tags, related_skills} 均已填写# Title → ## Overview → ## When to Use → 正文 → ## Common Pitfalls → ## Verification Checklistrelated_skills 中的引用在仓库内可解析（或明确允许为用户本地）git add skills/<category>/<name>/ && git commit修改于 2026-05-31 00:25:01