Without an entry, scripts/build-hermes.py fails ("unmapped skill" — every
skill in skills/ must appear in mapping exactly once). Registered under
the pending block alongside using-yt-tools and using-vds-ops because the
skill has bidirectional file-system side effects (read/write
.tasks/NEXT_SESSION.md) and warrants a behavioral audit before promotion.
intended.category = productivity (mirrors using-tasks/setup-tasks —
workflow-state continuity primitive, not engineering toolchain).
Build now reports 28 skills (14 auto / 2 manual / 9 skip / 3 pending).
SKIPPED.md gains an entry under "Pending" with the intended block
preserved across MVP iterations.
Closes [session-handoff-hermes-mapping].
Promotion to mode: auto deferred to a separate post-audit task.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
167 lines
5.1 KiB
YAML
167 lines
5.1 KiB
YAML
# Hermes Skills Rollout — mapping
|
|
#
|
|
# Source of truth for the converter (scripts/build-hermes.py).
|
|
# EVERY skill in skills/ MUST appear in `skills:` exactly once — the build
|
|
# fails on unmapped skills (forces an explicit decision per skill).
|
|
#
|
|
# Modes:
|
|
# auto — convert from skills/<name>/, applying replace-rules. Lands in
|
|
# dist-hermes/<category>/<name>/.
|
|
# manual — copy from `source:` directory verbatim (no replace-rules).
|
|
# Used for Hermes-flavour rewrites (e.g. yaml-edit MCP setups).
|
|
# skip — audited as not-applicable; recorded in dist-hermes/SKIPPED.md.
|
|
# pending — present in mapping but not yet built; recorded in SKIPPED.md.
|
|
# `intended:` block declares the future mode/category, so the
|
|
# audit table is preserved across MVP iterations.
|
|
#
|
|
# Categories: software-development | productivity | mcp | research | meta
|
|
#
|
|
# See .wiki/concepts/hermes-skills-rollout-design.md for the full audit
|
|
# (Q1-Q8 + the 21-row decision table).
|
|
|
|
version: 1
|
|
|
|
hermes:
|
|
installer_path: meta/claude-skills-installer
|
|
default_category: software-development
|
|
|
|
categories:
|
|
- software-development
|
|
- productivity
|
|
- mcp
|
|
- research
|
|
- meta
|
|
|
|
skills:
|
|
|
|
# ─── auto (4 universals — MVP target) ────────────────────────────────
|
|
|
|
pulling-before-work:
|
|
mode: auto
|
|
category: software-development
|
|
|
|
active-platform:
|
|
mode: auto
|
|
category: software-development
|
|
replace-rules:
|
|
- find: "**Windows + PowerShell.**"
|
|
replace: "**Linux + bash.**"
|
|
reason: "Hermes runs on Linux factory machines (/opt/data/projects). Default platform shifts."
|
|
- find: "Use this until something in the session tells you to switch. Reason: the user's primary workstation is Windows."
|
|
replace: "Use this until something in the session tells you to switch. Reason: Hermes runs on Linux factory machines."
|
|
reason: "Mirror reasoning sentence to match the new default."
|
|
|
|
project-discipline:
|
|
mode: auto
|
|
category: software-development
|
|
|
|
tdd-criteria:
|
|
mode: auto
|
|
category: software-development
|
|
|
|
using-markitdown:
|
|
mode: auto
|
|
category: productivity
|
|
|
|
# ─── skip (8 — audited as not-applicable) ────────────────────────────
|
|
|
|
caveman:
|
|
mode: skip
|
|
reason: "Hermes runs on glm-5.1 (cheap local model); token-compression motive disappears."
|
|
caveman-commit:
|
|
mode: skip
|
|
reason: "Caveman family — cheap-model context, no compression motive."
|
|
caveman-compress:
|
|
mode: skip
|
|
reason: "Caveman family — cheap-model context, no compression motive."
|
|
caveman-help:
|
|
mode: skip
|
|
reason: "Help-card for the caveman family which itself is skipped."
|
|
caveman-review:
|
|
mode: skip
|
|
reason: "Caveman family — cheap-model context, no compression motive."
|
|
setup-interns:
|
|
mode: skip
|
|
reason: "Hermes itself is a cheap-intern model — the delegation tier collapses."
|
|
using-interns:
|
|
mode: skip
|
|
reason: "Hermes itself is a cheap-intern model — the delegation tier collapses."
|
|
find-skills:
|
|
mode: skip
|
|
reason: "Hermes has built-in skills_list() / progressive disclosure."
|
|
|
|
# ─── pending (10 — deferred to follow-up tasks) ──────────────────────
|
|
|
|
setup-tasks:
|
|
mode: auto
|
|
category: productivity
|
|
|
|
using-tasks:
|
|
mode: auto
|
|
category: productivity
|
|
|
|
setup-wiki:
|
|
mode: auto
|
|
category: research
|
|
|
|
using-wiki:
|
|
mode: auto
|
|
category: research
|
|
|
|
setup-projects-meta:
|
|
mode: manual
|
|
source: hermes/skills/setup-projects-meta
|
|
category: mcp
|
|
|
|
using-projects-meta:
|
|
mode: auto
|
|
category: mcp
|
|
|
|
setup-context7:
|
|
mode: manual
|
|
source: hermes/skills/setup-context7
|
|
category: mcp
|
|
|
|
using-context7:
|
|
mode: auto
|
|
category: mcp
|
|
|
|
using-synology-ops:
|
|
mode: auto
|
|
category: mcp
|
|
|
|
project-bootstrap:
|
|
mode: auto
|
|
category: software-development
|
|
|
|
recommend-dont-menu:
|
|
mode: auto
|
|
category: productivity
|
|
|
|
update-claude-skills:
|
|
mode: skip
|
|
reason: "Claude-Code-only orchestrator — Hermes uses hermes-installer-skill instead."
|
|
|
|
# ─── pending (3 — behavioral audit required) ─────────────────────────
|
|
|
|
using-yt-tools:
|
|
mode: pending
|
|
intended:
|
|
mode: auto
|
|
category: research
|
|
reason: "Shells out to yt-dlp + ffmpeg and writes ./yt-cache/ in cwd. Behavioral audit via using-yt-tools-test-trigger required before promotion to auto."
|
|
|
|
using-vds-ops:
|
|
mode: pending
|
|
intended:
|
|
mode: auto
|
|
category: mcp
|
|
reason: "Calls mcp__vds-ops__* tools (read-only, but touches infrastructure). Behavioral audit via using-vds-ops-test-trigger required before promotion to auto."
|
|
|
|
session-handoff:
|
|
mode: pending
|
|
intended:
|
|
mode: auto
|
|
category: productivity
|
|
reason: "Writes .tasks/NEXT_SESSION.md (project-scope, sliding overwrite) and reads it on session start. Bidirectional file-system side-effect, opt-in via CLAUDE.md trigger-line. Behavioral audit via session-handoff-test-trigger required before promotion to auto."
|