session-ingest

Extracts canon, combat stats, and speaker identities from raw D&D session transcript CSVs.

Updated May 29, 2026
One-click install
npx skills add https://github.com/Thedougler/shattered-sea-wiki --skill session-ingest-thedougler
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-ingest
Source: https://github.com/Thedougler/shattered-sea-wiki/tree/main/.claude/skills/session-ingest
Command: npx skills add https://github.com/Thedougler/shattered-sea-wiki --skill session-ingest-thedougler

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Raw tabletop RPG session transcripts arrive as fragmented CSV files with unresolved speaker labels, mixed in-character and out-of-character chatter, and no structure — making it hard to turn hours of audio into usable campaign wiki content. ## Core Features & Use Cases - Speaker Resolution: Maps generic "Speaker N" and "Unknown" labels to known players using conversational context, process of elimination, and temporal clustering, then retrains voice profiles for future sessions. - Canon Extraction & Recap: Processes each transcript part incrementally, classifying lines as IC/OOC/META, merging fragmented utterances, and producing tagged extracts ([CANON], [LORE], [COMBAT], [ITEM], [SIGNAL], [NPC], [RULING]) with line-level citations. - Wiki Integration: Folds recaps and extracts into an Obsidian campaign wiki, updating session notes, entity pages, combat analytics, and the current world-state file. - Use Case: After recording a 4-hour D&D session, run the ingest to resolve who said what, produce a scene-by-scene recap with structured per-PC combat tables, and update the campaign wiki — all checkpointed so work survives context limits. ## Quick Start Ask the agent to process the session 12 transcript and it will resolve speakers, extract canon, and update the wiki.

Frequently Asked Questions about session-ingest

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

FAQPage Schema
How do I process a D&D session transcript into wiki notes?▼

Run the session-ingest pipeline on the raw transcript CSVs in .raw/sessions/. It resolves unknown speakers first, then extracts tagged canon per part, and finally integrates the recap and extracts into the Obsidian wiki as session notes and entity updates.

How to fix unknown speaker labels in transcription CSV files?▼

Pass 1 resolves Speaker N and Unknown labels using conversational context, process of elimination, speech patterns, and temporal clustering. Resolutions are recorded in speaker-map.md with confidence levels, and corrections can retrain voice profiles for future sessions.

Can transcript processing resume after an interruption?▼

Yes, the pipeline checkpoints after every part with progress.txt and a self-contained handoff.md. A new agent reads the handoff and continues from the next unprocessed part without redoing committed work.

What data gets extracted from session transcripts?▼

Extraction produces tagged blocks: CANON events, LORE world-building, COMBAT encounter tables with per-PC stats, ITEM inventory changes, RULING mechanical decisions, SIGNAL player engagement, and NPC appearance records, each citing part and line numbers.

Why are some transcript lines excluded from canon extraction?▼

Out-of-character banter, player speculation, filler utterances, and ambiguous speaker content are excluded to prevent false canon. Ambiguous items go to flags.md for DM review rather than being guessed.