| name | transcript-processor |
| description | Clean up and structure a raw video transcript. Use when the user pastes or provides a messy YouTube/auto-caption transcript (with timestamps, rolling duplicate lines, VTT/SRT/json3 formatting, or broken mid-sentence wrapping) and wants it cleaned, de-duplicated, segmented into sentences or paragraphs, re-timestamped, or summarized. Trigger with phrases like "clean up this transcript", "fix these captions", "make this transcript readable", or "summarize this transcript". Runs offline with no network or extra packages. |
Transcript Processor
Turn a raw, messy transcript into clean readable text. Deterministic, stdlib-only,
no internet — safe for the Claude.ai code-execution sandbox on any egress setting.
What it fixes
- Rolling auto-caption duplication (each line repeating the tail of the previous).
- Broken mid-sentence line wrapping → rebuilt sentences.
- Non-speech annotations:
[music], (applause), ♪, [inaudible], etc.
- Mixed input formats: VTT, SRT, json3,
[HH:MM:SS] bracketed, plain text (auto-detected).
- Timestamps re-attached at sentence granularity.
How to run
python3 scripts/process_transcript.py INPUT [--mode MODE] [--summary N] [--out FILE]
cat transcript.txt | python3 scripts/process_transcript.py
Modes: clean (default), timestamped, sentences, paragraphs.
Workflow for Claude
- Write the user's raw transcript to
raw.txt.
- Run
process_transcript.py raw.txt --mode clean for clean paragraphs.
- Use
--mode timestamped if user wants timestamps.
- Summarize the cleaned output yourself — far better than
--summary heuristic.
Exit codes
0 success · 1 empty or unparseable input.
