SkillAgentSearch skills...

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 generate

Installs into whichever agent you are using.

About this skill
๐Ÿ“„

SKILL.md

Installable skill definition

Quality Score

92/100

Category

Other

Supported Platforms

Universal

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.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
12/20
Freshness
15/15

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

Review

Our 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.

SkillScoreStarsUpdatedFormat
generate (this skill)by bitwize-music-studio925122mo agoSKILL.md
Agent-Reachby Panniantong100114.0ktodayCLAUDE.md
hyperframesby heygen-com10088.2ktodayCLAUDE.md
rufloby ruvnet10082.3ktodayCLAUDE.md
headroomby headroomlabs-ai10080.5ktodayCLAUDE.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.

name: 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:

  1. Find audio-create, audio-wait and account-usage on a connected MCP server. Load their definitions now; do not rely on a parameter list you remember.
  2. Not connected or not signed in โ†’ show the Fallback below and stop.
  3. Call account-usage and keep allowed_models, features, suno_account.credits_remaining and suno_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).

  • workspace set โ†’ call workspaces-list(query: <workspace.name>) and look for workspace.id among the answers. Found โ†’ request.workspace_id is 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", drop workspace_id from request for this run.
  • workspace null โ†’ plan to create one in Step 6: keep suggested_name and batches, 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, from request.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 ignored goes 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 of line with cover.source_url, a Voice line with the Voice's name, Audio influence among the sliders, or Spoken word with the script's length and Backing music On/Off in 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", remove max_mode and proceed.
  • Then follows the listen plan:
    • --no-listen โ†’ leave the line out.
    • mode is browser (the default) โ†’ the browser line above. Drop the "playing them here" note, and the "play here instead" answer, when player is null or fewer than 2 download credits are left.
    • mode is iterm2_browser and the plan's iterm2.available is 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.
    • mode is iterm2_browser but iterm2.available is false โ†’ the browser line above, with the plan's iterm2.reason in a clause.
    • mode is terminal โ†’ "play both takes here: 2 download credits. You have N. (Opening them in the browser instead is free.)", with "browser instead" among the answers.
    • mode is terminal but player is null โ†’ "open both takes in your browser (free) โ€” no audio player is installed; install mpv to play here".
    • mode is terminal and 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 clips is 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

  1. Fix an idempotency key before the first attempt: {album_slug}/{track_slug}/{UTC timestamp}, for example sample-album/03-t-day-beach/2026-06-15T12:00:00Z. If Step 4b planned a workspace, make it first: workspaces-create(name: <suggested_name>), then set_album_workspace(album_slug, <its id>, <its name>), then one workspaces-update-clips(id: <its id>, add: <list>) per list in batches for the earlier takes (check skipped). Put workspace_id: <its id> into the request. If workspaces-create fails, say so and generate without one; the takes can be filed later.
  2. Call the tool named in tool with the keys of request, the voice_id from Step 4 when the track names a Voice, and the idempotency_key. Add nothing else.
  3. The answer carries two ids in clip_ids. Tell the user the takes are generating.
  4. Call audio-wait with every id in ids and until: "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.
  5. Call account-usage again. 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 (default if none was; speech for 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

View on GitHub
GitHub Stars512
CategoryOther
Updated2mo ago
Forks120

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit โ€” see the Safety scan above for what the skill file itself contains.

No cautions
generate โ€” Universal Skill: Install & Safety Check | SkillAgent