# music-to-video

> Claude/Codex skill by [@heygen-com](https://omgskills.com/library/heygen-com/index.md) · 53k stars · 315k installs · Updated 2026-09-26

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Tags: ai, animation, ffmpeg, framework, gsap, html, mcp, puppeteer, rendering, typescript, video

## Install

```sh
git clone https://github.com/heygen-com/hyperframes /tmp/hyperframes && ln -s /tmp/hyperframes/skills/music-to-video ~/.claude/skills/music-to-video
```

## From README

music-to-video — one music-grounded, beat-synced video workflow Use this skill to turn a music track into a beat-synced HyperFrames video. You analyze the track once, lay out the frames, fill in a per-frame plan, and build each frame as a composition. The input is a music track plus optional user images or videos — there is no narration and no website capture. Typography and templates are the floor (a complete video needs zero assets); any media the user supplies is cut in on the same beat grid. You are the orchestrator. Work in videos/ /. Run the steps in order and pass each Gate before moving on. Two steps need the user: Step 3 (plan approval) and Step 6 (render approval) — both are checkpoint gates per ../hyperframes/references/brief-contract.md (read it before Step 0): in autonomous mode, post the summary as a heads-up and proceed instead of waiting. Do every step yourself except Step 4, where you dispatch one sub-agent per frame.

## Links

- HTML page: https://omgskills.com/skills/heygen-com/hyperframes/music-to-video/
- GitHub: https://github.com/heygen-com/hyperframes
- Author: [@heygen-com](https://omgskills.com/library/heygen-com/index.md)

## More from this repo

- [product-launch-video](https://omgskills.com/skills/heygen-com/hyperframes/product-launch-video/index.md) — Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature...
   - [@heygen-com](https://omgskills.com/library/heygen-com/index.md) · 59k stars
- [canopy-part-title](https://omgskills.com/skills/heygen-com/hyperframes/canopy-part-title/index.md) — Leaves sweep through the frame and part to reveal the headline.
   - [@heygen-com](https://omgskills.com/library/heygen-com/index.md) · 53k stars
- [captions-overlay](https://omgskills.com/skills/heygen-com/hyperframes/captions-overlay/index.md) — Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that...
   - [@heygen-com](https://omgskills.com/library/heygen-com/index.md) · 53k stars