auto-brolllisted
Install: claude install-skill yyert123/miragea-skills
# Auto B-roll (cut on the word)
A video (or a script) in, the same video with B-roll cut in on the words that call for it. You (the
agent) are the editor: you read each line with its word timings and decide what to show. The script
does the frame-accurate work: word anchoring, cover-cropping, timing rules, mixing, export.
## When to use
- "Add B-roll to my talking-head video / podcast clip / course lesson."
- "Find cutaways for this script and drop them on the right words."
- "Make a faceless video from this script with my voice and B-roll."
- "Give me an EDL of the B-roll so I can finish in Premiere / Resolve."
## Steps
1. Check `MIRAGEA_API_KEY` is set (never print it) and `ffmpeg -version` works.
2. Prepare the plan:
- Talking head / podcast / screen recording: `python scripts/broll.py prep talk.mp4 --library broll/`
- Faceless (no footage of a speaker): `python scripts/broll.py prep --script script.txt --library broll/ --vertical`
voices the script in the creator's Miragea voice (`MIRAGEA_VOICE_ID`, or `MIRAGEA_REF_URL` +
`MIRAGEA_REF_TEXT`; only a voice they own or may use) and writes `script.narration.wav`.
Either way it writes `<name>.broll.json`: sentence `lines` with per-word start times, and the
`library` of the user's clips (with lengths). The transcript is cached and shared with the
video-captions, video-to-shorts and video-dubbing skills, so it is billed once.
3. Plan the cutaways: add one object per shot to `"cutaways"`:
`{"line":