bitwize-music-studio/claude-ai-music-skills / skills/suno-voice
suno-voice
VerifiedPuts one of the user's saved Suno Voices on a track or a whole album so /bitwize-music:generate sings in it, takes it off again, lists the Voices on their Suno account, or gives them Suno's link to make a new one. Checks the Voice exists first; nothing is generated or charged. Use when the user says "use my <name> voice", "sing this album in <Voice>", "what voices do I have", "take the voice off track 3" or "make a new voice".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.3 KB |
SKILL.md
View on GitHub---
name: suno-voice
description: Puts one of the user's saved Suno Voices on a track or a whole album so /bitwize-music:generate sings in it, takes it off again, lists the Voices on their Suno account, or gives them Suno's link to make a new one. Checks the Voice exists first; nothing is generated or charged. Use when the user says "use my <name> voice", "sing this album in <Voice>", "what voices do I have", "take the voice off track 3" or "make a new voice".
argument-hint: list | <album-name> [<track>] "<Voice name>" | <album-name> [<track>] --off | create
model: sonnet
effort: low
allowed-tools:
- Read
- bitwize-music-mcp
- mcp__suno__account-usage
- mcp__suno__voices-list
- mcp__suno__voices-start
---
## 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.
- `features` lacks `voices` → 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
1. **Find it.** `voices-list(query: <name>)`. Nothing → once more with `collection: "loved"`.
2. **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 call `voices-start` unless they ask.
3. **Write it.** `set_track_voice(album_slug, voice, track_slug, saved_from, vocal_identity)`:
- `voice`: the Voice's `name`. Use its `id` instead when another of their Voices has the same name, or when the Voice is a public one found by id, so `/generate` finds exactly this Voice.
- `saved_from`: `https://suno.com/song/<root_clip_id>` when `voices-list` gave a `root_clip_id`.
- `vocal_identity`: the Voice's `description` when it has one.
- `track_slug`: empty for the whole album.
4. **Report.**
```
Track 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.
```
For an album, name the tracks it went on, and the instrumental tracks it skipped. An `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.
1. Call `voices-start`. It takes no arguments.
2. A `url` comes 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.
```
3. 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
1. **Check before writing** — a Voice goes in a track file only after `voices-list` has found it.
2. **Free** — nothing here generates or charges. Singing happens at `/generate`, with its own cost and go-ahead.
3. **The user names the Voice** — never pick one for them; with several matches, ask.
4. **`voices-start` only on request** — when a Voice is missing, offer it; call it only when they want to make one.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |