hmbown/wizards-of-the-ghosts

    ╔═══════════════════════════════════════════════════╗
    ║                                                   ║
    ║    W I Z A R D S   O F   T H E   G H O S T S     ║
    ║                                                   ║
    ║      123 spells for the ghost in the machine      ║
    ║                                                   ║
    ╚═══════════════════════════════════════════════════╝

Unofficial Hermes Agent skill pack built from fantasy spell and skill names.

Not affiliated with or endorsed by Wizards of the Coast.

    ┌────────────────────────────────────────────────────────────────────┐
    │ Simulation (8)       Investigation (29)   Actions (19)         │
    │ Influence (18)       GHOST IN THE MACHINE Monitoring (17)      │
    │ Containment (10)     Repair (13)          Messaging (9)        │
    └────────────────────────────────────────────────────────────────────┘

wizardsoftheghosts turns public fifth-edition spell and skill names into a product-shaped Hermes skill pack for investigation, automation, monitoring, messaging, repair, staging, and tightly scoped intervention.

Quick Install

npm run expand:blueprints
npm run build:skills
npm run wizard:install

That builds the generated surfaces and mirrors them into workspace-local Hermes and OpenClaw homes for testing.

Or install the Hermes surface into your default Hermes home:

npm run install:hermes-skills

Or install the OpenClaw surface into a workspace-local Codex/OpenClaw home:

CODEX_HOME=$PWD/.codex npm run install:codex-skills

Hermes Expectations

• Hermes discovers installed skills from ~/.hermes/skills or $HERMES_HOME/skills; npm run install:hermes-skills copies the generated docs there.
• The installable Hermes surface lives in generated/hermes/. Those files are procedural markdown with YAML frontmatter, not executable plugins by themselves.
• Most of this pack is best used as reasoning, investigation, planning, triage, or operating-mode scaffolding inside a normal Hermes session.
• In practice, skills like detect-magic, mage-hand, zone-of-truth, feather-fall, and unseen-servant work especially well as direct Hermes prompts.
• After install, every spell is also available as a /slash-command in Claude Code (e.g. /forcecage, /true-seeing).
• Some skills mention env vars, APIs, or external systems, but this repo does not currently ship a dedicated Hermes integration layer for Home Assistant, Slack, or other services. Those procedures become real only if your Hermes environment already has the matching tools, credentials, and permissions.

What Ships

• 123 Hermes skills drawn from 128 public canon names (109 spells, 19 skills)
• 8 Hermes shelves for progressive discovery instead of one giant list
• 10 featured entry points plus 8 intent-driven browse paths on GitHub
• public low-risk Hermes surface with 5 refused coercion and memory spells kept off release

Best First Skills

Recent GEPA upgrade: Forcecage was promoted after a Codex-backed spell-level run improved full eval from 61.8% to 89.3% (+27.5pp). The upgraded copy is sharper about tested containment boundaries, outside-the-cage observation, and explicit release conditions before anything descends.

Need badges, browse paths, or the bigger picture? Open GRIMOIRE.md for the full browse layer.

Find Your Shelf

Browse Deeper

• GRIMOIRE.md for the featured shelf, browse paths, and full linked category index
• generated/hermes///SKILL.md after npm run build:skills for the exact procedural skill docs Hermes installs
• generated/openclaw/ for the separate OpenClaw-oriented output surface generated from the same source material
• catalog/blueprints.json plus scripts/render-skills.mjs for the source-of-truth and renderer

Build From Source

Source of truth:

1. catalog/canon.json
2. catalog/blueprints.json
3. scripts/expand-blueprints.mjs
4. scripts/render-skills.mjs

Default workflow:

npm run sync:canon
npm run expand:blueprints
npm run build:skills
npm run export:linear

Or:

npm run bootstrap

Verification

npm run verify

npm run verify checks the generated Hermes and OpenClaw surfaces, then performs sandbox installs into temporary Hermes and Codex homes so you can catch packaging drift before release.

DSPy Router

The repo ships two Hermes routing paths under catalog/dspy/: a deterministic lexical baseline and an optional DSPy category router.

• Current held-out result: 95/104 = 91.3% with the Codex-backed DSPy router
• Baseline comparison: 82/104 = 78.8% for the lexical router, a +12.5pp lift for DSPy
• Current scope: 8-way Hermes category routing from plain-English prompts into the right shelf
• Optimized prompt core: 2 bootstrapped few-shot demos selected by DSPy

This makes the pack materially easier to use from plain language. You no longer need to know the spell name first to land on the right shelf.

Spells that became more practically valuable once plain-English routing started working:

Set up the Python side in a repo-local virtualenv:

uv venv .venv
uv pip install --python .venv/bin/python -r requirements-dspy.txt

Baseline-only flow:

npm run dspy:validate
npm run dspy:baseline

Preferred DSPy flow:

export DSPY_MODEL=qwen/default
export DSPY_TEMPERATURE=0
export DSPY_MAX_TOKENS=256

bash scripts/dspy_full_run.sh

Use qwen/default to follow your local Qwen configuration, opencode/default to follow your OpenCode default model, or copilot/codex-5.3 to route through GitHub Copilot’s working Codex lane. See catalog/dspy/README.md, docs/dspy-router-runbook.md, and BECOME-A-WIZARD.md for the exact runbooks.

Safety and IP

The public Hermes surface intentionally refuses Compulsion, Dominate Monster, Dominate Person, Geas, and Modify Memory.

Original code and writing in this repo are released under CC0-1.0. That does not grant rights in Wizards of the Coast IP, trademarks, logos, artwork, or official rules text. This repo stays free, unofficial, and clearly separate from any official Wizards product line.

See LEGAL.md for the current fan-content and IP posture.