screen-recording-voiceoverlisted
Install: claude install-skill yyert123/miragea-skills
# Screen recording voiceover
The slow part of narrating a screen recording is not the voice, it is the sync: lining each sentence up
with the click it describes, and fixing the places where the sentence is longer than the action. This
skill does both automatically and never lets narration drift or overlap.
## When to use
- "Add a voiceover to this demo / tutorial / screen recording."
- "I recorded my screen silently, narrate it" or "I don't want to use my own voice / accent."
- "Make the narration match what happens on screen."
## Steps
1. Check `MIRAGEA_API_KEY` is set (never print it). Voice: ask once for 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=...` so it
is never asked again. Only clone a voice the user owns or has permission to use.
2. Find the steps and create a script template:
```bash
python3 scripts/scenes.py demo.mp4 # -> demo.frames/*.jpg, demo.frames/steps.json, demo.script.txt
```
3. **Look at the frames** in `demo.frames/` (you can read images) and write one clear sentence per step
into `demo.script.txt` after each timestamp, replacing the `# step` comment. Stay within the
`~N words` hint so the line fits before the next step. Merge, move or delete steps freely. If the user
gave their own script, put its sentences at the matching timestamps instead.
4. Check the timing without spending anything:
```bash
python3 scripts/voiceover.py demo.