Transcript qa formatter
Skill ur-grue/autopunk-media-skills/skills/production-support/transcript-qa-formatter
Cleans a raw interview transcript into a polished Q&A — removing filler words, fixing speaker labels, standardising punctuation, and optionally inserting timestamps — ready to publish or hand to a copy editor.From its SKILL.md
npx -y skills add ur-grue/autopunk-media-skills --skill transcript-qa-formatterAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
6.8 KB, ~1.5k tokens by cl100k_base, as published. Nobody here has run it
Transcript Q&A Formatter
What This Skill Does
Cleans a raw interview transcript into a polished Q&A — removing filler words, fixing speaker labels, standardising punctuation, and optionally inserting timestamps — ready to publish or hand to a copy editor.
When To Use This Skill
- You have a raw transcript from a recording tool (Otter.ai, Rev, Descript, or manual) and need it publication-ready
- The transcript has inconsistent speaker labels ("Speaker 1", "UNKNOWN", mixed capitalisation)
- Filler words (um, uh, you know, like, sort of) are cluttering the text and need stripping without distorting meaning
- You are preparing a Q&A feature for a website, magazine, or press kit and need clean, readable format
- You need timestamps inserted at regular intervals or on each speaker turn for reference
What You Need To Provide
Required: The raw transcript text, pasted in full. Include speaker labels if they exist, even if inconsistent. Optional: Real names to replace placeholder labels (e.g. "Speaker 1 = Dr. Amara Nwosu"); preferred timestamp style (HH:MM:SS or MM:SS); whether you want light cleaning (filler words only) or full editing (also tighten run-on answers); the publication's house style for Q&A layout (e.g. bold Q, italic A, or labelled by name).
How the Assistant Approaches This
- Identify all speaker turns and map inconsistent labels to consistent names or roles (Q / A, or full names if provided). Flag any turns where the speaker is genuinely ambiguous rather than guessing.
- Strip filler words (um, uh, you know, like, sort of, I mean — when used as hesitation rather than meaning) without altering the speaker's actual phrasing, facts, or voice. Bracket any deletion that changes the sentence structure so the editor can review it.
- Fix punctuation, capitalisation, and sentence boundaries introduced by automated transcription errors. Do not rephrase or rewrite — only correct mechanical errors.
- If timestamps are requested, insert them at each speaker turn (or at the interval specified) in the requested format, aligned to the left margin.
- Apply the requested Q&A layout style. Default: Q: in bold, A: in plain text, one line break between turns, double line break between exchanges.
- Output the cleaned transcript followed by a short summary of changes made (filler words removed, labels corrected, ambiguous turns flagged).
Output Format
Full cleaned transcript in Q&A layout. Length mirrors the source — no content is cut beyond filler words. Tone follows the speaker's own register (formal interview stays formal; conversational stays conversational). A brief change log follows the transcript: number of filler words removed, any speaker labels corrected, any ambiguous turns flagged for editor review. No commentary or suggestions beyond what was asked.
Quality Criteria
- Every speaker turn is attributed correctly — no unlabelled or mislabelled lines
- Filler words are removed only where they are true hesitation markers, not where "like" or "you know" carries meaning
- No words, facts, or opinions are paraphrased, added, or removed beyond what is explicitly cleaned
- Punctuation and capitalisation follow standard editorial convention throughout
- Timestamps (if requested) appear at every speaker turn and use the format specified
- The change log accurately reflects what was modified
Example
Input
Speaker 1: So, um, the, uh, the main challenge we faced — and I think this is, you know, sort of the crux of it — was that the supply chain data just wasn't, like, granular enough for, um, regional analysis. We ended up, uh, building our own tracking system from scratch.
UNKNOWN: And how long did that take?
Speaker 1: About, um, fourteen months. Which is, you know, not ideal when you're working to a quarterly reporting cycle. But we felt it was the right call.
UNKNOWN: Were there other options you considered?
Speaker 1: Yeah, we looked at, uh, three off-the-shelf platforms. None of them had the, you know, the regional breakdown we needed. So, um, it was really a build-versus-buy decision and, I mean, build won.
Speaker names: Speaker 1 = Helena Varga (Head of Operations); UNKNOWN = Interviewer
Timestamp style: MM:SS at each speaker turn
Layout: Bold Q, plain A, labelled by role
Output
**Q [00:00]:** And how long did that take?
A [00:08] Helena Varga (Head of Operations): About fourteen months. Which is not ideal when you're working to a quarterly reporting cycle. But we felt it was the right call.
**Q [00:18]:** Were there other options you considered?
A [00:21] Helena Varga (Head of Operations): Yeah, we looked at three off-the-shelf platforms. None of them had the regional breakdown we needed. So it was really a build-versus-buy decision and build won.
Note: The opening speaker turn by Helena Varga appears before the first interviewer question in the source. It has been placed at the top as a standalone answer block for context:
A [00:00] Helena Varga (Head of Operations): The main challenge we faced — and I think this is the crux of it — was that the supply chain data wasn't granular enough for regional analysis. We ended up building our own tracking system from scratch.
Change log:
- Filler words removed: 11 (um ×4, uh ×3, you know ×3, like ×1)
- Speaker labels corrected: "Speaker 1" → Helena Varga (Head of Operations); "UNKNOWN" → Interviewer (displayed as Q)
- Ambiguous turns: none
- Structural note: opening answer turn placed before first question; no content altered
Known Limitations
- Automated transcripts with heavy crosstalk, strong accents, or poor audio quality often contain word-level errors that this skill cannot detect — it cleans formatting and filler, not mishearing. Always review against the original recording for factual accuracy before publishing.
- The skill does not judge whether a quote should be cut for editorial reasons — length decisions remain with the editor.
- If speaker labels are absent entirely and no names are provided, the skill will use Q / A for a two-person interview only; three or more unlabelled speakers will be returned with a flag requesting clarification.
- Ellipsis and em-dash usage to indicate pauses or interrupted speech is standardised to the default style; if your publication uses a different convention, specify it upfront.
Related Skills
What ships with it: 1 file
89 B alongside SKILL.md