video-subtitle

Create, validate, translate, and burn SRT, VTT, and ASS subtitles for video and audio.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/JustinChangTW/ai-skills-core --skill video-subtitle-justinchangtw
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: video-subtitle
Source: https://github.com/JustinChangTW/ai-skills-core/tree/main/skills/10-video-media/video-subtitle
Command: npx skills add https://github.com/JustinChangTW/ai-skills-core --skill video-subtitle-justinchangtw

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Producing accurate, well-timed subtitles for video or audio requires transcription, timestamp alignment, format validation, and rendering—steps that are error-prone when done manually. This Skill manages the full subtitle pipeline with local-first handling and explicit timing verification. ## Core Features & Use Cases - Transcription and Subtitle Generation: Convert speech to timestamped Traditional Chinese subtitles using local Whisper-compatible engines or supplied transcripts, with glossary support for names and technical terms. - Validation and Conversion: Generate SRT from structured cue JSON and check sequence numbers, timestamps, overlaps, and empty captions before rendering. - Styling, Translation, and Burning: Apply bilingual layouts, ASS styling, and burn subtitles into H.264/AAC MP4 or attach soft subtitle tracks. - Use Case: You have a phone-recorded tutorial video and need Traditional Chinese captions. The Skill transcribes the audio, splits captions at phrase boundaries, validates the SRT, previews the font rendering, and delivers both the editable SRT and a burned MP4. ## Quick Start Use the video-subtitle skill to transcribe my video and produce validated Traditional Chinese SRT subtitles plus a burned-in MP4 version.

Frequently Asked Questions about video-subtitle

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

FAQPage Schema
How do I create Traditional Chinese subtitles for a video?▼

Provide the video file and the Skill inspects it with ffprobe, transcribes speech using a local Whisper-compatible engine, splits captions at phrase boundaries, and outputs a validated SRT file. You can then request a burned-in MP4 or soft subtitle track.

How to convert JSON subtitle cues to SRT format?▼

Use the srt_from_json.py script with a JSON array of cues containing start, end, and text fields. It validates timing order, rejects overlaps and empty text, and writes a properly formatted SRT file with HH:MM:SS,mmm timestamps.

What is the difference between SRT, VTT, and ASS subtitle formats?▼

SRT offers broad compatibility and easy correction, VTT supports web players and cue settings, and ASS enables advanced positioning, outlines, animation, and per-word styling. Choose based on your playback platform and styling needs.

Can I use an external transcription API for sensitive videos?▼

External transcription APIs are used only with explicit authorization. For sensitive media, the Skill prefers a local Whisper-compatible engine, and if no engine is available it asks for transcript text or user-approved timing cues.

Why does my SRT file fail validation?▼

Common failures include incorrect sequence numbers, malformed timestamp syntax, end times before start times, overlapping cues, and empty caption text. Run validate_srt.py to list each error with its cue number before rendering.

Should I burn subtitles into the video or use soft subtitles?▼

Burned subtitles guarantee consistent appearance but are not editable or selectable, while soft subtitles remain selectable but depend on player rendering. The Skill burns into H.264/AAC MP4 only after the editable subtitle file has been checked.