subtitle-skilllisted
Install: claude install-skill zobaerio/zobvia
# subtitle-skill
This document is for an agent deciding whether and how to call
subtitle-skill. It is not a substitute for reading `README.md`
(architecture, data model, validation rules, security) or
`contract --json` (the machine-readable operation/format/error list) —
read both before integrating.
## When to use this skill
Use subtitle-skill when you already have subtitle **cues** — text with
start/end timestamps, decided by you or an upstream step — and need to:
- validate that timeline (catch overlaps, bad timestamps, unreadable
cues) before shipping it,
- turn it into an SRT or WebVTT file,
- burn it into a video,
- machine-translate it into another language with the same timecodes
(`translate`),
- mux several languages into one video as switchable subtitle tracks
(`mux`).
Do **not** use subtitle-skill to:
- transcribe audio (that's `transcription-skill`),
- decide how to split a long sentence into cues, whether to show a
speaker label, or word subtitle text — that judgement is yours; hand
subtitle-skill the finished `SubtitleCue`s, not a `TranscriptSegment`,
- summarize or rewrite subtitle text (`translate` hands each cue to the
chosen engine and reports what does not fit; it never shortens or
rewords a translation),
- decide *whether* a render "looks good" — subtitle-skill's render
verification is limited to what a machine can check (file exists, has
a video stream, duration preserved); it does not run or interpret
ffmpeg-skill's `look` (visu