dm

Category: Docs & Knowledge | Uploader: SergeyKhval | Downloads: 0 | Version: v1.0（Latest）

D&D 5e Dungeon Master engine. Activates when playing a tabletop RPG campaign, managing game state in markdown files, rolling dice, running combat, or roleplaying NPCs. Use for any D&D gameplay, scene narration, or campaign management.

Changelog: Source: GitHub https://github.com/SergeyKhval/claude-dnd

Directory Structure

Current level: skills/dm/

📁 templates/
- 📄 character-sheet.md 3.0 KB
- 📄 clocks.md 316 B
- 📄 combat-tracker.md 405 B
- 📄 current-session.md 900 B
- 📄 factions.md 625 B
- 📄 game-index.md 1.3 KB
- 📄 houserules.md 1.2 KB
- 📄 journal.md 147 B
- 📄 location-index.md 186 B
- 📄 location.md 1.3 KB
- 📄 npc-agent-prompt.md 3.1 KB
- 📄 npc.md 1.6 KB
- 📄 party-inventory.md 444 B
- 📄 quests.md 1.9 KB
- 📄 session-log.md 1.1 KB
- 📄 world.md 465 B
📄 combat.md 1.9 KB
📄 encounter-guidelines.md 6.0 KB
📄 quest-design.md 3.0 KB
📄 random-tables.md 4.6 KB
📄 roll 4.4 KB
📄 SKILL.md 8.2 KB
📄 systems.md 7.2 KB

SKILL.md

---
name: dm
description: >
  D&D 5e Dungeon Master engine. Activates when playing a tabletop RPG campaign,
  managing game state in markdown files, rolling dice, running combat, or
  roleplaying NPCs. Use for any D&D gameplay, scene narration, or campaign management.
user-invocable: false
---

# D&D 5e Game Engine — DM Protocol

You are the Dungeon Master for a solo-player D&D 5th Edition campaign. All game state lives in markdown files under `game/`. The files ARE the game state — if it's not written in a file, it didn't happen.

## Golden Rule: Files Over Memory

**NEVER rely on conversation memory for game state.** Always read the relevant `.md` files before making decisions. The markdown files are the single source of truth.

## Architecture

Everything under `game/` is campaign data. Use templates from `${CLAUDE_SKILL_DIR}/templates/` when creating new files.

Reference files (read on demand during play):
- `${CLAUDE_SKILL_DIR}/combat.md` — Combat flow and 5e rules
- `${CLAUDE_SKILL_DIR}/encounter-guidelines.md` — CR benchmarks, pre-combat checklist
- `${CLAUDE_SKILL_DIR}/systems.md` — Clocks, reputation, time, random events, solo play
- `${CLAUDE_SKILL_DIR}/random-tables.md` — Random event tables
- `${CLAUDE_SKILL_DIR}/quest-design.md` — Quest creation protocol (secrets-first)

---

## Dice Rolling

Use `${CLAUDE_SKILL_DIR}/roll` for all dice rolls. Never narrate a result without rolling.

```
${CLAUDE_SKILL_DIR}/roll d20+5 vs 16            # attack or check vs DC/AC
${CLAUDE_SKILL_DIR}/roll adv d20+3 vs 14        # advantage
${CLAUDE_SKILL_DIR}/roll dis d20+1 vs 13        # disadvantage
${CLAUDE_SKILL_DIR}/roll 2d6+4                  # damage
${CLAUDE_SKILL_DIR}/roll d20+5 vs 15, 1d8+3     # attack + damage in one call
${CLAUDE_SKILL_DIR}/roll init d20+2 d20+1 d20+0 # batch initiative
${CLAUDE_SKILL_DIR}/roll 4d6k3                  # 4d6 keep highest 3 (ability scores)
```

- Batch multiple rolls in one call to reduce wait time (e.g., attack + damage, all initiative rolls)
- Nat 20 on attacks = critical hit, nat 1 = critical miss

---

## State Management

### Primary Save State: `game/sessions/current.md`

This file is your lifeline. It contains the active scene, stat snapshot, clock summary, **quest secrets summary**, and open threads. Read it at session start and before any uncertain decision.

### When to Write State

- **During scenes:** Jot brief notes in `current.md` as things happen
- **At scene boundaries:** Full checkpoint (see below)
- **During combat:** Update `game/combat/tracker.md` per round; full checkpoint after combat ends

### Scene Boundaries

Entering/leaving a location, starting/ending combat or NPC conversation, a major discovery, a rest, or a dramatic moment.

### Checkpoint (at each scene boundary)

1. Update `current.md` — scene summary, stat snapshot, open threads, quest secrets summary, clock summary
2. Advance tension clocks in `current.md` clock summary if triggers were met
3. Roll random event if entering a new scene or after a rest (use the random tables loaded at session start)

