music-video
Makes a music video for a track through Suno's Sequences - shots laid out on the song's sections, a keyframe for each, a free animatic to judge the pacing, then generated clips for the shots the user chooses - and saves the animatic and the finished video beside the album's audio.
Install / Use
npx skills add bitwize-music-studio/claude-ai-music-skills --skill music-videoInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Tags
Our assessment of music-video
music-video scores 90/100 on our quality scale, 111th of 354 Other skills we index (top 32%).
Its SKILL.md is 19 KB long, well organised into 14 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
It has 512 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so music-video is actively maintained.
- It is released under the CC0-1.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-21. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
music-video compared with similar skills
All 4 of these similar skills score higher than music-video; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| music-video (this skill)by bitwize-music-studio | 90 | 512 | 2mo ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| prospectingby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
| ad-creativeby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
Frequently asked questions
- How do I install music-video?
- Run
npx skills add bitwize-music-studio/claude-ai-music-skills --skill music-video. The install tabs above show the steps for each supported agent. - Which AI agents does music-video work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is music-video safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is CC0-1.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is music-video still maintained?
- The repository was last updated about 2 months ago, so music-video is actively maintained.
Skill content
View source on GitHubname: music-video description: Makes a music video for a track through Suno's Sequences - shots laid out on the song's sections, a keyframe for each, a free animatic to judge the pacing, then generated clips for the shots the user chooses - and saves the animatic and the finished video beside the album's audio. Laying out and exporting are free; keyframes and clips spend Visuals credits, priced and approved step by step. Use when the user asks for a music video, a storyboard or an animatic for a track. argument-hint: <album-name> <track> [--shape 16:9|1:1|9:16] model: sonnet effort: medium allowed-tools:
- Read
- bitwize-music-mcp
- mcp__suno__account-usage
- mcp__suno__audio-analysis
- mcp__suno__audio-download
- mcp__suno__audio-retrieve
- mcp__suno__characters-list
- mcp__suno__sequence-create
- mcp__suno__sequence-export
- mcp__suno__sequence-generate
- mcp__suno__sequence-get
- mcp__suno__sequence-list
- mcp__suno__sequence-update
- mcp__suno__visuals-download
- mcp__suno__visuals-models
- mcp__suno__visuals-show
- mcp__suno__visuals-wait
requirements:
external:
- name: ffmpeg purpose: Checking the video and putting the mastered audio under it install: "brew install ffmpeg (macOS) or apt install ffmpeg (Linux)" notes: "Optional. Without it the video is saved as Suno makes it, with Suno's own audio"
Your Task
Input: $ARGUMENTS
Take one track's approved take to a music video on Suno, a stage at a time: lay the shots out, make their keyframes, export an animatic, turn the shots the user chooses into clips, and save the result.
The user decides the look, who is on screen, which take of a shot to keep, and what to spend. You price, ask and wait.
Music Video Skill
Suno's Sequences lay a music video out as a timeline of shots over a song. Each shot holds a still, its keyframe, until a generated clip replaces it, and the cut can be exported at any point. With only keyframes in it, the export is an animatic: the stills held in time with the song, to judge the pacing before paying for clips.
What it costs, in Visuals credits, a balance of its own beside song and download credits:
| Stage | Cost |
|-------|------|
| Laying the shots out, changing the cut, exporting, downloading | Free (measured) |
| A keyframe | Per shot: 1 on image-1 (Fast). Suno's own default, image-4, is 50 |
| A clip | Per second: 15 on video-1 (480p), 30 on video-2 (720p). Charged by the whole second, rounded up: a 9.44-second shot is charged as 10 |
A whole song as clips costs thousands: three minutes at 480p is about 2,700. That is why the animatic comes first, and why most videos keep stills for most shots. Say so before any work, in Step 3.
Measured on a six-shot test: six keyframes cost 6 credits and a five-second clip 75, each charged when its call was made and ready in under a minute. Still unmeasured, and written from Suno's tool descriptions: characters, a shot that fails, and the rate-limit, refusal and unknown answers.
Every paid call is sent for real once. It goes out exactly as it was priced, with a key fixed beforehand, and it is sent again only where Step 6's table says so. A shot that holds a take, or is making one, is never made again unless the user asks for that and approves its price.
Background, the answers each tool gives, and what was and was not measured: ${CLAUDE_PLUGIN_ROOT}/reference/suno/mcp-api-mapping.md § Visuals.
Step 1: Plan
Expected format: <album-name> <track> [--shape 16:9|1:1|9:16]
If the album or the track is missing, show:
Usage: /music-video <album-name> <track> [--shape 16:9|1:1|9:16]
Example: /music-video sample-album 03
Call get_music_video_plan(album_slug, track_slug, shape). The shape is 16:9 unless the user names another.
| Result | Do |
|--------|-----|
| found: false, or an error | Report it and stop |
| A blocking problem | Show its detail and stop. no_keeper: the user approves a take first |
| no_master | Say the video will carry Suno's own audio, and carry on |
| video_exists | Tell the user. The question whether to replace it comes in Step 9 |
Step 2: Check the Suno Server
Find sequence-create, sequence-generate, sequence-update, sequence-get, sequence-list, sequence-export, visuals-wait, visuals-download, visuals-models, audio-analysis, audio-retrieve, audio-download and account-usage on a connected MCP server, and load their definitions.
Not there → say so and stop. Either Suno's server is not connected, or this session started before Suno added the tools and needs a restart.
Call account-usage and keep the three balances. Call visuals-models and keep each model's price: credits_per_generation for an image model, credits_per_second for a video model. Both calls are free.
Then look for a Sequence this track already has, before planning anything: one that is found and missed would be paid for twice.
sequence-list(query: <sequence_title>). A page can be short, or empty, and still carry acursor: pass it back until a page has none, ten pages at most.- For each one whose title is the
sequence_title,sequence-get(id, view: "full"). It is this track's only if itssong_idissong.clip_id. Tell the user if itsaspectis not the shape asked for: the video is saved under the Sequence's shape. - Found one → ask whether to carry on with it or start another. To carry on, read each shot's
statusand follow Carrying On below. None → Step 3.
Carrying On
A Sequence keeps what was made. Never make again what a shot already holds or is making:
| A shot reads | It | Do |
|--------------|----|-----|
| gap | Has nothing | It needs a keyframe (Step 6) |
| processing | Is being made, and is paid for | Wait for it: visuals-wait with its generation_id. Never start it again |
| ready, media_type: image | Has its keyframe | Leave it. It can become a clip (Step 8) if the user picks it |
| ready, media_type: video | Has its clip | Leave it |
| failed | Lost its generation | See Step 8, item 7 |
Go to the earliest step some shot still needs, and put only the shots that need it in that step's batches. Skip Steps 3 to 5, except audio-retrieve and the lock check in Step 3, which every run needs.
Step 3: The Song, and What the Video Would Cost
-
audio-retrieve(id: <song.clip_id>). Keepmetadata.duration. -
Find out whether the song is locked:
audio-download(id: <song.clip_id>, format: "mp3")withoutconfirm.status: "ok"→ unlocked.status: "requires_credit"→ locked: keep that for Step 7, where the first download happens, and spend nothing now.rate_limited→ wait the seconds it names and call again. Any other refusal → report it and stop. -
audio-analysis(id: <song.clip_id>). Whilestatusisprocessing, call it again, six times at most; it usually takes about a minute. Keepsections,bpm,time_signature, and thetime_sof the first beat whosebar_positionis 1. The answer is long: do not repeat it to the user. If it endsunavailable, carry on with no sections. -
plan_music_video_shots(duration_s, sections, bpm, time_signature, first_downbeat_s, credits_per_second: <video-1's price>). -
Tell the user the scale before anything else. For example:
First Track (3:26) lays out as 22 shots. Keyframes for all of them: 22 Visuals credits on image-1. Every shot as a clip: 210 billed seconds, about 3,150 credits at 480p or 6,300 at 720p. You have 1,000. Three ways to go: 1. An animatic: keyframes held as stills, in time with the song. 2. Clips for a few shots you pick, stills for the rest. 3. Every shot a clip.Ask which. Nothing has been spent, and nothing is made on Suno until Step 5.
Step 4: The Look
Three things are the user's to choose, so ask unless they have said:
- The look: the style, the palette, anything that must not appear (text, faces, logos).
- Who or what is on screen. A performer, characters, or no one.
- Whether anyone sings on screen, and whether the words are burned in (
lyrics).
A performer or a place that should look the same from shot to shot needs reference images that are already on Suno, one to three each: the asset ids of images made there, or the user's saved characters from characters-list. Without them, leave characters and sets out: each shot is then drawn from its prompt alone, and faces will not match between shots. Say so if the user wants a performer.
A set holds well (measured): three shots citing one reference image showed the same objects and the same place. It also outweighs the prompt: a shot that asked for one object alone showed the several in the reference. So cite a set only in shots that should show what its images show.
Then draft the storyboard: one line a shot, saying what it shows, the framing and how the camera moves, all within the look. Show it as a table with each shot's number, start time, length and section, and change it until the user approves it. The lengths come from Step 3; to change them, plan again with another max_shot_s.
Step 5: Lay It Out (free)
get_music_video_plan(album_slug, track_slug, shape, shots: [{duration_s, notes, characters?, set?}], style, lyrics, characters, sets). A blockingrequest_invalid→ show itsdetailand stop. Keeprequest. Ifrequestis null, stop and say what is missing; never put the arguments together yourself.- Call
sequence-createwith exactly the keys ofrequestandidempotency_key: "{album_slug}/{track_slug}/music-video/create/{UTC timestamp}", the time filled in once: a retry after an error sends the same string, so it cannot make a second Sequence. Keep thesequence_id, theeditor_url, and every shot'sshot_idwith its number.
Tell the user the editor_url: they can rearrange, trim and retime the shots on suno.com at any point, and sequence-get reads what they changed.
Step 6: Keyframes (paid)
One image a shot, made from a prompt: the look, then the shot's line from the storyboard. Name the characters and the set in the prompt as the Sequence names them.
-
The model.
image-1unless the user asks for another. Always name it: left out, Suno usesimage-4at 50 credits a shot. -
Price it. This spends nothing.
sequence-generatetakes up to 8 shots a call, so split the shots into batches of 8 and write each batch down: the real call sends it unchanged. For each batch callsequence-generate(id: <sequence_id>, step: "keyframes", model, shots: [{shot_id, prompt}], dry_run: true). Each answer carriesdry_run: true, its price ascredits, and for every shot themodelit priced: check that it is the one you named. Add the batches up. If the model differs, the tool no longer listsdry_run, refuses it, or answers withoutdry_run: true, stop and tell the user. Never dropdry_runto get a call through. -
State the cost and wait. "Keyframes for 22 shots on image-1: 22 Visuals credits. You have 1,000." The balance is the dry run's
visuals_credits_remaining, which is today's, not the one read in Step 2. More than the balance → say so and stop. Do not generate until the user says go. -
Generate, once a batch. Fix each batch's key before its first attempt and write it down:
"{album_slug}/{track_slug}/music-video/keyframes/{batch number}/{UTC timestamp}", the time filled in. Then send each batch exactly as it was priced, withoutdry_runand with its key. Add nothing the price did not cover. -
Read each shot's
statusin the answer. One call can answer with several, andmoderation_limitedon any shot comes first.| Status | Do | |--------|-----| |
moderation_limited| Stop the whole stage: send nothing more, not even shots still waiting. Tell the user. Do not retry | |started| It is being made and is paid for. Keep its `generat
Truncated for display — read the full file on GitHub.
Related Skills
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
prospecting
60.1kWhen the user wants to find and qualify prospects for outbound, or asks who to target first, which signal to prioritize, or where to spot buyers with the problem: buying signals, enrichment, verification, account research.
ad-creative
60.1kWhen the user wants to write or judge ad creative, or asks which ad, hook, or angle to run or kill: headlines, primary text, and variations for Google, Meta, LinkedIn, and TikTok, fresh angles when creative fatigues. Test hypotheses name the metric, comparison, and expected direction.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
