generate
Generates a track on Suno through Suno's official MCP server - a song, a cover of another Suno song, a track sung in a saved Voice, a spoken-word piece, or a sketch that plays a MIDI score.
Install / Use
npx skills add bitwize-music-studio/claude-ai-music-skills --skill generateInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Our assessment of generate
generate scores 92/100 on our quality scale, 71st of 354 Other skills we index (top 21%).
Its SKILL.md is 21 KB long, well organised into 17 sections with 5 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 generate 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
ReviewOur scan of the whole file found 1 pattern worth reviewing before you install generate.
- mediumSends the output of a local command to a remote serverline 255
โฆields` entry first and the file last as `file` โ `curl -sS -o /dev/null -w '%{http_code}' -F 'key=โฆ' -F 'policy=โฆ' โฆ -F 'file=@<midi.path>' โฆ
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.
generate compared with similar skills
All 4 of these similar skills score higher than generate; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| generate (this skill)by bitwize-music-studio | 92 | 512 | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.3k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.5k | today | CLAUDE.md |
Frequently asked questions
- How do I install generate?
- Run
npx skills add bitwize-music-studio/claude-ai-music-skills --skill generate. The install tabs above show the steps for each supported agent. - Which AI agents does generate 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 generate safe to use?
- Our scan of the whole file found 1 pattern worth reviewing before you install generate. 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 generate still maintained?
- The repository was last updated about 2 months ago, so generate is actively maintained.
Skill content
View source on GitHubname: generate description: Generates a track on Suno through Suno's official MCP server - a song, a cover of another Suno song, a track sung in a saved Voice, a spoken-word piece, or a sketch that plays a MIDI score. Runs the pre-generation gates, shows the cost, waits for a go-ahead, makes two takes, logs them and hands off to listening. Use when the user says "generate track N", "regenerate", or is ready to make audio. Falls back to the clipboard flow when the Suno server is not connected. argument-hint: <album-name> [track-number-or-slug] [--midi [file]] [--no-listen] [--no-check] model: sonnet effort: medium prerequisites:
- suno-engineer allowed-tools:
- Read
- Edit
- bitwize-music-mcp
- mcp__suno__account-upgrade
- mcp__suno__account-usage
- mcp__suno__audio-covers-create
- mcp__suno__audio-create
- mcp__suno__audio-like
- mcp__suno__audio-unlike
- mcp__suno__audio-wait
- mcp__suno__midi-upload-complete
- mcp__suno__midi-upload-create
- mcp__suno__speech-create
- mcp__suno__voices-list
- mcp__suno__workspaces-create
- mcp__suno__workspaces-list
- mcp__suno__workspaces-update-clips
Your Task
Input: $ARGUMENTS
Generate one track on Suno through the Suno MCP server: check the gates, show what it will cost, get a go-ahead, generate, log the takes, and hand off to listening.
You never choose a take, mark one as the keeper, set a track Final or publish a song. The user listens and decides.
Generate Skill
You run the generation hop โ the one step that used to mean leaving the terminal for suno.com.
pre-generation-check โ generate โ listen โ [user picks the keeper] โ import-audio --from-suno
โ
You are here
Setup, costs, the track-file mapping and the tool notes are in ${CLAUDE_PLUGIN_ROOT}/reference/suno/mcp-api-mapping.md. Read it before your first Suno call in a session.
Step 1: Resolve the Track
Expected format: <album-name> [track-number-or-slug] [--midi [file]] [--no-listen] [--no-check]
If arguments are missing, show:
Usage: /generate <album-name> <track> [--midi [file]] [--no-listen] [--no-check]
Example: /generate sample-album 03
--midi makes the track from a MIDI file: see From a MIDI Score before Step 4.
With a track, this run generates that one track. With an album and no track, go to Album Mode below: every track that is ready, after one summary and one go-ahead. If the user names a few tracks, do them one at a time โ each gets its own summary and its own go-ahead.
Step 2: Run the Gates
Call run_pre_generation_gates(album_slug, track_slug).
- Any blocking gate failed โ show the failed gates and the fix for each, then stop. You fix nothing yourself.
- Warnings only โ show them and continue.
Step 3: Check the Suno Server
Follow ยง Preflight in ${CLAUDE_PLUGIN_ROOT}/reference/suno/mcp-api-mapping.md:
- Find
audio-create,audio-waitandaccount-usageon a connected MCP server. Load their definitions now; do not rely on a parameter list you remember. - Not connected or not signed in โ show the Fallback below and stop.
- Call
account-usageand keepallowed_models,features,suno_account.credits_remainingandsuno_account.download_credits_remaining.
Step 4: Build the Request
Call get_generation_request(album_slug, track_slug). It reads what kind of request the track makes and names the Suno tool to send it to in tool: a song (audio-create), a cover (audio-covers-create) or spoken word (speech-create). The differences are under Covers, Voices and Spoken Tracks.
| Result | Do |
|--------|-----|
| found: false | Report the error and stop |
| supported: false | List the blocking problems and stop. For custom_model_unsupported or cover_source_not_on_suno, show the Fallback |
| tool is not audio-create | Find that tool and load its definition as in Step 3. features lacks generate.cover (a cover) or speech (spoken word) โ say the plan does not include it and stop |
| voice is set | voices-list(query: <voice.name>); nothing found โ once more with collection: "loved". One match, or one whose name is exactly the Voice's โ add its id to the request as voice_id. Several otherwise โ ask which. None, or features lacks voices โ name the Voice, say it was not found on the Suno account, point to /bitwize-music:suno-voice (it lists their Voices, and gives Suno's link to make a new one when they ask), and stop |
| track_status is Final | Say the track already has an approved take and ask whether to regenerate. Stop unless the answer is yes |
| request.model is not in allowed_models | Say the plan does not include that model and stop |
| A key in needs_grant while features lacks controls.advanced | Remove that key from the request and remember to say so in the summary. A dotted name such as controls.weirdness is a key inside controls; controls.variety is never listed and stays |
| Warnings in problems | Show them and continue |
Also call get_listen_plan(album_slug, track_slug) and keep mode, confirm_download, player and iterm2 for the summary.
Step 4b: The Album's Workspace
Each album's takes live in a Suno workspace of their own, so they are easy to find on suno.com. Call get_album_workspace(album_slug). Skip this step when enabled is false (generation.suno_workspaces: false in the config).
workspaceset โ callworkspaces-list(query: <workspace.name>)and look forworkspace.idamong the answers. Found โrequest.workspace_idis already set; nothing more to do. Not found โ the workspace was deleted on suno.com: say so and offer "create it again" or "carry on without". Never recreate it silently. For "carry on without", dropworkspace_idfromrequestfor this run.workspacenull โ plan to create one in Step 6: keepsuggested_nameandbatches, and add the Workspace line to the summary.
Step 5: Show the Summary and Get a Go-Ahead
Nothing has been spent yet. Show exactly what will be sent and what it costs:
READY TO GENERATE โ [NN] [Title] ([album])
Model v6
Takes 2 (one call always makes two)
Max Mode On โ costs a multiple of the usual credits (2ร on suno.com)
Variety Off โ the Style Box is used as written
Sliders Weirdness 50 ยท Style Influence 50
Duration Auto
Exclude choir, crowd vocals
Dropped vocal_gender โ your plan lacks advanced controls
Cost about 10 song credits (20 with Max Mode). You have 9,935.
Workspace create "Album Title" on suno.com and file the takes there (free),
and file its 4 earlier takes
Then open both takes in your browser (free).
(Playing them here instead uses 2 download credits. You have 66.)
Go ahead? yes ยท generate only ยท play here instead ยท without Max Mode ยท without a workspace ยท cancel
Rules for the summary:
- Leave out any line that does not apply (no Max Mode, nothing excluded, nothing dropped).
- Variety is shown whenever the request holds
controls, fromrequest.controls.variety: 0 Off, 1 Normal, 2 High, 3 Extra, 4 Max. Above Off, say "Suno rewrites the Style Box before generating" instead. - Anything in
ignoredgoes on a Not sent line with its setting, value and reason โ a cover, a spoken track and a score each leave some settings behind. - Name what kind it is when it is not a plain song: a
Cover ofline withcover.source_url, aVoiceline with the Voice's name,Audio influenceamong the sliders, orSpoken wordwith the script's length andBacking music On/Offin place of the model lines. - Max Mode appears only when the request holds
max_mode: true. Suno asks that Max Mode be turned on only at the user's request, so the user's yes to a summary that names it is that request. If they answer "without Max Mode", removemax_modeand proceed. - Then follows the listen plan:
--no-listenโ leave the line out.modeisbrowser(the default) โ the browser line above. Drop the "playing them here" note, and the "play here instead" answer, whenplayeris null or fewer than 2 download credits are left.modeisiterm2_browserand the plan'siterm2.availableis true โ the same line with "beside this session, in iTerm2 panes" in place of "in your browser". The note and the "play here instead" answer follow the browser rule.modeisiterm2_browserbutiterm2.availableis false โ the browser line above, with the plan'siterm2.reasonin a clause.modeisterminalโ "play both takes here: 2 download credits. You have N. (Opening them in the browser instead is free.)", with "browser instead" among the answers.modeisterminalbutplayeris null โ "open both takes in your browser (free) โ no audio player is installed; install mpv to play here".modeisterminaland fewer than 2 download credits are left โ "open both takes in your browser (free) โ you have N download credits left".
- Workspace appears only when Step 4b planned one. Add "and file its N earlier takes" when
clipsis not empty. "Without a workspace" skips it for this run, and the answers list carries that option only when the line is shown. - A yes covers exactly what the Then and Workspace lines say. Terminal playback spends download credits only when the summary said so or the user answered "play here instead".
- Wait for an explicit answer. Silence is not a yes.
Step 6: Generate
- Fix an idempotency key before the first attempt:
{album_slug}/{track_slug}/{UTC timestamp}, for examplesample-album/03-t-day-beach/2026-06-15T12:00:00Z. If Step 4b planned a workspace, make it first:workspaces-create(name: <suggested_name>), thenset_album_workspace(album_slug, <its id>, <its name>), then oneworkspaces-update-clips(id: <its id>, add: <list>)per list inbatchesfor the earlier takes (checkskipped). Putworkspace_id: <its id>into the request. Ifworkspaces-createfails, say so and generate without one; the takes can be filed later. - Call the tool named in
toolwith the keys ofrequest, thevoice_idfrom Step 4 when the track names a Voice, and theidempotency_key. Add nothing else. - The answer carries two ids in
clip_ids. Tell the user the takes are generating. - Call
audio-waitwith every id inidsanduntil: "complete". It returns after about 50 seconds whether or not the songs are finished; call it again while any is still pending. A song usually takes one to three minutes. - Call
account-usageagain. Credits spent = balance before โ balance after.
| What happened | Do |
|---------------|-----|
| No response or a timeout from the create call | Retry once with the same idempotency key |
| The call is rejected for an unknown argument | Remove that argument, tell the user, and retry once with a new key (the arguments changed) |
| 402 โ out of credits | Call account-upgrade, show its link, and stop. Log nothing |
| 403 โ model or feature not on the plan | Name what is missing. Offer to retry without it when it is max_mode, controls, negative_style or vocal_gender; otherwise show the Fallback |
| 400 โ Suno's content check rejected the title, lyrics or style | Show Suno's message word for word and stop. The track's status does not change |
| One take ends with status: error | Log it as failed in Step 7 and carry on with the other |
Never send the create call a second time for the same go-ahead except as the table says. Each successful call spends credits.
Step 7: Log the Takes
Call log_generation(album_slug, track_slug, model, clips, notes):
modelโ the model that was sent (defaultif none was;speechfor a spoken track).clipsโ one entry per clip id: `{"clip_id": ..., "status": "complete" or "error", "duration_s": the clip's metadata.duration, "error": the rea
Truncated for display โ read the full file on GitHub.
Related Skills
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu โ one CLI, zero API fees.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.3k๐ The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.5kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
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.
