D&D DM Skill Tutorial Series

Learn to build Claude Code skills by creating D&D Dungeon Master tools!

Overview

This tutorial series teaches skill-building for Claude Code through progressively building features for a D&D Dungeon Master assistant. Each tutorial is self-contained and focuses on specific skill-building concepts while implementing practical D&D functionality.

What You'll Learn

• How to structure and write Claude Code skills
• Working with tools (file I/O, random generation, etc.)
• Managing state and persistence
• Building multi-step workflows
• Leveraging Claude's generative capabilities
• Integrating multiple features into a cohesive tool

Tutorial Series

Tutorial 1: Dice Rolling ✅

Skill Concepts: Basic structure, tool usage, input parsing, output formatting D&D Feature: Dice roller supporting D&D notation (d20, 2d6+3, advantage/disadvantage)

Tutorial 2: Character Stats ✅

Skill Concepts: File I/O, JSON data structures, state persistence, data validation D&D Feature: Character sheet management with ability scores and modifiers

Tutorial 3: Simple Combat ✅

Skill Concepts: Multi-step workflows, turn-based state, decision trees D&D Feature: Basic combat system with attack rolls, damage, and HP tracking

Tutorial 4: Magic System

Skill Concepts: Resource management, conditional logic, different attack types, reference data D&D Feature: Spell casting with spell slots, spell attacks, saving throws, and cantrips

Tutorial 5: Character Progression

Skill Concepts: Progressive complexity, threshold triggers, calculated growth, career tracking D&D Feature: XP tracking, leveling system, ability improvements, and arena progression

Tutorial 6: Multi-Combatant Encounters

Skill Concepts: Collection management, priority queues, complex state synchronization, targeting logic D&D Feature: Party combat with multiple characters and monsters, initiative tracking, and AOE effects

Tutorial 7: Dungeon Crawling

Skill Concepts: Spatial state, exploration mechanics, procedural generation, environmental hazards D&D Feature: Room-by-room exploration, trap detection, treasure discovery, and map tracking

Tutorial 8: NPC & Social Encounters

Skill Concepts: Generative content, personality modeling, dialogue trees, relationship tracking D&D Feature: NPC generation, conversation systems, quest givers, and social interactions

Getting Started

Each tutorial includes:

• README.md: Overview, concepts, installation, and usage
• skill.md: The actual skill file ready to use
• examples/: Sample interactions and use cases
• Supporting files: JSON data, reference materials as needed

Start with Tutorial 1 to learn the basics, or jump to any tutorial that interests you. Each is self-contained with all necessary code included.

Prerequisites

• Claude Code installed and configured
• Basic familiarity with D&D 5th Edition (helpful but not required)
• Enthusiasm for learning!

Installation

Each tutorial's skill can be installed by copying the skill.md file to your .claude/skills/ directory. See individual tutorial READMEs for specific instructions.

Contributing

Found an issue or have a suggestion? Please open an issue or submit a pull request!

License

MIT License - feel free to use and modify these tutorials for your own learning and projects.