video-captionslisted
Install: claude install-skill yyert123/miragea-skills
# Video captions
One command turns a video (or audio) file into subtitles that are pleasant to read, and optionally into a
captioned MP4. Raw speech-recognition segments often break mid-word ("cen" / "ts") and run too long; this
skill rebuilds whole words and re-flows them into proper cues.
## When to use
- "Add captions / subtitles to this video", "make an SRT for my talk", "burn subtitles in".
- "Make TikTok/Reels/Shorts style captions" -> use `--style shorts --burn`.
- The user needs a `.vtt` for a website `<track>` or YouTube upload.
## Steps
1. Check `MIRAGEA_API_KEY` is set (never print it). If missing, tell the user to create a key at
https://miragea.ai and `export MIRAGEA_API_KEY=...`.
2. Run the script on the user's file:
```bash
python3 scripts/captions.py path/to/video.mp4 # -> video.srt + video.vtt
python3 scripts/captions.py path/to/video.mp4 --burn # + video.captioned.mp4
python3 scripts/captions.py path/to/short.mp4 --style shorts --burn # pop captions, centred
```
3. Read the JSON it prints (`srt`, `vtt`, `video`, `cues`) and give the user the paths.
4. If the user wants wording fixed, edit the `.srt` text (keep timestamps) and re-run with `--burn`:
the transcript is cached in `<file>.transcript.json`, so re-runs cost nothing.
## Options
| Flag | Default | What it does |
|---|---|---|
| `--style standard` | yes | 2 lines x 42 chars, 1-7 s per cue (broadcast conventions) |
| `--style shorts` | | 1-3 words