clean

Convert VTT subtitle transcripts into clean plain text or markdown.

Updated May 18, 2022
One-click install
npx skills add https://github.com/kendreaditya/.config --skill clean-kendreaditya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean
Source: https://github.com/kendreaditya/.config/tree/main/claude/skills/clean
Command: npx skills add https://github.com/kendreaditya/.config --skill clean-kendreaditya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Clean noisy, machine-generated subtitle text into readable transcripts for easier consumption and sharing.

Core Features & Use Cases

  • Strips VTT headers, timestamps, cue IDs, and metadata.
  • Deduplicates repeated lines and stitches fragments into coherent sentences.
  • Outputs plain text or markdown with optional metadata for transcripts, summaries, or documentation.

Quick Start

Run vtt2txt input.vtt to convert a VTT file to plain text.

Frequently Asked Questions about clean

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

FAQPage Schema
How do I convert VTT subtitle files to plain text or markdown?

To convert VTT files to plain text or markdown, use the vtt2txt command to process single or batch inputs, stripping headers, timestamps, and cue IDs while deduplicating repeated lines into clean, readable text.

Why does my VTT transcript have repeated lines and broken sentences?

VTT transcripts have repeated lines and broken sentences because machine-generated subtitles often duplicate cues and split fragments across timestamps. Text-cleaning tools stitch these fragments into coherent sentences by deduplicating repeated lines.

Can I batch process multiple VTT files into clean transcripts?

Yes, you can batch process multiple VTT files into clean transcripts. The tool applies to batch VTT inputs, producing plain text or markdown outputs with optional metadata for each file in the processing queue.

Do I need to install Python dependencies to clean subtitle text?

No, you do not need to install Python dependencies to clean subtitle text. The tool is implemented in Python using the standard library, providing a robust, dependency-free environment for converting VTT files.

What is the best way to remove timestamps and metadata from VTT files?

The best way to remove timestamps and metadata from VTT files is to use a dedicated text-cleaning script that strips VTT headers, cue IDs, and metadata automatically, leaving only the readable transcript content.

Can I include metadata when converting VTT to markdown?

Yes, you can include optional metadata when converting VTT to markdown. The tool outputs plain text or markdown with optional metadata, making it suitable for generating transcripts, summaries, or documentation.