[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F7QDS7S2A6YDBWSQE9MVHW":3,"skill-same:01M7F7QDS7S2A6YDBWSQE9MVHW":77},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":14,"repositoryHtmlUrl":44,"repositoryHomepageUrl":6,"ownerHtmlUrl":45,"ownerBlogUrl":46,"ownerDescription":47,"updatedAt":48,"install":49,"resources":62},"01M7F7QDS7S2A6YDBWSQE9MVHW","authoring-hermes-skills",null,"Author Hermes skills: user-local or in-repo SKILL.md.","chaorenex1\u002Fhermes-home-content","chaorenex1","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F23194925?v=4","01M7F5NA1D1D02R2MEMYQN2NZT","chan chan","01M7F5NA20KTHMTY2015CYM1TZ",0,"MIT","https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fauthoring-hermes-skills\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\r\nname: authoring-hermes-skills\r\ndescription: \"Author Hermes skills: user-local or in-repo SKILL.md.\"\r\nversion: 1.0.0\r\nauthor: Hermes Agent\r\nlicense: MIT\r\nplatforms: [linux, macos, windows]\r\nmetadata:\r\n  hermes:\r\n    tags: [hermes, skills, skill-manage, authoring, memory]\r\n    related_skills: [hermes-profile-management, hermes-runtime-diagnostics]\r\n---\r\n\r\n# Authoring Hermes Skills\r\n\r\nTwo trees, one discipline. Decide which tree first — the tooling, validator, and review bar differ.\r\n\r\n| Tree | Path | How to write |\r\n|---|---|---|\r\n| **User-local** | `$HERMES_HOME\u002Fskills\u002F\u003Ccategory>\u002F\u003Cname>\u002FSKILL.md` | `skill_manage(action='create' \\| 'patch' \\| 'write_file')` |\r\n| **In-repo** | `skills\u002F\u003Ccategory>\u002F` or `optional-skills\u002F\u003Ccategory>\u002F` inside the hermes-agent repo | `write_file` + `git add`; `skill_manage create` does **not** target this tree |\r\n\r\nFor in-repo skills (tier choice, frontmatter bar, platform gating, tests, docs regeneration, PR workflow) read `references\u002Fin-repo-skill-authoring.md` before writing.\r\n\r\n## Shared rules\r\n\r\n- **Description is the trigger.** One sentence, ≤60 chars, trigger first, ends with a period. `skill_manage(action='create')` rejects longer ones and the system-prompt index truncates at 57 chars + \"…\" — everything needed to *match* the skill must fit in that window. All other detail belongs in the body. Quote the value if it contains `:` or YAML parses it as a mapping. Direct `write_file` edits bypass that validation, so re-check the 57-char trigger window by hand after writing a SKILL.md outside `skill_manage`.\r\n- **Optimize for process predictability.** If a line does not change model behavior, cut it. \"Be careful\" and \"use best practices\" are no-ops; replace with a checkable criterion.\r\n- **Each step ends with a completion criterion**, checkable and exhaustive when it matters (\"every modified file accounted for\" beats \"summarize changes\").\r\n- **Co-locate a rule with the concept it governs**, and when adding a rule remove the wording it replaces — skills accumulate sediment otherwise.\r\n- **Support files carry depth:** `references\u002F\u003Ctopic>.md` (topical depth, named by topic — never by date or incident), `templates\u002F` (starter files to copy), `scripts\u002F` (re-runnable actions). Add with `write_file` and one pointer line in SKILL.md. Extend an existing reference instead of adding a sibling.\r\n- **Don't restate environment or tool-schema basics.** A skill carries the workflow, order of operations, and pitfalls.\r\n\r\n## Procedure — user-local\r\n\r\n1. Decide NEW vs extend: `skill_view` the candidates first. That read also satisfies the read-before-write guard for a later patch.\r\n2. Draft the SKILL.md: YAML frontmatter (`name`, `description`, `version`, `author`, `license`, `platforms`, `metadata.hermes.tags`\u002F`related_skills`) plus a procedural body with concrete commands and pitfalls.\r\n3. Apply with a **single** `skill_manage` call; batch related edits (new skills plus the `related_skills` cross-links they need on existing skills) together.\r\n4. Verify: `skill_view(name)` for every new\u002Fedited skill and spot-read the on-disk frontmatter. New user-local skills load immediately; no restart. (An in-repo skill is invisible to the current session — the loader initializes at session start.)\r\n5. Distribution: default-profile skills mirror to named profiles via `$HERMES_HOME\u002Fscripts\u002Fsync_default_profile_extensions.py` (dry-run → apply → dry-run). Never hand-copy into profile trees — the sync also **deletes** target-only skills there.\r\n\r\n## Pitfalls\r\n\r\n- **Atomic batches:** all operations in one `skill_manage` call apply together; one failure (e.g. an over-long description on a `create`) rolls back every earlier op. After a rollback, re-issue the **complete** corrected batch — re-running only the failed op leaves the rest unapplied.\r\n- **Read-before-write guard:** patching an existing skill, or overwriting an existing support file, requires a fresh `skill_view` of that exact target in the current session; content quoted earlier in the conversation does not count.\r\n- **Unique `old_string`:** a patch whose snippet matches several places fails and takes the whole batch down — include enough skill-specific context.\r\n- **Protected skills:** bundled and hub-installed skills refuse edits (\"Refusing … for bundled skill\"). Note the gap and recommend `hermes curator adopt \u003Cname>` — do not retry.\r\n- **Router skills:** a skill whose core is a routing table pointing at siblings adds an indirection hop and duplicates their triggers. If it would be empty without \"load skill X instead\", don't write it.\r\n- **Dangling `related_skills`:** every entry must resolve in the same tree state; archived or user-only names break resolution.\r\n- **Machine-local paths** baked into a skill break for everyone else: write `~\u002F.camofox\u002Fdownloads`, `$HOME\u002F...`, `%USERPROFILE%`, `$TEMP` — never `C:\\Users\\\u003Cname>\\...` or `\u002Fhome\u002F\u003Cyou>\u002F...`. In shell snippets quote the expansion, not the tilde: `\"~\u002F.x\"` passes a literal `~` and the command fails, so write `\"$HOME\u002F.x\"`.\r\n- **Referencing raw shell instead of Hermes tools:** name `terminal`, `read_file`, `write_file`, `patch`, `search_files`, `web_search`, `web_extract`, `browser_navigate`, `vision_analyze`, `delegate_task`, `cronjob` — not `grep`\u002F`cat`\u002F`sed`\u002F`find`.\r\n- **Wholesale rewrite of a long SKILL.md:** `write_file` refuses to overwrite a file it did not read in one unpaginated pass, and reading page-by-page does not clear that guard. For a true rewrite, move the old file aside with a git\u002Ftree rollback point and write the new one; for everything smaller, `patch` the offending sentences. Append no \"UPDATE:\" block — a stale rule left standing still gets followed.\r\n- **Migrating a skill to a new tool surface:** transplant the domain knowledge, but exercise each ported procedure against the live target before it lands in the doc, and label what was not exercised as unverified. Delete the superseded implementation and put a one-line deprecation header on every reference file that still prescribes it — two contradictory procedures in one skill are worse than either alone, because the next session follows the stale one.\r\n\r\n## Verification Checklist\r\n\r\n- [ ] Tree chosen deliberately (user-local vs in-repo), and in-repo work follows `references\u002Fin-repo-skill-authoring.md`.\r\n- [ ] Frontmatter starts at byte 0, `name` + `description` present, body non-empty.\r\n- [ ] Description ≤60 chars, trigger self-contained in the first 57, ends with a period, no marketing words.\r\n- [ ] Every `related_skills` entry resolves.\r\n- [ ] Each ordered step has a checkable completion criterion; `## Pitfalls` and verification are present.\r\n- [ ] `skill_view` loads every touched skill; on-disk frontmatter spot-read.\r\n- [ ] No manual copies into profile trees (the sync script owns distribution).\r\n","# Authoring Hermes Skills\r\n\r\nTwo trees, one discipline. Decide which tree first — the tooling, validator, and review bar differ.\r\n\r\n| Tree | Path | How to write |\r\n|---|---|---|\r\n| **User-local** | `$HERMES_HOME\u002Fskills\u002F\u003Ccategory>\u002F\u003Cname>\u002FSKILL.md` | `skill_manage(action='create' \\| 'patch' \\| 'write_file')` |\r\n| **In-repo** | `skills\u002F\u003Ccategory>\u002F` or `optional-skills\u002F\u003Ccategory>\u002F` inside the hermes-agent repo | `write_file` + `git add`; `skill_manage create` does **not** target this tree |\r\n\r\nFor in-repo skills (tier choice, frontmatter bar, platform gating, tests, docs regeneration, PR workflow) read `references\u002Fin-repo-skill-authoring.md` before writing.\r\n\r\n## Shared rules\r\n\r\n- **Description is the trigger.** One sentence, ≤60 chars, trigger first, ends with a period. `skill_manage(action='create')` rejects longer ones and the system-prompt index truncates at 57 chars + \"…\" — everything needed to *match* the skill must fit in that window. All other detail belongs in the body. Quote the value if it contains `:` or YAML parses it as a mapping. Direct `write_file` edits bypass that validation, so re-check the 57-char trigger window by hand after writing a SKILL.md outside `skill_manage`.\r\n- **Optimize for process predictability.** If a line does not change model behavior, cut it. \"Be careful\" and \"use best practices\" are no-ops; replace with a checkable criterion.\r\n- **Each step ends with a completion criterion**, checkable and exhaustive when it matters (\"every modified file accounted for\" beats \"summarize changes\").\r\n- **Co-locate a rule with the concept it governs**, and when adding a rule remove the wording it replaces — skills accumulate sediment otherwise.\r\n- **Support files carry depth:** `references\u002F\u003Ctopic>.md` (topical depth, named by topic — never by date or incident), `templates\u002F` (starter files to copy), `scripts\u002F` (re-runnable actions). Add with `write_file` and one pointer line in SKILL.md. Extend an existing reference instead of adding a sibling.\r\n- **Don't restate environment or tool-schema basics.** A skill carries the workflow, order of operations, and pitfalls.\r\n\r\n## Procedure — user-local\r\n\r\n1. Decide NEW vs extend: `skill_view` the candidates first. That read also satisfies the read-before-write guard for a later patch.\r\n2. Draft the SKILL.md: YAML frontmatter (`name`, `description`, `version`, `author`, `license`, `platforms`, `metadata.hermes.tags`\u002F`related_skills`) plus a procedural body with concrete commands and pitfalls.\r\n3. Apply with a **single** `skill_manage` call; batch related edits (new skills plus the `related_skills` cross-links they need on existing skills) together.\r\n4. Verify: `skill_view(name)` for every new\u002Fedited skill and spot-read the on-disk frontmatter. New user-local skills load immediately; no restart. (An in-repo skill is invisible to the current session — the loader initializes at session start.)\r\n5. Distribution: default-profile skills mirror to named profiles via `$HERMES_HOME\u002Fscripts\u002Fsync_default_profile_extensions.py` (dry-run → apply → dry-run). Never hand-copy into profile trees — the sync also **deletes** target-only skills there.\r\n\r\n## Pitfalls\r\n\r\n- **Atomic batches:** all operations in one `skill_manage` call apply together; one failure (e.g. an over-long description on a `create`) rolls back every earlier op. After a rollback, re-issue the **complete** corrected batch — re-running only the failed op leaves the rest unapplied.\r\n- **Read-before-write guard:** patching an existing skill, or overwriting an existing support file, requires a fresh `skill_view` of that exact target in the current session; content quoted earlier in the conversation does not count.\r\n- **Unique `old_string`:** a patch whose snippet matches several places fails and takes the whole batch down — include enough skill-specific context.\r\n- **Protected skills:** bundled and hub-installed skills refuse edits (\"Refusing … for bundled skill\"). Note the gap and recommend `hermes curator adopt \u003Cname>` — do not retry.\r\n- **Router skills:** a skill whose core is a routing table pointing at siblings adds an indirection hop and duplicates their triggers. If it would be empty without \"load skill X instead\", don't write it.\r\n- **Dangling `related_skills`:** every entry must resolve in the same tree state; archived or user-only names break resolution.\r\n- **Machine-local paths** baked into a skill break for everyone else: write `~\u002F.camofox\u002Fdownloads`, `$HOME\u002F...`, `%USERPROFILE%`, `$TEMP` — never `C:\\Users\\\u003Cname>\\...` or `\u002Fhome\u002F\u003Cyou>\u002F...`. In shell snippets quote the expansion, not the tilde: `\"~\u002F.x\"` passes a literal `~` and the command fails, so write `\"$HOME\u002F.x\"`.\r\n- **Referencing raw shell instead of Hermes tools:** name `terminal`, `read_file`, `write_file`, `patch`, `search_files`, `web_search`, `web_extract`, `browser_navigate`, `vision_analyze`, `delegate_task`, `cronjob` — not `grep`\u002F`cat`\u002F`sed`\u002F`find`.\r\n- **Wholesale rewrite of a long SKILL.md:** `write_file` refuses to overwrite a file it did not read in one unpaginated pass, and reading page-by-page does not clear that guard. For a true rewrite, move the old file aside with a git\u002Ftree rollback point and write the new one; for everything smaller, `patch` the offending sentences. Append no \"UPDATE:\" block — a stale rule left standing still gets followed.\r\n- **Migrating a skill to a new tool surface:** transplant the domain knowledge, but exercise each ported procedure against the live target before it lands in the doc, and label what was not exercised as unverified. Delete the superseded implementation and put a one-line deprecation header on every reference file that still prescribes it — two contradictory procedures in one skill are worse than either alone, because the next session follows the stale one.\r\n\r\n## Verification Checklist\r\n\r\n- [ ] Tree chosen deliberately (user-local vs in-repo), and in-repo work follows `references\u002Fin-repo-skill-authoring.md`.\r\n- [ ] Frontmatter starts at byte 0, `name` + `description` present, body non-empty.\r\n- [ ] Description ≤60 chars, trigger self-contained in the first 57, ends with a period, no marketing words.\r\n- [ ] Every `related_skills` entry resolves.\r\n- [ ] Each ordered step has a checkable completion criterion; `## Pitfalls` and verification are present.\r\n- [ ] `skill_view` loads every touched skill; on-disk frontmatter spot-read.\r\n- [ ] No manual copies into profile trees (the sync script owns distribution).\r\n",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"platforms":37,"description":7},"Hermes Agent","1.0.0",{"hermes":27},{"tags":28,"related_skills":34},[29,30,31,32,33],"hermes","skills","skill-manage","authoring","memory",[35,36],"hermes-profile-management","hermes-runtime-diagnostics",[38,39,40],"linux","macos","windows","main","a3f3199bb87ec3c91248f68a39d88527e1847ae9","skills\u002Fsoftware-development\u002Fauthoring-hermes-skills","https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content","https:\u002F\u002Fgithub.com\u002Fchaorenex1","https:\u002F\u002Fblog.aduib.com","A programmer whose only hobby in life is coding","2026-10-20 00:34:32",{"source":8,"skillName":5,"commands":50,"prompt":60,"zipAvailable":61},[51,54,57],{"tool":52,"command":53},"npx","npx skills add chaorenex1\u002Fhermes-home-content --skill authoring-hermes-skills",{"tool":55,"command":56},"bunx","bunx skills add chaorenex1\u002Fhermes-home-content --skill authoring-hermes-skills",{"tool":58,"command":59},"pnpm","pnpm dlx skills add chaorenex1\u002Fhermes-home-content --skill authoring-hermes-skills","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fauthoring-hermes-skills\u002FSKILL.md",true,[63,69,73],{"path":64,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":67,"sourceHtmlUrl":68},"references\u002Fbackground-curator-constraints.md","REFERENCE","参考文档",3183,"https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fauthoring-hermes-skills\u002Freferences\u002Fbackground-curator-constraints.md",{"path":70,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":71,"sourceHtmlUrl":72},"references\u002Fin-repo-skill-authoring.md",8087,"https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fauthoring-hermes-skills\u002Freferences\u002Fin-repo-skill-authoring.md",{"path":74,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002Fskill-validator-rules.md",2560,"https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content\u002Fblob\u002Fmain\u002Fskills\u002Fsoftware-development\u002Fauthoring-hermes-skills\u002Freferences\u002Fskill-validator-rules.md",[78,85,92,99,106,113],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7F8GF32YD5MBQW2TGSRH1YP","web-retrieval-resilience","Web tools fail or search rules break: repair or fall back.","https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fweb-retrieval-resilience\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7F8FP46QESQMCZ1KBT3TW3R","blocked-page-recovery","Use when a fetch fails: 403\u002F429, paywall, WAF, bot wall.","https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fblocked-page-recovery\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7F8ER6VXHBNVRQBZS7X08SE","verification-loop","Run a six-phase verification of a Claude Code session's work — build, type check, lint, tests with coverage, security grep, and diff review — then produce a PASS\u002FFAIL verification report. Use when verifying work after completing a feature or refactor, before creating a PR, or when quality gates must pass.","https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content\u002Fblob\u002Fmain\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M7F8E4BQJ38KVQVM3MT20PYV","unreal-world-builder","开放世界与环境专家——精通 UE5 World Partition、Landscape、程序化植被、HLOD 和大规模关卡流式加载，打造无缝开放世界体验","https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content\u002Fblob\u002Fmain\u002Fskills\u002Funreal-engine\u002Funreal-world-builder\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":19},"01M7F8D747SQW2FTP7GBSX38BR","unreal-technical-artist","Unreal Engine 视觉管线专家——精通材质编辑器、Niagara 特效、程序化内容生成和 UE5 项目的美术到引擎管线","https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content\u002Fblob\u002Fmain\u002Fskills\u002Funreal-engine\u002Funreal-technical-artist\u002FSKILL.md",[],[],{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":119,"publishedAt":19},"01M7F8CKHYJVZVBTN0321J88T2","unreal-systems-engineer","性能与混合架构专家——精通 C++\u002FBlueprint 边界、Nanite 几何体、Lumen GI 和 Gameplay Ability System，面向 AAA 级 Unreal Engine 项目","https:\u002F\u002Fgithub.com\u002Fchaorenex1\u002Fhermes-home-content\u002Fblob\u002Fmain\u002Fskills\u002Funreal-engine\u002Funreal-systems-engineer\u002FSKILL.md",[],[]]