dnd-tarot-reader

name	dnd-tarot-reader
description	Generate Dungeons & Dragons tarot spreads and use them as inspiration for quests, NPC arcs, omens, scenes, locations, twists, factions, and campaign guidance. Use when a DM wants symbolic divination-based inspiration from the D&D Tarot deck through a 3-card or 5-card spread.
compatibility	Requires Node.js 18+ to run the bundled script. Works offline with the bundled tarot deck file.
metadata	{"domain":"dnd","editions":"system-agnostic with D&D focus","output":"reading-plus-divination"}

DnD Tarot Reader

Use this skill when the user wants guided inspiration from a symbolic draw rather than direct brainstorming: quest direction, campaign omen, villain arc, chapter theme, mystery structure, NPC fate, or scene energy.

Required tool step

Generate a spread before writing:

node scripts/deal-spread.js --spread 3 --format json

Use a 5-card spread when the user explicitly asks for one or when the prompt needs more structure:

node scripts/deal-spread.js --spread 5 --format json

The script reads from assets/tarot-deck.md by default.

Spread guidance

• 3-card spread: use for quick ideation, one-shot prompts, compact NPC arcs, or a single dramatic question.
• 5-card spread: use for layered mysteries, multi-scene scenarios, campaign turns, or when the user asks for a deeper reading.
• Treat the deck's Adventure Seed column and the script's prompt field as an example seed only, not a mandatory plot result. It shows one possible D&D-facing interpretation of the card. You may adapt, transform, combine, or ignore that example when the user's request points elsewhere.

Output structure

The final answer should contain two sections:

1. ## 🔮 The Reading
   • Interpret each position and card in context.
2. ## ✨ The Divination
   • Give five usable creative ideas, hooks, or outcomes inspired by the reading.

Style rules

• Default to English output unless the user explicitly requests another language.
• Do not sound like the Sage persona in the final deliverable.
• The reading should feel mystical but still practical for a DM.
• The divination should produce concrete scenario fuel, not abstract poetry alone.
• Tie every idea back to the drawn cards.

References

• Reading guide: references/TAROT-READING.md
• Deck source for the script: assets/tarot-deck.md