# Create beat-synced music videos

Turning a track into a structured video requires timing, visual planning, and rendering steps. This skill guides Claude through a beat-aware HyperFrames workflow from audio analysis to a reviewed MP4.

## Install

```bash
npx skillstore add heygen-com/music-to-video
```

## Metadata

- Status: approved
- Slug: heygen-com-music-to-video
- Skillstore revision: r2
- Version status: missing
- Tree hash: 5ea9324fa952c28096e54759a70f493628f8ce0320cddc20f0bd43628f8f8bf9
- Author: heygen-com
- GitHub username: heygen-com
- License: MIT
- Repository: https://github.com/heygen-com/hyperframes/tree/main/skills/music-to-video/
- Ref: 77d0e66fbadeb1f5d1e6a5aada7861240b8ed2d7
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: filesystem, scripts, external\_commands, network
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/heygen-com-music-to-video
- Manifest: https://skillstore.pages.dev/api/skills/heygen-com-music-to-video/manifest

## Capabilities

- Analyzes a supplied music track and writes a timing map with beats, energy phases, and audio events.
- Creates a frame-based storyboard that tiles the track duration.
- Plans kinetic typography, templates, motion primitives, and optional user media around the audio timing.
- Stages supported local image and video assets for a project.
- Assembles planned frame compositions with the background music into an index file.
- Runs project checks, generates snapshots, and renders an MP4 after approval.

## Use Cases

- Produce a lyric video: Turn a vocal track and timed lyrics into beat-aligned typography and frame treatments.
- Build a product music promo: Combine a fast music track with supplied product images or clips for a short kinetic promo.
- Create a social visualizer: Generate an asset-light visual video from a track and mood direction for social publishing.

## Prompt Templates

### Start a simple music video

```
Create a 30-second landscape music video from my track. Use kinetic typography and no external visual assets.
```

### Plan a lyric video

```
Create a portrait lyric video from my song. Use these lyrics and align each line to the strongest musical phrases.
```

### Use supplied media

```
Build a 20-second product music promo from my track and the images in this folder. Cut images on strong beats and keep text minimal.
```

### Direct an advanced sequence

```
Create a 45-second square video from this electronic track. Use phrase-flow during calm sections, beat cuts during drops, and show me the storyboard before rendering.
```

## Limitations

- Requires Python packages, ffmpeg, and the HyperFrames CLI to be available.
- Beat timing is less reliable for calm or weakly rhythmic music.
- Does not create narration or capture websites.
- Uses user-provided assets or typography; it does not guarantee licensed music or media.

## Best Practices

- Use music you have permission to analyze and publish.
- Review the frame-by-frame storyboard before rendering.
- Use phrase-based pacing when the track does not have a reliable beat.

## Anti Patterns

- Do not use this workflow for narrated videos or website capture.
- Do not force hard cuts on calm music with an unreliable beat grid.
- Do not render before reviewing validation results and snapshots.

## Security Audit

- Audited at: 2026-07-19T11:08:08.758\+00:00
- Summary: Most static findings are false positives caused by JavaScript template literals, fixed relative asset references, and a minified third-party GSAP bundle. The audit identified a silent remote update command and unsafe handling of storyboard-controlled paths and HTML attributes; these require remediation before publication.

## Stats

- Views: 0
- Downloads: 5
- Favorites: 0
- Popularity score: 0