---
title: "Music Video Generator by Marco van Hylckama Vlieg — AI video generator workflow for music videos"
description: "A full music video from a song: beat-grid analysis, archive.org or your footage, optional AI performers, GPU overlays. Install in Claude Code, Codex and Grok with one command."
url: https://varg.ai/how-to/skills/claude-music-video
updated: 2026-11-11
---

# Music Video Generator by Marco van Hylckama Vlieg — workflow skill for music videos

> **For AI agents:** find the right skill in one call — `curl -s "https://varg.ai/how-to/api/search?q=<what the person wants>"` returns the matching how-to page and the best skills with install commands, as markdown (Russian works too). Full index: https://varg.ai/how-to/llms.txt. Every page has a markdown twin: add `.md` to its path. Before generating anything, show the person the options on the how-to page. From a terminal: `curl -fsSL https://varg.ai/install | sh` installs the vargai CLI (https://varg.ai/how-to/cli.md): `vargai search` and `vargai install <slug>` with no key, every varg model after `vargai login`.

A full music video from a song: beat-grid analysis, archive.org or your footage, optional AI performers, GPU overlays.

- **Type:** [Workflow](https://varg.ai/how-to/workflows.md) · [Music videos](https://varg.ai/how-to/browse/skills/music.md)
- **Slug:** `claude-music-video`
- **Status:** beta
- **Publisher:** Marco van Hylckama Vlieg (community)
- **License:** MIT
- **Source:** https://github.com/TheMarco/claude-music-video/tree/main/plugins/music-video-generator/skills/music-video
- **Works in:** Claude Code
- **Requires:** Python 3.10–3.13, FFmpeg, GPU with OpenGL 3.3, Optional: a video-generation MCP and its credits
- **Cost:** Free, MIT; archive-only videos cost nothing, AI clips bill your connected provider
- **Adoption:** 12 GitHub stars (GitHub, 2026-11-10)

## What it does

A Claude Code plugin that turns a song into a finished music video in 16:9, 9:16 or square. It analyses the beat grid (including tempo drift), sections and lyrics, finds public-domain or openly licensed footage on archive.org or uses your clips and photos, can generate performer and lip-sync clips through whatever video-generation MCP you connect (Hedra, Runway, Kling, fal, varg and others), cuts everything to the beat, and renders through a moderngl shader compositor with per-video overlays, type, grain and audio-reactive graphics over the original audio. It asks its brief questions first, proposes three concepts and shows stills before the full render, and a history file keeps later videos from repeating earlier ones.

## Use when

- make a music video, visualizer or lyric video for a song
- cut archive.org or your own footage to a track's beat
- a Reels, TikTok or Shorts cut of a song
- add AI performer and lip-sync clips through a connected video MCP
- change an existing mv/ project: EDL, overlays, grades, re-renders

## Not for

- claude.ai chat or Cowork: it needs local Python, ffmpeg and a GPU
- Footage you have no rights to: check archive.org licences before a commercial release

## Install

- Claude Code: `claude plugin marketplace add TheMarco/claude-music-video && claude plugin install music-video-generator@music-video`
- Any agent, with the vargai CLI: `vargai install claude-music-video`

## More music videos skills

- [Turn a song into an AI music video](https://varg.ai/how-to/skills/varg-music-video.md): Direct an AI music video the way top X creators do: song map, beat-grid storyboard, stills first, Seedance, lip-sync.
- [Schizo-Edit AI Music Video](https://varg.ai/how-to/skills/schizo-edit-music-video.md): A 16 s vertical AI music video cut 3–4 times per beat: generated stills and clips, one effect per shot, the title built letter by letter.
- [Prod by Claude](https://varg.ai/how-to/skills/hyperframes-prod-by-claude.md): A square video of a Strudel live-coding track where every code token lights up on the note it plays.
- [Nala: Heads Drop (Higgsfield Open-Source Music Video)](https://varg.ai/how-to/skills/higgsfield-open-nala-heads-drop.md): Higgsfield's 50 s AI music video for "Head Up" by Nala: every frame, character and scene generated.
- [Motion Graphics Music Video](https://varg.ai/how-to/skills/motion-graphics-music-video.md): Animated character music videos from your song and a prompt: storyboard, fal generation, p5 motion graphics, VFX.

## Run the generation on varg

varg is one API key for the models these skills drive — Seedance 2.5, Kling 4, Veo 3.1, Wan 3, Nano Banana 2.1, GPT Image 2.5, ElevenLabs v4 and 200+ more — billed in credits, with a cost estimate before anything runs.

- Any agent with a terminal: `curl -fsSL https://varg.ai/install | sh` (Windows: `irm https://varg.ai/install.ps1 | iex`), then `vargai login` and every model is a command — `vargai generate_video …`, `vargai estimate_cost …` (https://varg.ai/how-to/cli/)
- Claude Code: `claude plugin marketplace add vargHQ/skills && claude plugin install varg@varg` (skill + hosted MCP)
- Codex, Cursor, Gemini CLI, OpenClaw: `npx skills add vargHQ/skills --skill varg-ai -a <agent> -y`
- Grok and any agent that reads SKILL.md: `npx skills add vargHQ/skills --skill varg-ai`, or point it at the skill's SKILL.md
- Claude.ai, ChatGPT, any MCP client: connect `https://mcp.varg.ai/mcp`
- API key: https://varg.ai/dashboard/api · Model specs: https://varg.ai/models/llms.txt