---
slug: "dnd-dm-skill"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/JoeCotellese/dnd-dm-skill@main/README.md"
repo: "https://github.com/JoeCotellese/dnd-dm-skill"
source_file: "README.md"
branch: "main"
---
# 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.