dnd-simple-combat

Coordinate D&D 5e combat encounters with Python scripts and SQLite.

1|1|Updated Nov 14, 2025
One-click install
npx skills add https://github.com/JoeCotellese/dnd-dm-skill --skill dnd-simple-combat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dnd-simple-combat
Source: https://github.com/JoeCotellese/dnd-dm-skill/tree/main/tutorial-3-simple-combat
Command: npx skills add https://github.com/JoeCotellese/dnd-dm-skill --skill dnd-simple-combat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the tedious manual work of running D&D 5th Edition combat encounters, including tracking initiative, rolling dice, calculating damage, and managing character/monster HP. It frees up the Dungeon Master to focus on narrative and player engagement.

Core Features & Use Cases

  • Turn-Based Combat: Orchestrates multi-step combat workflows with initiative, attack rolls, damage resolution, and end conditions.
  • Persistent & Transient State: Tracks character HP persistently in a database and monster HP transiently per encounter.
  • Narrative Generation: Transforms combat data into engaging, radio-drama style descriptions, complete with transparent dice rolls.
  • Use Case: Run a D&D training arena combat encounter for your players, letting the AI handle all the complex mechanics and dice rolls while you focus on describing the action.

Quick Start

I want Thorin to fight a monster in the training arena

Frequently Asked Questions about dnd-simple-combat

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

FAQPage Schema
How do I automate D&D 5e combat encounter tracking?

Automate D&D 5e combat by orchestrating turn-based encounters with initiative rolls, attack resolution, damage calculation, and HP tracking. This Skill handles dice rolls, monster selection, equipment assignment, and narrative generation, freeing you to focus on storytelling while mechanics run automatically.

Can I track character HP persistently across multiple combat encounters?

Yes. Character HP persists in a database across encounters, while monster HP resets per encounter. The Skill maintains state in SQLite, allowing your player character to retain damage and healing between separate combats in an ongoing campaign.

How does initiative and turn order work in automated combat?

Initiative rolls are generated automatically at the start of each encounter, determining turn order for all combatants. The Skill orchestrates multi-step turn sequences with attack rolls, damage resolution, and status updates until an end condition is reached—victory, defeat, flee, or surrender.

What does the combat narration output look like?

Combat narration is delivered in radio-drama style with transparent dice roll results, hit/miss outcomes, and damage applied. Narrative descriptions transform raw combat data into engaging descriptions of each turn's action, keeping players immersed in the encounter.

Do I need Python installed to run D&D combat automation?

Yes. The Skill orchestrates Python scripts via CLI and exchanges JSON data, persisting state in SQLite. You'll need Python available in your environment to execute the bestiary, equipment, character, dice rolling, and combat modules.

Can I customize monsters and equipment in combat encounters?

Yes. The Skill supports monster selection from a bestiary and equipment assignment before each encounter. You configure your combatants' gear and opponent types, then the automation handles initiative, rolls, and HP tracking for the entire encounter.