# 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."