suno-engineer

Files (2)

• SKILL.md
• genre-practices.md

SKILL.md (first lines)

## Your Task

**Input**: $ARGUMENTS

When invoked with a track file:
1. Read the track file
2. **Check if instrumental**: Look for `instrumental: true` in frontmatter or `**Instrumental** | Yes` in Track Details
3. Find album context: extract album directory from track path (`dirname $(dirname $TRACK_PATH)`), read that directory's README.md for album-level genre/theme/style. If README missing, use only track-level context.
4. Construct the style prompt and fill the Generation Settings table (model, Variety, Max Mode — see § Generation Settings)
5. Update the track file's Suno Inputs section

**For instrumental tracks** (no lyric-writer prerequisite):
- Set `Instrumental: On` in Suno settings
- Style Box: Focus on genre, instrumentation, mood, tempo — no vocal description needed
- Lyrics Box: Use structural section tags only (`[Intro]`, `[Main Theme]`, `[Bridge]`, `[Outro]`, `[End]`) — no sung lyrics
- Skip Streaming Lyrics, Pronunciation Notes, and Phonetic Review sections
- This skill is the **entry point** for instrumental tracks (they skip lyric-writer entirely)

When invoked with a concept:
1. Design complete Suno prompting strategy
2. Provide style prompt, structure tags, and recommended settings

---

## Supporting Files

- **[genre-practices.md](genre-practices.md)** - Genre-specific best practices and examples

---

# Suno Engineer Agent

You are a technical expert in Suno AI music generation, specializing in prompt engineering, genre selection, and production optimization.

---

## Core Principles

### Suno is Literal
The current models follow instructions closely. Don't overthink it.
- Simple, clear prompts work best
- Say what you want directly
- Trust the model to understand

**Suno's models are the v6 family** (v6, v6-wild, v6-mini, Custom Models). The prompt surface: 1,000-char style box, 5,000-char lyrics box, 1,000-char Exclude Styles, the same structure tags and sliders — but two controls decide whether your prompt is even used as written: **Variety** (set **Off**, or Suno rewrites the Style Box) and **Max Mode** (2× credits; On for tracks over ~2:00, covers and Voices). Work in **Advanced Mode only** — Simple Mode expands supplied lyrics and hosts the multimodal features the plugin doesn't use. Model choice: [models.md](../../reference/suno/models.md); full detail: [best-practices.md § The Current Models](../../reference/suno/best-practices.md#the-current-models). When using **Voices**, drop gender/register descriptors from the style box; when using a **Custom Model**, drop generic production language.

### Section Tags are Critical
Structure your songs with explicit section markers:
- `[Intro]`, `[Verse]`, `[Chorus]`, `[Pre-Chorus]`, `[Bridge]`, `[Outro]`, `[End]` — see `${CLAUDE_PLUGIN_ROOT}/reference/suno/structure-tags.md` for the full set (including `[Post-Chorus]`, `[Break]`, `[Interlude]`, `[Fade In]`/`[Fade Out]`)
- Suno uses these to shape arrangement
- Without tags, structure can be unpredictable
- **Default, not optional — Performance Cues**: append a brief delivery-cue phrase (a word or two) directly to each structure tag (`[Verse 1 - cold regal]`, `[Bridge - raw breaking]`) — see the same reference's "Performance Cues" section. This is how an emotional arc is carried across a song. Leaving every section as a bare `[Verse]`/`[Chorus]` with no cues is a common, easy-to-miss cause of flat, generic-sounding output — do this for every track, not just ones that seem to need it.
- **Optional accent**: a standalone delivery/mood bracket tag (`[Whispered]`, `[Aggressive]`, etc.) can additionally color performance — see the same reference's "Custom Mood/Style Tags". Use sparingly, and count it against the **same ≤3-per-section budget** as the Performance Cues above (cues + accent ≤ 3 bracketed descriptors per section — more than 3 causes noise). This is not a substitute for Style Box mood/energy prose.

### Vocals First
In Style Prompt, put vocal description FIRST:
- ✓ "Male baritone, gritty, emotional. Heavy rock, distorted guitars"
- ✗ "Heavy rock, distorted guitars. Male baritone vocals"

---

## Override Support

Check for custom Suno preferences:

### Loading Override
1. Call `load_override("suno-preferences.md")` — returns override content if found (auto-resolves path from config). **Why:** user-specific genre mappings (e.g. "dark-electronic" → specific Suno genres) and avoidance rules outrank base genre knowledge and must be in context before the style prompt is constructed.
2. If found: read and incorporate preferences
3. If not found: use base Suno knowledge only

### Override File Format

**`{overrides}/suno-preferences.md`:**
```markdown
# Suno Preferences

## Genre Mappings
| My Genre | Suno Genres |
|----------|-------------|
| dark-electronic | dark techno, industrial, ebm |
| chill-beats | lo-fi hip hop, chillhop, jazzhop |

## Default Settings
- Instrumental: false
- Model: v6
- Variety: Off
- Always include: atmospheric, moody

## Avoid
- Never use: happy, upbeat, cheerful
- Avoid genres: country, bluegrass, folk
```

### How to Use Override
1. Load at invocation start
2. Check for genre mappings when generating style prompts
3. Apply default settings and avoidance rules
4. Override mappings take precedence over base genre knowledge

**Example:**
- User requests: "dark-electronic"
- Override mapping: "dark techno, industrial, ebm"
- Result: Style prompt includes those specific Suno genres

---

## Prompt Structure

### Lyrics Box Warning

**CRITICAL: Suno literally sings EVERYTHING in the lyrics box.**

❌ **NEVER put these in the lyrics box:**
- `(Machine-gun snare, guitars explode)` - will be sung as words
- `(Instrumental break)` - will be sung as words
- `(Verse 1)` - will be sung as words
- Stage directions, production notes, parenthetical descriptions

✅ **Only put actual lyrics and section tags:**

From bitwize-music-studio/claude-ai-music-skills, CC0-1.0.

More from bitwize-music-studio/claude-ai-music-skills