dnd

What This Skill Does

The dnd skill is a comprehensive toolkit designed to streamline Dungeons & Dragons 5th Edition sessions for both players and Dungeon Masters. Acting as a digital interface for the official D&D 5e SRD (System Reference Document), it brings core rulebook mechanics directly into your terminal or AI-integrated environment. Whether you are in the heat of combat or planning a world-building session, this skill provides instant access to complex data structures like monster stat blocks, spell descriptions, and encounter scaling.

Installation

To integrate the D&D toolkit into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/capt-marbles/dnd

Ensure that you have python3 installed on your system, as the dnd.py script utilizes it to handle logic and API parsing. Once installed, you can trigger commands directly using the python3 dnd.py syntax prefix in your shell.

Use Cases

This skill is perfect for scenarios where physical books are unavailable or when you need rapid calculations. DMs can use the encounter builder to balance fights on the fly based on specific Party Challenge Ratings, avoiding the time-consuming process of manually checking monster CRs. Players can use the character generator for quick one-shots or NPC creation. The dice roller supports complex modifiers, allowing for precise game mechanics such as '1d20+5' or advantage/disadvantage rolls. It is an essential asset for online tabletop play, speeding up information retrieval and reducing downtime during complex encounters.

Example Prompts

1. "Roll a d20 with a +5 modifier for my attack check."
2. "Look up the stats for an Ancient Red Dragon and list its special abilities."
3. "Generate a random encounter for a level 5 adventuring party to use in my next session."

Tips & Limitations

The skill relies on the official 5e SRD, which means it contains only open-source content. While this covers most core rules, monsters or spells exclusive to specific sourcebooks (like Xanathar's or Tasha's) may not be available. Always double-check your dice math for complex rolls. If you are a DM, use the --list flag to get a quick overview of available creatures before narrowing down your search, which helps in identifying monsters within the correct CR range for your encounter balance. For long sessions, keeping a terminal window open exclusively for this skill can significantly improve your efficiency.