SuperAPI AI Directory

motion-video

Design & creation

View repository

Updated 10-16 08:29

About this skill

Motion video

Make a 1920×1080 30 fps motion-graphic video where the scene cuts land on the music's beats, reveals land on spoken words, and the audio is broadcast-clean. The workflow is fully scripted: facts → script → multix audio → forced alignment → beat grid → bar-spliced music → timeline + mix → HTML composition → lint/check/snapshot → render → remux → social encode.

Two finished editions show what each style should feel like. Their working projects are deliberately not bundled here: the generated voice-over, music and SFX are large and provider-licensed. Study the published demo, then build every new video from assets/templates/index-skeleton.html plus the style reference.

Style Style reference Public demo Feel
Comic multiverse references/style-comic-spiderverse.md Dewee v3.34 comic edition, the 151 s social encode loud, playful, hand-made
Glass keynote references/style-glass-keynote.md the 144 s edition of the same release premium, calm, clear

Scope

This skill handles:

  • New videos in either style, restyles of an existing video as a separate project, and partial reworks (new music, re-timed drops, re-mix, re-render, social encode).
  • Audio through the multix CLI: Gemini TTS voice, ElevenLabs SFX, ElevenLabs Music composition plans, ElevenLabs forced alignment.

This skill does NOT handle:

  • Generative text-to-video footage (use multix Seedance/Veo directly).
  • React/Remotion compositions or generic HyperFrames questions (use the hyperframes or remotion skills).
  • Publishing to social accounts: produce the file and let the user post it.

How to work

  1. Pin the outcome before touching files: topic and sources, style (one of the two, or a new one derived from them), duration, voice language (English VO + Vietnamese captions by default), ending, signature. Ask only if the style or the facts source is unknown.
  2. Create assets/videos/<slug>/ (never overwrite a finished edition) and a plan under plans/ following the repo convention. Copy the templates from assets/templates/ of this skill: scripts/*.mjs, data/*.example.json (rename to .json), hyperframes.json, index-skeleton.html as index.html, plus scripts/fit-beat-grid.py.
  3. Follow references/production-pipeline.md step by step. Each step writes a file the next one reads, so do not reorder them.
  4. Get the music right with references/audio-and-beat-sync.md: fit the grid, splice bars so the drops land where the script needs them, verify the splice, and measure the voice/music balance.
  5. Build index.html with references/composition-contract.md and the chosen style reference, starting from assets/templates/index-skeleton.html. When a scene type repeats (stats, diagrams, charts, terminal, graph, outro), follow the demo's choreography for that scene instead of inventing a new one.
  6. Finish only when every check in "Done when" passes; report measured numbers, not impressions.

Keep credentials inside multix's own config. Never print API keys or copy them into project files, plans or reports.

Done when

  • hyperframes lint and check pass; snapshots of every scene were reviewed.
  • verify-arrangement.py reports every segment within ±2 ms and measure-mix-balance.py shows the music ~4–6 dB under speech.
  • ffprobe: 1920×1080, 30 fps, expected duration, AAC 48 kHz stereo; ebur128 ≈ −14 LUFS with peak ≤ −1 dBFS; blackdetect finds nothing outside fades.
  • build-timeline printed no clip/overlap/missing-word warnings.
  • On-screen facts trace to the sources collected in step 1.

Resources

  • references/production-pipeline.md: every command from scaffold to social encode and studio preview, plus the rebuild table.
  • references/audio-and-beat-sync.md: voice, SFX cues, music plans, bar-splice arrangement, anchors, mix numbers and the ducking pitfall.
  • references/composition-contract.md: TIMING shape, helpers, determinism, scene windows, captions, mascot, renderer limits, signature.
  • references/style-glass-keynote.md / references/style-comic-spiderverse.md: tokens, fonts, layers, components, transitions and caption look per style.
  • scripts/fit-beat-grid.py <music> [--min-bpm N --max-bpm N]: BPM, BEAT0 and a per-bar kick/energy table.
  • scripts/verify-arrangement.py <project> [--tolerance-ms 2]: splice lag per segment; exits 1 on drift.
  • scripts/measure-mix-balance.py <project>: music under speech vs in gaps, from build-timeline.mjs --stems.
  • scripts/tests/: python -m unittest discover -s scripts/tests (needs ffmpeg, numpy, scipy).
  • assets/templates/: project scripts (generate-audio-assets, align-voiceover, arrange-music, build-timeline), example data files and the composition skeleton.