authoring-user-skills
Create and edit user-local Hermes skills with skill_manage.
- License 许可
- MIT
- 最近更新
- 2026-10-20
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- authoring-user-skills
- author
- Hermes Agent
- license
- MIT
- version
- 1.0.0
- metadata
- { "hermes": { "tags": [ "hermes", "skills", "skill-manage", "authoring", "memory" ], "related_skills": [ "hermes-agent-skill-authoring", "hermes-profile-management" ] } }
- platforms
- [ "linux", "macos", "windows" ]
- description
- Create and edit user-local Hermes skills with skill_manage.
03 SKILL.md 正文
Authoring user-local Hermes skills (skill_manage)
Use when the user asks to add, edit, or remove Hermes skills that live in the user tree:
%LOCALAPPDATA%\hermes\skills\<category>\<name>\SKILL.md (default profile). For skills committed
INSIDE the hermes-agent repo, use the bundled hermes-agent-skill-authoring skill instead —
different tree, validator, tests, and docs.
Procedure
- Decide scope: NEW skill vs extending an existing one;
skill_viewthe candidates before choosing (this also satisfies the read-before-write guard for any later patch). - Draft the SKILL.md: YAML frontmatter (
name,description,version,author: Hermes Agent,license,platforms,metadata.hermes.tags/related_skills) + a procedural body with concrete commands and pitfalls. - Description budget (hard-enforced): one sentence, trigger first, ends with a period, ≤60
chars.
skill_manage(action='create')REJECTS longer descriptions and the system-prompt index truncates at 57 chars + "…" — the trigger must be self-contained in that window; all other detail goes in the body. - Apply with a single
skill_managecall; batch related edits together (e.g. new skills + therelated_skillscross-links they need on existing skills). - Verify:
skill_view(name)for every new/edited skill and spot-read the on-disk frontmatter. New skills are visible immediately (fresh load); no restart needed. - Distribution: default-profile skills mirror to named profiles via
$HERMES_HOME/scripts/sync_default_profile_extensions.py(dry-run → apply → dry-run) — never hand-copy into profile trees; the sync also DELETES target-only skills there.
Pitfalls
- Atomic batches: all operations in one
skill_managecall apply together; one failure (e.g. an over-long description on acreate) rolls back EVERYTHING applied earlier in that call. After a rollback, re-issue the COMPLETE corrected batch — re-running only the failed op leaves the rest unapplied. - Read-before-write guard: patching an existing skill, or overwriting an existing support file,
requires a fresh
skill_viewof that exact target in the CURRENT session; content quoted earlier in the conversation does not count. - Unique
old_string: patch ops fail and take the whole batch down with them when the snippet matches several files' similar text — include enough skill-specific context. - Protected skills: bundled and hub-installed skills refuse edits ("Refusing … for bundled
skill"). Note the gap in the reply and recommend
hermes curator adopt <name>instead of retrying. - Support files:
references/<topic>.md(topical depth),templates/,scripts/— added viawrite_filewith a skill-relativefile_path, then a one-line pointer in SKILL.md. Extend an existing reference over creating a per-session file, and never name files after dates/incidents. - Do not restate environment or tool-schema basics in skill bodies; skills carry the workflow, the order of operations, and the pitfalls.
Verification Checklist
- [ ] Every new/edited description ≤60 chars, ends with a period, trigger self-contained in the first 57.
- [ ]
skill_viewloads every touched skill; on-disk frontmatter spot-read. - [ ]
related_skillsentries resolve to skills that exist in the same tree. - [ ] No manual copies into profile trees (the sync script owns distribution).
04 同仓库更多 Skills
web-retrieval-resilience
Web tools fail or search rules break: repair or fall back.
blocked-page-recovery
Use when a fetch fails: 403/429, paywall, WAF, bot wall.
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/FAIL verification report. Use when verifying work after completing a feature or refactor, before creating a PR, or when quality gates must pass.
unreal-world-builder
开放世界与环境专家——精通 UE5 World Partition、Landscape、程序化植被、HLOD 和大规模关卡流式加载,打造无缝开放世界体验
unreal-technical-artist
Unreal Engine 视觉管线专家——精通材质编辑器、Niagara 特效、程序化内容生成和 UE5 项目的美术到引擎管线
unreal-systems-engineer
性能与混合架构专家——精通 C++/Blueprint 边界、Nanite 几何体、Lumen GI 和 Gameplay Ability System,面向 AAA 级 Unreal Engine 项目