short-form-video
Installation
SKILL.md
Short-Form Vertical Video (Hyperframes)
Short-form = 1080x1920 vertical, 10–30s, talking-head face + motion-graphic scene overlays + karaoke captions. Everything in this skill is distilled from the May Shorts 19 iteration autopsy (v1 → v4) and is preserved for maintenance of those examples. Use short-form-edit for new recordings.
Always invoke /hyperframes first. This skill sits on top of it — it does not replace the framework rules (data-* attributes, window.__timelines, composition structure). Those are non-negotiable regardless of the format.
When this skill fires
- Maintaining the existing May Shorts examples.
- Explicitly requesting their legacy four-layer scaffold.
The playbook (high-level)
- Audio is source of truth. Edit audio FIRST (cut retakes, pauses). Save as
<name>-edit.mp4. Measure exact duration withffprobe— this is the composition'sdata-duration. - Transcribe the edited audio with the root
scripts/transcribe-elevenlabs.mjshelper (ElevenLabs Scribe), a student-selected alternative normalized perdocs/TOOLS-AND-API-KEYS.md, or if retiming an existing build with ashift()function in captions, keep the existing captions and just shift scene starts. - Author scene boundaries in edited-time — NEVER mix original-time and edited-time anchors in the same file. See "Audio-sync protocol" below.
- Build the composition scaffold (4 layers: ambient-bg, seam-treatment, captions, face) — see "Composition scaffold" below.
- Author scenes with LOCAL offsets relative to each scene's
data-start. Each scene is its own sub-composition undercompositions/scene<N>-<label>.html. - Lint → draft render → word-exact frame verification → final render. This is the verification gate. Never skip step 3 (frame verification).