music-to-video — Claude Code skill: what it does, install
music-to-video turns a music track into a beat-synced HyperFrames video. Use it for lyric-style clips, slideshows, or kinetic promo visuals with optional media.
AGPL-3.0 ★ 78,316 updated 2026-10-24
npx skills add calesthio/OpenMontage --skill music-to-video -a claude-codeWhat music-to-video does
This skill uses an audio file, or extracts audio from a supplied video, as the basis for the edit. It creates one timing map, lays out the frames, and sends each frame to a separate sub-agent for composition. Text and templates provide the baseline, so the project can start without image or video assets.
The workflow moves through hyperframes.json, STORYBOARD.md, HTML files under compositions/frames/, and the final renders/video.mp4. Music analysis requires Python 3 with librosa, numpy, and soundfile; without those packages, the analyzer will fail. The user approves the plan and the render at separate gates. Supplied images or videos can be placed on the same beat grid.
What it helps with
- turn a music track into a video
- sync frame changes to musical timing
- map sections around energy shifts and silences
- cut supplied media into planned frames
Example prompts for the agent
- Turn
assets/bgm.mp3into a beat-synced HyperFrames video with typography. - Analyze this track and draft
STORYBOARD.mdfor a calm visual sequence. - Use my supplied images in the frames according to the track’s timing map.
How to install music-to-video
1Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill music-to-video -a claude-code2Manually: put the files in place
~/.claude/skills/music-to-video/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/music-to-video/
1Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill music-to-video -a codex2Manually: put the files in place
.agents/skills/music-to-video/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill music-to-video -a cursor2Manually: put the files in place
.cursor/skills/music-to-video/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install calesthio/OpenMontage .agents/skills/music-to-video2Manually: put the files in place
.github/skills/music-to-video/SKILL.md1Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill music-to-video -a gemini-cli2Platform CLI
gemini skills install https://github.com/calesthio/OpenMontage --path .agents/skills/music-to-videoManually: put the files in place
.devin/skills/music-to-video/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about music-to-video
How do I install music-to-video in Claude Code?
Run npx skills add calesthio/OpenMontage --skill music-to-video -a claude-code, then open ~/.claude/skills/music-to-video/SKILL.md.
What does music-to-video do?
It analyzes a track, plans the frame structure, and assigns each frame to a sub-agent that builds the HyperFrames composition. Optional images and videos follow the same timing map.
What is required for music analysis?
The analyzer needs Python 3 plus librosa, numpy, and soundfile. The skill supports Claude Code and Codex.