video-to-shortslisted
Install: claude install-skill yyert123/miragea-skills
# Video to Shorts (AI clip maker)
Long video in, a folder of ready-to-post vertical clips out. You (the agent) are the "virality
model": read the timestamped sentences and choose moments a viewer would understand with no
context. The script does the precise work: sentence-safe cuts, 9:16 framing, captions, loudness,
and an optional voiced hook in the creator's own voice.
## When to use
- "Make 5 Shorts from this podcast episode."
- "Clip the best moments of my webinar / stream VOD for TikTok and Reels."
- "Find the viral parts of this interview and caption them."
## Steps
1. Check `MIRAGEA_API_KEY` is set (never print it). Check `ffmpeg -version`.
2. Transcribe and list moments (billed once, then cached in `<video>.transcript.json`, shared with
the video-captions skill):
`python scripts/clips.py moments talk.mp4 --suggest 5`
This writes `talk.moments.md` (one sentence per line, `[start-end]` seconds) and a keyword-scored
draft `talk.clips.json`.
3. Read `talk.moments.md` and write the final `talk.clips.json` yourself. Good clips:
- 20-60 s, start on a claim, question or number, never on "and / so / but";
- one complete idea with its payoff; no inside references ("like I said earlier");
- a `title` (under 60 chars, for the upload) and, if the opening is slow, a `hook`: 5-9 words,
under ~3 s spoken, that states the payoff ("This one rule doubled our retention.").
`[{"start": 12.3, "end": 48.0, "title": "...", "hook": "..."}]`
4. Preview for free: