shorts-voiceoverlisted
Install: claude install-skill yyert123/miragea-skills
# Shorts voiceover
Script in, upload-ready Short out. Unlike tools that guess caption timing from text length, this skill
transcribes the finished voice track, so every caption pops exactly when the word is spoken.
## When to use
- "Turn this script / these tips / this post into a Short (or Reel, or TikTok)."
- "Make a faceless short with voiceover and captions." "Use my voice."
- "Make 5 shorts from these scripts" -> run once per script file.
## Steps
1. Check `MIRAGEA_API_KEY` is set (never print it). Voice: the user's Miragea voice id, or a public URL of
a clip of their voice plus its exact words. Suggest `export MIRAGEA_VOICE_ID=...`. Only clone a voice
the user owns or may use.
2. Write the script: one short paragraph per scene, blank line between scenes, 120-170 words total for a
45-60 s Short. Open with a hook in scene 1. Optional `@file` at the start of a scene picks its
background:
```text
Three quick tips to make any voiceover sound professional.
@broll/desk.mp4
First, record in a small room with soft furniture. Echo is harder to fix than noise.
```
3. Render:
```bash
python3 scripts/short.py tips.txt --voice VOICE_ID # gradient backgrounds
python3 scripts/short.py tips.txt --media ./broll --music bed.mp3 # user's images/clips + music
```
4. Give the user `video` and `srt` from the printed JSON. Offer edits: change a scene's text and re-run;
only that scene is re-voiced and the rest com