dice-roller

name	dice-roller
description	This skill should be used when the GM needs to roll dice or when the user asks to "roll dice", "make a dice roll", "roll for initiative", "roll a skill check", "roll damage", or needs to resolve RPG mechanics with random dice outcomes. Provides deterministic dice rolling for tabletop RPG adventures.

Dice Roller Skill

Provides a bash script for rolling dice in RPG adventures with JSON output for programmatic use.

How to Roll Dice

Execute the dice roller script with a dice expression:

bash "${CLAUDE_PLUGIN_ROOT}/skills/dice-roller/scripts/roll.sh" "2d6+3"

The script is bundled with this skill and executes from the plugin directory.

Supported Expressions

Expression	Meaning
1d20	Roll one 20-sided die
2d6	Roll two 6-sided dice, sum them
1d20+5	Roll d20, add 5
3d8-2	Roll 3d8, subtract 2
4dF	Roll 4 Fudge dice (-1, 0, +1 each)
d100	Roll percentile (1-100)

Output Format

The script outputs JSON with individual rolls and computed total:

{
  "expression": "2d6+3",