What problem does it solve? Creating a video that is precisely synchronized to a music track normally requires manual beat-marking, timeline editing, and motion design work. This Skill automates that pipeline: it analyzes a music file once, cuts it into frames at real musical changes, plans per-frame visual treatments, and renders a final MP4 where every cut lands on the beat grid. ## Core Features & Use Cases - Deterministic beat analysis: A Python analyzer (librosa-based) produces a canonical audiomap.json with tempo, beat grid, drum classification, energy phases, rolls, silences, and key moments — no re-measuring by ear. - Structured multi-step workflow: Six gated steps (setup, analyze, skeleton, plan, build, assemble, render) with validation scripts and user approval checkpoints at the plan and render stages. - Template and motion-primitive catalogs: Per-frame groups are built from a local template catalog, free-composed motion primitives, or asset treatments (beat-cut, ken-burns, bg-under-text) for user-supplied images and videos. - Use Case: Give the Skill a high-energy music track and a mood brief; it generates the track analysis, plans a lyric video or kinetic promo, dispatches one sub-agent per frame to build HTML compositions, and renders a beat-synced MP4. ## Quick Start Use the music-to-video skill to turn my song file bgm.mp3 into a beat-synced kinetic promo video in landscape format.
