D&D 5e SRD RAG

This skill provides search-based retrieval access to the Dungeons & Dragons 5th Edition System Reference Document (SRD), organized by page ranges as markdown files in the references/ directory.

When to Use This Skill

Use this skill whenever answering questions about D&D 5e SRD content, including:

• Core rules and gameplay procedures

• Ability checks, saving throws, and skill use

• Combat, actions, conditions, and movement

• Classes, backgrounds, equipment, and magic items

• Spells and spellcasting

• Creatures and stat blocks included in the SRD

Search Strategy

Follow this agentic search process for D&D 5e SRD queries:

1. Identify Relevant Page Ranges

The SRD is organized by page ranges. Use this file index to locate content:

Important: Always use the Python search tool (scripts/search_with_positions.py ) to get exact character positions for source citations.

File Index (by page range)

Note: Topics below follow your provided outline and are aligned to the actual file splits; where a topic spans multiple files, it's marked as continued.

• DND5eSRD_001-018.md : Intro through Character Creation

• DND5eSRD_019-035.md : Barbarian, Bard, Cleric (start)

• DND5eSRD_036-046.md : Cleric/Druid, Fighter, Monk (start)

• DND5eSRD_047-063.md : Monk, Paladin, Ranger, Rogue

• DND5eSRD_064-076.md : Sorcerer, Warlock, Wizard (start)

• DND5eSRD_077-086.md : Wizard, Origins, Feats

• DND5eSRD_087-103.md : Equipment

• DND5eSRD_104-120.md : Spells

• DND5eSRD_121-137.md : Spells

• DND5eSRD_138-154.md : Spells

• DND5eSRD_155-175.md : Spells

• DND5eSRD_176-191.md : Rules Glossary (part)

• DND5eSRD_192-203.md : Gameplay Toolbox, Magic Items (start, part 1)

• DND5eSRD_204-229.md : Gameplay Toolbox, Magic Items (continued)

• DND5eSRD_230-252.md : Magic Items (continued)

• DND5eSRD_253-272.md : Monsters intro + early entries

• DND5eSRD_273-292.md : Monsters

• DND5eSRD_293-312.md : Monsters

• DND5eSRD_313-332.md : Monsters

• DND5eSRD_333-364.md : Monsters / Animals (continued)

2. Search Using the Python Tools

Primary method: use the search + expand workflow for accurate positions and structured context.

Step 1: Search to find content with exact character positions

python /skills/dnd5e-srd/scripts/search_with_positions.py "search term" --all

Step 2: If you need more context, expand specific result(s)

python /skills/dnd5e-srd/scripts/expand_context.py "search term" --result 3 --mode section --all

Examples

Search combat-related terms

python /skills/dnd5e-srd/scripts/search_with_positions.py "grapple" --all

Search spells and expand result #1 by section

python /skills/dnd5e-srd/scripts/expand_context.py "fireball" --result 1 --mode section --all

Search specific page ranges

python /skills/dnd5e-srd/scripts/search_with_positions.py "longsword" --pages 200-300

Batch expand multiple results

python /skills/dnd5e-srd/scripts/expand_context.py "Attack" --results 1,3,5 --mode paragraph --all

The search tool returns:

• Filename

• Character range (start-end positions)

• Matched text with context

• Ready-to-use citation format: [filename, chars START-END]

The expand tool returns:

• Expanded text (paragraph, section, or entire document)

• Heading breadcrumb trail

• Original match position within the expansion

• Expansion bounds and metadata

3. Expand Context When Needed

After searching, expand results that need deeper context:

• Use --mode paragraph for surrounding text

• Use --mode section to get the full rule section with headings

• Use --results 1,3,5 to batch expand multiple results

4. Multi-hop Queries

For questions requiring multiple pieces of information:

• Break down the query into components

• Search for each component separately

• Synthesize the information from multiple sources

5. Provide Accurate Answers with Source Citations

After retrieving information:

• Quote or paraphrase the exact rules as needed

• Always cite sources using the character position format: [filename, chars START-END]

• Include multiple sources when relevant

• Cite at the end of the relevant information, not inline

Citation examples:

The spell Fireball deals 8d6 fire damage on a failed save. [DND5eSRD_293-312.md, chars 12000-12100]

A grapple check uses Athletics vs. the target's escape DC (see Conditions). [DND5eSRD_087-103.md, chars 5400-5600]

References Directory Structure

The references/ directory contains the SRD split into page-range files. Files are named DND5eSRD_XXX-YYY.md where XXX-YYY is the page range.

To list all files:

ls -lh /skills/dnd5e-srd/references/

To find which file contains specific content:

grep -l "search term" /skills/dnd5e-srd/references/*.md

Python Tools

1. Search Tool (search_with_positions.py )

Features:

• Searches SRD reference files with regex-based term matching

• Returns precise character ranges for each match

• Includes contextual text around matches

• Supports filtering by page ranges or specific files

Usage:

Basic search across all files

python scripts/search_with_positions.py "term" --all

Search specific page range

python scripts/search_with_positions.py "term" --pages 200-300

Control output

python scripts/search_with_positions.py "term" --all --max-results 10 --context 200

Case-sensitive search

python scripts/search_with_positions.py "Attack" --all --case-sensitive

2. Context Expansion Tool (expand_context.py )

Features:

• Expands specific search results with boundary-aware modes

• Modes: paragraph (default), section , section-only , char , document

• Provides heading breadcrumb trails for context

• Supports batch expansion and JSON output

Usage:

Expand a specific search result by section

python scripts/expand_context.py "fireball" --result 3 --mode section --all-search

Expand multiple results at once

python scripts/expand_context.py "Attack" --results 1,3,5 --mode paragraph --all-search

Direct expansion from known file position

python scripts/expand_context.py --file "DND5eSRD_121-137.md" --position 1234 --mode section

JSON output for machine processing

python scripts/expand_context.py "wizard" --result 1 --all-search --format json

Best Practices

• Use the Python tools: search first, then expand for deeper context

• Always cite sources with [filename, chars START-END]

• Leverage structure: use --mode section to get full rules and headings

• Be specific: search for exact SRD terminology

• Check multiple files: related rules may span multiple ranges

• Handle ambiguity: present possible interpretations with citations

Notes

• Files are organized by page ranges (e.g., 001-018, 019-035)

• Some files are large (up to 120K+); prefer targeted searches

• This skill includes SRD content only; not supplements or non-SRD material