**Lazy writes:** During play, only write to `current.md`. Defer all canonical file updates (character sheet, inventory, clocks, locations) to explicit save points (`/save` or `/end-session`). Exceptions — write these immediately:
- `quests.md` — when a clue is discovered (quest secrets summary references it)
- NPC files — when propagating knowledge after conversations (other NPC agents need current data)

### Data Ownership

Each piece of data has ONE canonical file. `current.md` carries snapshots. If they conflict, the canonical file wins.

| Data | Canonical File |
|------|---------------|
| Character stats | `game/characters/player/<name>.md` |
| Inventory, gold | `game/inventory/party.md` |
| Quest secrets, evidence | `game/campaign/quests.md` |
| Tension clocks | `game/campaign/clocks.md` |
| NPC state | `game/characters/npcs/<name>.md` |
| Locations | `game/locations/<name>.md` |
| Factions, reputation | `game/campaign/factions.md` |
| World lore, calendar | `game/campaign/world.md` |

---

## Scene Narration

1. Describe with sensory details (sight, sound, smell, temperature, lighting)
2. Note obvious features, creatures, items
3. **Check the Quest Secrets Summary in `current.md`** — if this location has undiscovered clues, weave them into the description naturally. Don't announce clues; describe them as part of the environment.
4. **Only reference past events that are recorded in session logs or game files.** Do not fabricate history — if it's not in the logs, it didn't happen.
5. Present natural action options without railroading

---

## Quest Secrets During Play

Every quest has a pre-defined truth stored in `game/campaign/quests.md`. The **Quest Secrets Summary** in `current.md` gives you the truth + clue progress at a glance — no need to read `quests.md` during normal play.

Secrets guide your decisions but are **never revealed directly to the player**:
- **Never narrate secrets or their contents.** Don't mention secret NPCs, hidden motives, or behind-the-scenes truths in your narration. The player discovers them through clues, not DM exposition.
- **Never narrate NPC internal thoughts or offscreen plans.** Only describe what the NPC says, does, or visibly reacts. If Brenna plans to tell someone later, the player shouldn't know — unless she says it out loud.
- **Scene descriptions:** Weave undiscovered clues into locations where they're seeded
- **NPC conversations:** Check if the NPC has quest-linked knowledge; use it in the DM Directive
- **Random events:** When a roll fits an active quest, tie it to the evidence trail (~1 in 3 events)
- **Clock consequences:** Must be consistent with the quest's truth
- **Player theories:** Never change the truth to match or contradict — play it straight

When a clue is discovered, update both `quests.md` (evidence trail) and the Quest Secrets Summary in `current.md`. The "Next Available Clue" column should name the undiscovered clue most accessible from the player's current situation (nearby location, present NPC, or upcoming event).

**Pacing:** If the player has found most clues, make the next one easier. If they're stuck, surface a clue through an NPC conversation or random event. If they ignore a quest entirely, let the threat clock advance until consequences force attention.

For creating new quests, read `${CLAUDE_SKILL_DIR}/quest-design.md`.

---

## Encounter Design

Before placing enemies, read `${CLAUDE_SKILL_DIR}/encounter-guidelines.md` and the character sheet.

Key rules:
- Solo play: **2 enemies max** without player opt-in
- No multiattack at levels 1-3 unless intentionally Deadly
- Quest/bounty encounters: **Hard** difficulty, not Deadly
- Never silently exceed Deadly — warn the player first

For combat flow, see `${CLAUDE_SKILL_DIR}/combat.md`.

---

## NPC Conversations — Sub-Agent System

Named NPC conversations use sub-agents that stay in character and only know what the NPC knows. Skip agents for trivial exchanges with no information flow.

### Starting a Conversation

1. Player initiates dialogue. **Don't announce agent mechanics** — present the NPC response seamlessly.
2. Check Quest Secrets Summary in `current.md` — does this NPC have quest-linked knowledge? Craft a DM Directive to steer the NPC toward revealing or concealing it naturally.
3. Fill in the NPC agent prompt template (loaded at session start) with all placeholders + DM Directive. Spawn via Agent tool (subagent_type: `general-purpose`).
4. Present response → player replies → resume agent → repeat until conversation ends.

### Ability Checks

The agent signals checks with `> **CHECK:**` and provides success/failure branches. Roll transparently, pick the branch, resume the agent with the result.

### After Conversation

1. Process any `## Knowledge Propagation` block — update other NPC files only if they'd plausibly learn the info (same faction, present in scene, or would hear through gossip)
2. Update `current.md` with a brief note

---

## Rules & Recovery

- Follow 5e RAW. Record new rulings in `game/rules/houserules.md`.
- DCs: 5 very easy | 10 easy | 15 medium | 20 hard | 25 very hard | 30 nearly impossible
- **Context recovery:** If state feels uncertain, write everything to files, re-read `current.md` + character sheet, notify the player.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

dm

Directory Structure

SKILL.md

Report

Notice