clean-transcript

name	clean-transcript
description	Remove filler words, false starts, and immediate repetitions from an existing transcript file. Preserves meaning, tone, and structure. Use when the user asks to clean a transcript, remove fillers, or tidy up a raw transcription.

Clean transcript

Post-processing pass on an existing transcript to strip disfluencies.

Input

A transcript file, typically <stem>.raw.txt produced by transcribe-gemini-raw or transcribe-whisper-local.

What to remove

• Filler words: um, uh, er, ah, like (as filler), you know (as filler), I mean (as filler), sort of, kind of (as hedges only)
• Immediate repetitions: "I-I-I think", "the the"
• Obvious false starts: "I was going to— I wanted to say"
• Stutters and single-word restarts

What to preserve

• All content words and real intent
• Speaker's phrasing and vocabulary
• Paragraph breaks and any speaker labels
• Tone, register, and idiom
• Lists, enumerations, technical terms

What NOT to do

• Do not summarize
• Do not reorder sentences
• Do not add headers
• Do not paraphrase
• Do not correct grammar unless the raw transcript has a clear transcription error

Output convention

<source_stem>.cleaned.md in the same directory as the input transcript.

Implementation

This is an LLM task — read the input file, apply the rules above, write the cleaned version. No external tools needed.