Skip to content

bitwize-music-studio/claude-ai-music-skills / skills/suno-voice

suno-voice

Verified

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

FileKindSize
SKILL.mdskill md5.3 KB
---
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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall