dnd-dice-roller

Parse D&D dice notation and roll dice with modifiers and advantage.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill lets you roll D&D dice using familiar notation (e.g., d20, 2d6+3) and supports features like advantage, disadvantage, and dropping the lowest die, all via a simple script-backed workflow.

Core Features & Use Cases

  • Notation-driven dice rolls: Understands d20, 2d6, 4d6, and expressions like d20+5 or 2d6-2.
  • Special options: Support for advantage, disadvantage, and drop lowest to simulate typical ability-score generation or checks.
  • Deterministic execution via script: Uses a single Python script to ensure consistent and repeatable results.

Quick Start

Use the dice-roller script to roll dice: python3 ~/.claude/skills/tutorial-1-dice-rolling/scripts/roll_dice.py d20

Frequently Asked Questions about dnd-dice-roller

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

FAQPage Schema
How do I roll D&D dice using notation like d20 or 2d6+3?

D&D dice notation lets you specify dice rolls as shorthand: d20 rolls a 20-sided die, 2d6 rolls two 6-sided dice, and 2d6+3 adds a modifier. This Skill parses that notation and executes the rolls deterministically using a Python script, returning the total and individual results.

Does this dice roller support advantage, disadvantage, and dropping lowest?

Yes. The Skill handles advantage and disadvantage (rolling twice and taking higher or lower), and drop-lowest scenarios used in ability-score generation and D&D checks. These options apply to standard dice notation for consistent character creation and combat planning.

What's the fastest way to roll dice for character creation or in-game checks?

Use the included Python script with familiar D&D notation: `python3 roll_dice.py d20` for a single d20, or `python3 roll_dice.py 4d6` for four d6s. The script parses your input, validates it, and outputs results immediately without additional setup.

Can I roll multiple dice and apply modifiers in a single command?

Yes. Enter expressions like d20+5, 2d6-2, or 4d6 drop-lowest. The script validates the entire expression, rolls all dice, applies modifiers, handles special options, and formats the output—all in one execution.

What happens if I enter invalid dice notation?

The Skill includes robust error handling that validates your notation before rolling. Invalid input triggers clear feedback so you can correct it and re-run without confusion or unexpected results.

Is this dice roller suitable for both quick rolls and campaign planning?

Yes. The script-backed approach ensures repeatable, deterministic results suitable for quick in-game checks, ability-score generation during character creation, and pre-combat planning where consistency and speed matter.