fix-srt

Correct and optimize SRT/VTT subtitle files with timestamp validation and typo mapping.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/ricoisme/vscode-agents --skill fix-srt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-srt
Source: https://github.com/ricoisme/vscode-agents/tree/main/skills/fix-srt
Command: npx skills add https://github.com/ricoisme/vscode-agents --skill fix-srt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automatically corrects errors in SRT/VTT subtitle files, ensuring accurate timestamps, fixing numbering, and improving grammar and punctuation for better readability.

Core Features & Use Cases

  • Timestamp Validation: Fixes illogical start/end times and ensures correct formatting.
  • Automated Correction: Applies a dictionary of common typos and technical terms.
  • Semantic Optimization: Improves sentence flow, removes redundancy, and standardizes punctuation.
  • Use Case: Upload a raw ASR-generated SRT file for a technical tutorial, and receive a clean, professional version ready for video editing.

Quick Start

Use the fix-srt skill to correct the provided subtitle file 'my_lecture.srt'.

Frequently Asked Questions about fix-srt

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

FAQPage Schema
How do I fix errors in an SRT subtitle file generated by ASR?

To fix errors in an SRT subtitle file, the skill validates timestamps, corrects sequence numbering, and applies a JSON typo map to resolve common ASR transcription mistakes for improved readability.

How do I correct overlapping timestamps and broken numbering in VTT subtitles?

Correcting overlapping timestamps and broken numbering in VTT subtitles involves validating illogical start and end times while automatically resequencing entries to ensure correct formatting and semantic coherence.

Can I use a custom typo map to correct technical jargon in SRT files?

Yes, you can use a custom JSON typo map to correct technical jargon in SRT files. The skill applies this dictionary to automatically replace common transcription errors and specialized terms.

Do I need Python to run automated subtitle correction and grammar optimization?

Yes, you need Python installed to run the automated scripts for subtitle correction. The script execution handles grammar optimization, punctuation refinement, and timestamp validation.

What is the best way to optimize subtitle grammar and punctuation for video editing?

The best way to optimize subtitle grammar and punctuation for video editing is to apply semantic optimization that improves sentence flow, removes redundancy, and standardizes punctuation across the SRT or VTT file.

Why does my ASR transcription lack semantic coherence and how can I improve it?

ASR transcriptions often lack semantic coherence due to fragmented speech recognition. You can improve it by refining grammar, removing redundancy, and ensuring logical sentence flow using automated correction scripts.