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.

bash

# 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:

bash

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

To find which file contains specific content:

bash

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:

bash

# 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:

bash

# 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

dnd5e-srd

NPX Install

Tags

SKILL.md Content

D&D 5e SRD RAG

When to Use This Skill

Search Strategy

1. Identify Relevant Page Ranges

File Index (by page range)

2. Search Using the Python Tools

3. Expand Context When Needed

4. Multi-hop Queries

5. Provide Accurate Answers with Source Citations

References Directory Structure

Python Tools

1. Search Tool (
`search_with_positions.py`
)

2. Context Expansion Tool (
`expand_context.py`
)

Best Practices

Notes

dnd5e-srd

NPX Install

Tags

SKILL.md Content

D&D 5e SRD RAG

When to Use This Skill

Search Strategy

1. Identify Relevant Page Ranges

File Index (by page range)

2. Search Using the Python Tools

3. Expand Context When Needed

4. Multi-hop Queries

5. Provide Accurate Answers with Source Citations

References Directory Structure

Python Tools

1. Search Tool (search_with_positions.py)

2. Context Expansion Tool (expand_context.py)

Best Practices

Notes

1. Search Tool (
`search_with_positions.py`
)

2. Context Expansion Tool (
`expand_context.py`
)