Roll real dice using OS randomness (not fabricated), optionally log results to NDJSON for audit, and emit a Markdown-ready summary for Mechanics blocks.
Use this skill whenever the game rules require a roll like d20 + stat + skill and you want outcomes to be truly random and auditable.
Roll a check:
python3 .codex/skills/dice-roller/scripts/roll_dice.py --expr "d20 + 5 + 1" --dc 15 --label "Ki ray (Agility+Ki Blast)" --mdRoll and append to an audit log (NDJSON):
python3 .codex/skills/dice-roller/scripts/roll_dice.py --expr "d20 + 5 + 1" --dc 15 --label "Turn 008: Ki ray" --log "worlds/<World>/campaigns/<Campaign>/campaign_logs/_rolls.ndjson" --mdSupported terms:
d20, 2d6, 4d4 (count defaults to 1)+ 3, - 2Examples:
d20 + 6 + 32d6 + 1Notes:
+/- terms.The script prints a single JSON object to stdout (last line), including:
expr, terms, per-die rolls, totaldc and computed successtimestamp_utc and a random nonce for auditabilityWith --md, it prints a Markdown-ready summary before the JSON.