dice-roller

Parse and roll standard dice notation with modifiers for tabletop RPGs.

28|3|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/nicmarti/skills-weaver --skill dice-roller-nicmarti
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dice-roller
Source: https://github.com/nicmarti/skills-weaver/tree/main/.claude/skills/dice-roller
Command: npx skills add https://github.com/nicmarti/skills-weaver --skill dice-roller-nicmarti

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines all dice rolls for RPG sessions, supporting common dice types, keep-high/keep-low notation, advantage/disadvantage, and basic stat generation.

Core Features & Use Cases

  • Dice notation support: d4, d6, d8, d10, d12, d20, d100 with modifiers.
  • Keep highest/lowest: 4d6kh3, 2d20kl1, etc.
  • Advantage/disadvantage: quick dual-roll mechanics.
  • Character stat generation: standard and classic methods.

Quick Start

Roll 2d6+3: ./sw-dice roll 2d6+3

Frequently Asked Questions about dice-roller

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

FAQPage Schema
How do I roll dice using standard RPG notation?

Roll dice using standard notation like 2d6+3 or 4d6kh3 by passing the expression to the dice-roller command. It parses dice types (d4–d20, d100), modifiers, and keep-highest/keep-lowest syntax, returning the individual rolls and total result transparently.

Can I use advantage and disadvantage mechanics in dice rolls?

Yes, dice-roller supports advantage/disadvantage for quick dual-roll mechanics commonly used in tabletop RPGs. It rolls twice and automatically selects the higher result for advantage or lower for disadvantage, displaying both rolls.

What dice types and notations does this support?

Dice-roller supports standard dice (d4, d6, d8, d10, d12, d20, d100) with complex notation including multiple dice (2d6), modifiers (2d6+3), and keep mechanics (4d6kh3 for keep highest 3). It handles combat rolls, damage, saves, and initiative.

How do I generate character stats for tabletop RPG character creation?

Dice-roller includes character stat generation methods for Basic Fantasy RPG scenarios, supporting standard and classic stat-rolling approaches. Roll predefined stat expressions to generate ability scores automatically.

Does dice-roller provide transparent roll records for audit trails?

Yes, dice-roller produces transparent roll records showing individual die results and the final total. This supports verification for combat rolls, damage calculations, saves, and other game mechanics requiring accurate documentation.

Can I use dice-roller from the command line without additional setup?

Dice-roller runs as a CLI tool with zero dependencies, accepting dice notation as arguments (e.g., ./sw-dice roll 2d6+3). It requires no configuration or external libraries, making it immediately usable for quick rolls during sessions.