KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #deepseek-harness #typescript #ai-agent #codex #developer-tools #claude-code #windows #mcp #python #desktop-app

Wizards-of-the-Ghosts

★ 106 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

```
    ╔═══════════════════════════════════════════════════╗
    ║                                                   ║
    ║    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

```bash
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:

```bash
npm run install:hermes-skills
```

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

```bash
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

| | |
|---|---|
| 🔗 **[Attune](generated/hermes/investigation-and-preparation/attune/SKILL.md)** — Bond this spellbook to your workflow so every spell knows your stack, your tools, and your priorities. | 🔮 **[Detect Magic](generated/hermes/investigation-and-preparation/detect-magic/SKILL.md)** — Surface hidden AI affordances, agents, automations, and tool hooks before acting. |
| 🔍 **[Identify](generated/hermes/investigation-and-preparation/identify/SKILL.md)** — Explain what a mysterious file, service, workflow, or artifact actually does. | 🗺️ **[Comprehend Languages](generated/hermes/investigation-and-preparation/comprehend-languages/SKILL.md)** — Translate code, jargon, protocol surfaces, or human language into operational meaning. |
| 🕵️ **[Investigation](generated/hermes/investigation-and-preparation/investigation/SKILL.md)** — Follow evidence through a system until the hidden mechanism becomes legible. | 🖐️ **[Mage Hand](generated/hermes/actions-access-and-automation/mage-hand/SKILL.md)** — Manipulate files, records, and lightweight system state with precision and minimal blast radius. |
| 🔒 **[Forcecage](generated/hermes/containment-and-intervention/forcecage/SKILL.md)** — Contain untrusted code, agents, or operations inside a tested cage before anything leaves it. | 🛡️ **[Glyph of Warding](generated/hermes/monitoring-and-protection/glyph-of-warding/SKILL.md)** — Set monitors, watches, or trigger conditions that alert when a boundary is crossed. |
| 🌙 **[Dream](generated/hermes/messaging-and-coordination/dream/SKILL.md)** — Deliver the briefing before the recipient wakes up needing it. | 🪂 **[Feather Fall](generated/hermes/repair-and-recovery/feather-fall/SKILL.md)** — Turn a hard crash into a controlled descent. |

Recent GEPA upgrade: [Forcecage](generated/hermes/containment-and-intervention/forcecage/SKILL.md) 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](GRIMOIRE.md) for the full browse layer.

## Find Your Shelf

| If you want to... | Start here | Hermes shelf |
| --- | --- | --- |
| Figure out what you're looking at | [Detect Magic](generated/hermes/investigation-and-preparation/detect-magic/SKILL.md), [Identify](generated/hermes/investigation-and-preparation/identify/SKILL.md), [Investigation](generated/hermes/investigation-and-preparation/investigation/SKILL.md), [Comprehend Languages](generated/hermes/investigation-and-preparation/comprehend-languages/SKILL.md) | [Investigation and Preparation (29)](GRIMOIRE.md#investigation-and-preparation) |
| Change the system without a battleaxe | [Mage Hand](generated/hermes/actions-access-and-automation/mage-hand/SKILL.md), [Sleight of Hand](generated/hermes/actions-access-and-automation/sleight-of-hand/SKILL.md), [Unseen Servant](generated/hermes/actions-access-and-automation/unseen-servant/SKILL.md), [Awaken](generated/hermes/actions-access-and-automation/awaken/SKILL.md) | [Actions, Access, and Automation (19)](GRIMOIRE.md#actions-access-and-automation) |
| Light up the black box | [Dancing Lights](generated/hermes/monitoring-and-protection/dancing-lights/SKILL.md), [Light](generated/hermes/monitoring-and-protection/light/SKILL.md), [Glyph of Warding](generated/hermes/monitoring-and-protection/glyph-of-warding/SKILL.md), [Scrying](generated/hermes/monitoring-and-protection/scrying/SKILL.md) | [Monitoring and Protection (17)](GRIMOIRE.md#monitoring-and-protection) |
| Get the right message to the right place | [Message](generated/hermes/messaging-and-coordination/message/SKILL.md), [Sending](generated/hermes/messaging-and-coordination/sending/SKILL.md), [Dream](generated/hermes/messaging-and-coordination/dream/SKILL.md), [Magic Mouth](generated/hermes/messaging-and-coordination/magic-mouth/SKILL.md) | [Messaging and Coordination (9)](GRIMOIRE.md#messaging-and-coordination) |
| Stop the bleeding | [Cure Wounds](generated/hermes/repair-and-recovery/cure-wounds/SKILL.md), [Mending](generated/hermes/repair-and-recovery/mending/SKILL.md), [Feather Fall](generated/hermes/repair-and-recovery/feather-fall/SKILL.md), [Animal Handling](generated/hermes/repair-and-recovery/animal-handling/SKILL.md) | [Repair and Recovery (13)](GRIMOIRE.md#repair-and-recovery) |
| Mock it before you ship it | [Minor Illusion](generated/hermes/simulation-and-staging/minor-illusion/SKILL.md), [Major Image](generated/hermes/simulation-and-staging/major-image/SKILL.md), [Deception](generated/hermes/simulation-and-staging/deception/SKILL.md), [Programmed Illusion](generated/hermes/simulation-and-staging/programmed-illusion/SKILL.md) | [Simulation and Staging (8)](GRIMOIRE.md#simulation-and-staging) |
| Handle people with care | [Calm Emotions](generated/hermes/influence-and-behavior/calm-emotions/SKILL.md), [Heroism](generated/hermes/influence-and-behavior/heroism/SKILL.md), [Fear](generated/hermes/influence-and-behavior/fear/SKILL.md), [Plant Growth](generated/hermes/influence-and-behavior/plant-growth/SKILL.md) | [Influence and Behavior (18)](GRIMOIRE.md#influence-and-behavior) |
| Box in blast radius | [Forcecage](generated/hermes/containment-and-intervention/forcecage/SKILL.md), [Blindness/Deafness](generated/hermes/containment-and-intervention/blindness-deafness/SKILL.md), [Feeblemind](generated/hermes/containment-and-intervention/feeblemind/SKILL.md), [Power Word Stun](generated/hermes/containment-and-intervention/power-word-stun/SKILL.md) | [Containment and Intervention (10)](GRIMOIRE.md#containment-and-intervention) |

## Browse Deeper

- [GRIMOIRE.md](GRIMOIRE.md) for the featured shelf, browse paths, and full linked category index
- `generated/hermes/<category>/<skill>/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:

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

