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:

1. Break down the query into components
2. Search for each component separately
3. 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