This skill should be used 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.
This skill inherits all available tools. When active, it can use any tool Claude has access to.
scripts/roll.shProvides a bash script for rolling dice in RPG adventures with JSON output for programmatic use.
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.
| 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) |
The script outputs JSON with individual rolls and computed total:
{
"expression": "2d6+3",
"rolls": [4, 2],
"modifier": 3,
"total": 9
}
For adventures with RPG rules (indicated by System.md), use dice rolls for:
Skill Check (d20 system):
bash "${CLAUDE_PLUGIN_ROOT}/skills/dice-roller/scripts/roll.sh" "1d20+5"
# Output: {"expression": "1d20+5", "rolls": [14], "modifier": 5, "total": 19}
Narrate the outcome based on the result vs the difficulty class.
Damage Roll:
bash "${CLAUDE_PLUGIN_ROOT}/skills/dice-roller/scripts/roll.sh" "2d6+3"
# Output: {"expression": "2d6+3", "rolls": [5, 4], "modifier": 3, "total": 12}
Describe the impact narratively - "Your sword bites deep, dealing 12 damage."