Extract the primary MKV subtitle to SRT, correct WhisperX errors, and re-mux it.
npx skills add https://github.com/five82/spindle --skill subtitleaudit
Please help me install this Agent Skill. Skill: subtitleaudit Source: https://github.com/five82/spindle/tree/main/.agents/skills/subtitleaudit Command: npx skills add https://github.com/five82/spindle --skill subtitleaudit
This Skill helps editors and media librarians quickly identify and fix WhisperX transcription errors that appear in the primary embedded subtitle track of MKV films or episodes. It ensures that the display subtitles viewers see are coherent and accurate by avoiding edits to non-primary tracks or external references.
Run the /subtitleaudit command against a sample MKV to review and correct its primary display subtitle.
High-intent search queries and answers about installing and using this skill.
To audit WhisperX subtitles in MKVs, this process identifies the primary subtitle stream, extracts it to a temporary SRT, applies conservative title-specific corrections, and re-muxes it back into the MKV while preserving all other tracks.
Correcting a primary subtitle track safely involves extracting the display subtitle to SRT, applying text fixes, and reconstructing the MKV. This preserves all audio, video, and non-primary subtitle tracks along with their original default and forced dispositions.
No, subtitle auditing does not modify cached WhisperX artifacts. It operates conservatively by only adjusting the extracted display subtitle text and leaving the original transcription cache and non-primary subtitle streams completely untouched.
Yes, local tools including ffprobe, ffmpeg, and mkvmerge are used to identify streams, extract the primary subtitle to SRT, and remux the corrected text back into the MKV without performing any external network fetches.
You should run a subtitle audit as a title-specific cleanup step after your generic WhisperX subtitle pipeline has finished, or use it as part of batch quality control for media library curation to ensure coherent display subtitles.
The audit focuses exclusively on the primary non-forced display subtitle track to ensure viewer-facing text is accurate. It intentionally avoids altering non-primary tracks, external references, or cached transcription data to maintain library integrity.
tpottEmbed SRT subtitles into WEBM, MP4, or MKV videos using ffmpeg.
archibateAudit the last text response for contradictions, factual errors, and format drift.
damionrashfordMerge, split, extract tracks, and edit MKV metadata without re-encoding.
0x0xfanTranscribe audio, correct subtitles, and burn them into videos with FFmpeg.
