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.