recoup-music-video — Claude Code skill: what it does, install
Builds a narrative music video from an approved track through a reviewed edit. Use it when a song needs a structured film workflow.
npx skills add recoupable/skills --skill recoup-music-video -a claude-codeWhat recoup-music-video does
This skill lays out a production path from the approved recording to the finished edit. It covers the project bible, scene checks, character audition, props, location plates, shot planning, reviewed stills, motion, and edit verification. When resumed, it starts at the first unfinished stage and keeps approval states for existing assets.
The workflow uses BIBLE.md, audio/, audio/scribe.json, a shot table, and HyperFrames composition and verification material. Timing work depends on an ElevenLabs Scribe transcript with word timestamps. Whisper is excluded from this workflow. If Scribe cannot be accessed, an approved matching transcript is required before timing-dependent production can continue.
The skill is available for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It reuses approved audio and ends with the asset unless publishing is requested separately.
What it helps with
- turn an approved song into a narrative video
- draft a project bible for the film
- audit scenes for goals, obstacles, tactics, and reversals
- prepare shots, motion, and a checked edit
Example prompts for the agent
- Make a narrative music video from the approved song using the Small Room workflow.
- Resume the project from its earliest unfinished stage and keep approved assets.
- Review
BIBLE.md, audit the scenes, and prepare the video shot list.
How to install recoup-music-video
1Skills CLI (Vercel)
npx skills add recoupable/skills --skill recoup-music-video -a claude-code2Manually: put the files in place
~/.claude/skills/recoup-music-video/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/recoup-music-video/
1Skills CLI (Vercel)
npx skills add recoupable/skills --skill recoup-music-video -a codex2Manually: put the files in place
.agents/skills/recoup-music-video/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add recoupable/skills --skill recoup-music-video -a cursor2Manually: put the files in place
.cursor/skills/recoup-music-video/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install recoupable/skills recoup-music-video2Manually: put the files in place
.github/skills/recoup-music-video/SKILL.md1Skills CLI (Vercel)
npx skills add recoupable/skills --skill recoup-music-video -a gemini-cli2Platform CLI
gemini skills install https://github.com/recoupable/skills --path skills/recoup-music-videoManually: put the files in place
.devin/skills/recoup-music-video/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add recoupable/skills --skill recoup-music-video -a opencodeClaude.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 recoup-music-video
How do I install recoup-music-video in Claude Code?
Run npx skills add recoupable/skills --skill recoup-music-video -a claude-code, then check ~/.claude/skills/recoup-music-video/SKILL.md.
What does recoup-music-video do?
It guides an agent through the production of a narrative music video, from the approved song and story bible to reviewed shots, motion, and a verified edit.
What is required for song timing?
The workflow expects an approved recording plus an ElevenLabs Scribe transcript with word timestamps saved in audio/scribe.json. Whisper is not used for this process.
