skills.rest
Thedougler
ThedouglerCOMMUNITY
Explore all skills by this author →
GitHub

roll-dice

Rolls dice via a bash script for tabletop RPG checks, attacks, and random tables.

Updated May 29, 2026
Search Tags:#bash#ttrpg#dice roller#advantage#random number#tabletop rpg#dnd 5e
One-click install
npx skills add https://github.com/Thedougler/shattered-sea-wiki --skill roll-dice-thedougler
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: roll-dice
Source: https://github.com/Thedougler/shattered-sea-wiki/tree/main/.claude/skills/roll-dice
Command: npx skills add https://github.com/Thedougler/shattered-sea-wiki --skill roll-dice-thedougler

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? LLMs cannot generate true randomness, so any dice result they invent is a pattern-matched guess rather than a real roll. This Skill forces every dice outcome in a D&D 5e session through a bash script that uses the system's random number generator, making rolls fair and canonical. ## Core Features & Use Cases - True Random Rolls: Executes roll.sh, which uses the shell's RANDOM generator to produce genuine dice outcomes. - Full Dice Notation Support: Handles single dice (d20, d100), multiple dice (2d6, 3d8), flat modifiers (+5, -2), and advantage/disadvantage rolls. - Canon Enforcement: Instructs the agent to treat script output as the final truth, forbidding fudging, re-rolling, or narratively softening results. - Use Case: During a live session, a player makes an attack roll with advantage and a +7 modifier; the agent runs roll.sh d20 -a +7 and reports the exact integer result as the outcome. ## Quick Start Ask the agent to roll a d20 with advantage and a +5 modifier for your attack roll.

Frequently Asked Questions about roll-dice

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

FAQPage Schema
How do I roll dice with advantage in a bash script?▼

Run roll.sh with the -a flag, such as roll.sh d20 -a, which rolls the die twice and keeps the higher result. Use -d for disadvantage to keep the lower result. Advantage and disadvantage only work with a single die, not multiple dice like 2d20.

How do I roll multiple dice with a modifier on the command line?▼

Use NdX notation followed by the modifier, for example roll.sh 3d8 +3 rolls three d8 dice, sums them, and adds 3. The script outputs a single integer representing the final total.

Why can't an LLM generate random dice rolls itself?▼

LLMs have no access to entropy, so any number they produce is a pattern-matched guess rather than a random outcome. This Skill routes every roll through roll.sh, which uses the operating system's random number generator for genuine randomness.

What dice types does roll.sh support?▼

The script supports any die size expressed in NdX notation, including d4, d6, d8, d10, d12, d20, and d100. It also handles multiple dice like 2d6 and flat positive or negative modifiers.

When should the agent not roll dice during a session?▼

Rolls are skipped for passive checks, fixed DCs the DM has already decided, or when the user explicitly says to skip the roll or auto-succeed. Otherwise, any uncertain outcome called for by the rules or DM triggers a roll.

Related Skills

Explore More Personal & Entrepreneur Skills→
erhankaraarslanerhankaraarslan

session-handoff

Update CLAUDE.md Active Context, Last Status, and Next Steps sections.

Community
Basic
serelonserelon
2

rpg-tools

Manage solo RPG sessions with dice, tarot, oracles, and campaign data.

Community
Advanced
optionioptioni

dnd-graphql

Implement GraphQL resolver, query, mutation, and subscription patterns for D&D 5e applications.

Official
Intermediate
mmacymmacy

oracle

Roll Ironsworn oracle tables and Ask the Oracle via a Python CLI.

Community
Intermediate