dungeon-smith

Generate keyed dungeon rooms and ASCII maps from an adventure premise.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/giodl73-repo/QUEST --skill dungeon-smith
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dungeon-smith
Source: https://github.com/giodl73-repo/QUEST/tree/main/.claude/skills/dungeon-smith
Command: npx skills add https://github.com/giodl73-repo/QUEST --skill dungeon-smith

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate keyed dungeons for a D&D 5e adventure from an adventure premise, outputting per-room files and an ASCII map, and enforcing quality gates across persona lenses.

Core Features & Use Cases

  • Produces rooms/map.md — ASCII map with room numbers, connections, and a legend.
  • Creates rooms/NN-<slug>.md for each keyed location (e.g., NN-dungeon-smith.md).
  • Generates encounters/wandering-pressure.md when the dungeon is a tomb, crypt, or sealed space.
  • Reads treasures/<artifact>-manifest.md to honor curse symptoms and ensure distribution of symptoms across rooms.
  • Enforces cross-skill quality gates (Jaquays topology, Stuart atmosphere, Schick treasure-framing, Moldvay table-readiness, Gygax attrition).

Quick Start

Place a premise.md in adventures/dungeon-smith/premise.md and run this skill to produce rooms/map.md and NN-dungeon-smith.md files.

Frequently Asked Questions about dungeon-smith

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a D&D dungeon map from an adventure premise?▼

To generate a D&D dungeon map from an adventure premise, the skill reads your premise.md file and outputs per-room keyed location files alongside a rooms/map.md ASCII map with connections and a legend.

What is a keyed dungeon map and how does it structure adventure rooms?▼

A keyed dungeon map structures adventure rooms by assigning each location a unique number and markdown file, enforcing Jaquays topology and narrative gates across the generated rooms to ensure a cohesive layout.

Can I use an artifact manifest to distribute treasure and curse symptoms across dungeon rooms?▼

Yes, you can use an artifact manifest to distribute treasure and curse symptoms across dungeon rooms by placing a treasures manifest file, which the generator reads to ensure proper distribution throughout the layout.

Does this dungeon generator support sealed spaces like tombs and crypts?▼

Yes, this dungeon generator supports sealed spaces like tombs and crypts by producing specialized wandering pressure encounter files tailored for these specific sealed adventure environments.

How do I enforce quality gates like Jaquays topology and Moldvay table-readiness when designing a dungeon?▼

To enforce quality gates like Jaquays topology and Moldvay table-readiness when designing a dungeon, the skill applies cross-skill checks during generation to ensure proper layout, atmosphere, treasure-framing, and attrition across all rooms.

What file format do I need to start building a dungeon with an ASCII map generator?▼

To start building a dungeon with an ASCII map generator, you need a markdown premise file placed in the adventures directory, which serves as the sole required input to produce the map and room files.