Your Task
Input: $ARGUMENTS
Work with the user's saved Suno Voices: list them, put one on a track or an album, take one off, or hand over Suno's link for making a new one.
Nothing here generates or costs anything. The Voice sings at the next /bitwize-music:generate of the track, at that command's usual cost.
Suno Voice Skill
A track sings in a saved Voice when the Voice row of its ## Cover / Voice Setup block names it (templates/track.md § Voice Selection). /bitwize-music:generate reads that row and finds the Voice's id on the user's Suno account. Background: ${CLAUDE_PLUGIN_ROOT}/reference/suno/mcp-api-mapping.md § Covers and Voices.
Step 1: Resolve
list(or "what voices do I have") → Step 3.create(or "make a new voice") → Step 6.<album> [<track>] "<Voice>"→ Step 4. No track means every track of the album that has lyrics.<album> [<track>] --off(or "take the voice off") → Step 5.
Step 2: Check the Suno Server
Follow § Preflight in the reference doc: find voices-list, voices-start and account-usage on the connected Suno server, load their current definitions, and read account-usage once.
- Not connected → say a Voice is checked against the Suno account through Suno's MCP server, give the setup command from § Preflight, and stop.
featureslacksvoices→ say Suno's Voices need a Pro or Premier plan, and stop.
Taking a Voice off (Step 5) needs none of this.
Step 3: List the Voices
voices-list (the user's own Voices, newest first). Show the names on one line each, no more than 20:
Your Voices on Suno (newest first):
RTB · Missed Connections · ASCII · Mac · TayTay · Player Two
next_cursor set → say there are more and offer the next page. Voices they loved on suno.com are in collection: "loved"; show those when asked.
Step 4: Put a Voice on a Track or an Album
- Find it.
voices-list(query: <name>). Nothing → once more withcollection: "loved". - Choose. One match, or one whose name is exactly the one asked for (ignoring case) → that Voice. Several otherwise → show their names and ask which. None → say it is not on their Suno account and show their Voices (Step 3) so they can pick one. They can also make one with
/bitwize-music:suno-voice create— say so, but do not callvoices-startunless they ask. - Write it.
set_track_voice(album_slug, voice, track_slug, saved_from, vocal_identity):voice: the Voice'sname. Use itsidinstead when another of their Voices has the same name, or when the Voice is a public one found by id, so/generatefinds exactly this Voice.saved_from:https://suno.com/song/<root_clip_id>whenvoices-listgave aroot_clip_id.vocal_identity: the Voice'sdescriptionwhen it has one.track_slug: empty for the whole album.
- Report.
For an album, name the tracks it went on, and the instrumental tracks it skipped. AnTrack 03 now sings in RTB. The next /bitwize-music:generate uses it (10 credits for two takes, as usual). Takes made earlier keep their voice.error(an instrumental track, an unknown track) → show it.
A Voice carries its own gender, so the track's Vocal Gender is not sent with it. A Voice made on an older Suno model may need "Upgrade Voice to v6" on suno.com before it sings well.
Step 5: Take a Voice Off
set_track_voice(album_slug, "—", track_slug). The track then sings in the voice its Style Box describes. Say which tracks changed; unchanged ones had no Voice.
Step 6: Make a New Voice
Only when the user asks for one.
- Call
voices-start. It takes no arguments. - A
urlcomes back → give it to the user:Make your Voice on suno.com: <url> Record and verify it there. When it's ready, tell me its name and the track or album to use it on. - No
url→ say what Suno answered and stop. An account signed in with an API key gets a 409; Voices are made by a user signed in on suno.com.
Never ask the user for recordings or audio files: Suno takes them on that page. Once the Voice is ready it appears in voices-list, and Step 4 puts it on a track.
Remember
- Check before writing — a Voice goes in a track file only after
voices-listhas found it. - Free — nothing here generates or charges. Singing happens at
/generate, with its own cost and go-ahead. - The user names the Voice — never pick one for them; with several matches, ask.
voices-startonly on request — when a Voice is missing, offer it; call it only when they want to make one.