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.