session-highlights

Extracts funniest in-world moments from TTRPG session audio into screenplay scene files with embedded clips.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning hours of recorded tabletop RPG sessions into shareable, illustrated highlight moments requires manually finding the funniest bits, fixing speaker attribution, cutting audio, and writing up scenes — a slow, error-prone process this Skill automates end to end. ## Core Features & Use Cases - Laughter detection and filtering: Runs the shattered-audio laughs CLI to rank laugh bursts, then filters out out-of-character table talk to keep only drawable in-world moments. - Screenplay scene generation: Produces seven self-contained screenplay scene files with wiki-sourced setting and character appearance, faithful in-character dialogue, and embedded audio clips, plus a thin wikilinked index note. - Audio slicing and vault integration: Cuts standalone m4a clips with ffmpeg into Obsidian vault assets and resolves every name to canonical wikilinks, then lints all eight pages. - Use Case: After a recorded D&D session is transcribed and ingested, ask for the highlight reel and receive seven illustrated-ready scene pages with playable audio clips of the biggest table laughs. ## Quick Start Find the funniest moments of session 04 and turn them into screenplay highlight scenes with audio clips.

Frequently Asked Questions about session-highlights

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

FAQPage Schema
How do I extract the funniest moments from a recorded D&D session?▼

Run the shattered-audio laughs command on the session audio parts to rank laugh bursts, then filter for in-world moments, refine scene boundaries against the transcript, and write one screenplay scene file per highlight with an embedded audio clip.

How do I cut an audio clip from a specific timestamp with ffmpeg?▼

Use ffmpeg with -ss for the start time in seconds and -t for duration, slicing from the source part file into a standalone m4a clip. The clip should span from the scene setup through the laugh_end boundary so it matches the written scene.

What prerequisites are needed before generating session highlights?▼

You need per-part transcript CSVs with Start/End timestamps and a resolved speaker map from session ingest. Without timestamps you cannot align dialogue to laughs, and without the speaker map attribution will be wrong.

Why are some loud laugh moments discarded from the highlight reel?▼

Moments with no in-world scene are discarded — real-life stories, pop-culture tangents, rules arguments, and table logistics cannot be illustrated as campaign scenes. The pipeline keeps only moments where a character does something in the fiction.

Can highlight scenes be generated without a speaker map?▼

No. The speaker map from session ingest resolves raw labels like Speaker 1 to real character names, and mic drift makes unmapped attribution unreliable. Run session-ingest first if speakers are unresolved.