HyperFrames Music to Video for Codex: Time Cuts to a Beat Grid
Plan cuts against a supplied local beat grid with the maintained HyperFrames music reference. Learn the migration path from the retired Music to Video workflow.
中文Setup for Codex (current HyperFrames replacement)
Codex, Node.js 22 or newer for the local HyperFrames CLI, and a disposable project. The separate music-to-video skill was retired upstream. This example uses its maintained /hyperframes workflow.
- If the HyperFrames plugin is available in Codex, enable it. For a standalone setup, run `npx skills add heygen-com/hyperframes` in a scratch project, select hyperframes for Codex, and start a fresh session.
- Ask the agent to load /hyperframes and read `skills/hyperframes/references/types/music.md` and `skills/media-use/references/mixing.md` from the installed bundle or the upstream v0.9.53 tree. Use `npx hyperframes@0.9.53` for the pinned CLI when running the example's checks.
- For historical reading, the original GitHub source below preserves the standalone music-to-video document from before the retirement.
Example task
Give Codex an 8-second synthetic click track or a beat grid at 120 BPM starting at 0. Set four local shapes to appear in consecutive 2-second scenes. Ask for the beat numbers of the three cuts when the beat at time 0 is numbered 1, then inspect the assembled timing.Expected result
The cuts occur at 2.0, 4.0 and 6.0 seconds, on beats 5, 9 and 13. Every scene has the same duration, and the cuts line up with the supplied 0.5-second beat spacing.
Upstream documentation
Original SKILL.md on GitHub · Apache-2.0 license · Source reviewed
Frequently asked question
Do I need a music service to test a HyperFrames beat-synced timeline?
No account is required for the local synthetic example. Give the agent a click track or an explicit beat grid so the timing can be checked independently.