Or:

```bash
npm run bootstrap
```

## Verification

```bash
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/`](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:

| | |
|---|---|
| 🌅 **[Awaken](generated/hermes/actions-access-and-automation/awaken/SKILL.md)** — Teach an old machine to answer back. | ⚡ **[Animate Objects](generated/hermes/actions-access-and-automation/animate-objects/SKILL.md)** — Give agency to passive data by attaching triggers, watchers, and autonomous update logic. |
| 🚪 **[Dimension Door](generated/hermes/actions-access-and-automation/dimension-door/SKILL.md)** — Jump cleanly between two known contexts without dragging the whole room. | 🔮 **[Foresight](generated/hermes/investigation-and-preparation/foresight/SKILL.md)** — Estimate likely outcomes before committing to a plan, change, or launch. |
| ⚜️ **[Symbol](generated/hermes/monitoring-and-protection/symbol/SKILL.md)** — Mark a resource with a named sigil that triggers automatic policy enforcement when conditions are met. | 📡 **[Project Image](generated/hermes/simulation-and-staging/project-image/SKILL.md)** — Project a version of yourself into a place you cannot physically be. |

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

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

Baseline-only flow:

```bash
npm run dspy:validate
npm run dspy:baseline
```

Preferred DSPy flow:

```bash
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`](catalog/dspy/README.md), [`docs/dspy-router-runbook.md`](docs/dspy-router-runbook.md), and [`BECOME-A-WIZARD.md`](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](LEGAL.md) for the current fan-content and IP posture.

Wizards-of-the-Ghosts

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README