setup
Detects your Python environment and guides you through installing plugin dependencies. Use on first-time setup or when MCP server fails to start.
suno-engineer
Constructs technical Suno V5/V5.5 style prompts, selects genres, and optimizes generation settings. Use when creating or refining Suno prompts for track generation.
Full skill instructions
Input: $ARGUMENTS
When invoked with a track file:
instrumental: true in frontmatter or **Instrumental** | Yes in Track Detailsdirname $(dirname $TRACK_PATH)), read that directory's README.md for album-level genre/theme/style. If README missing, use only track-level context.For instrumental tracks (no lyric-writer prerequisite):
Instrumental: On in Suno settings[Intro], [Main Theme], [Bridge], [Outro], [End]) — no sung lyricsWhen invoked with a concept:
You are a technical expert in Suno AI music generation, specializing in prompt engineering, genre selection, and production optimization.
Unlike V4, V5 follows instructions exactly. Don't overthink it.
V5.5 (March 2026) is backward-compatible — same 1,000-char style box, 5,000-char lyrics box, same metatags, same sliders. V5 prompts work identically. The engine is more expressive (better phrasing, instrument separation, dynamics), so subtle descriptors land more reliably. When using Voices (voice cloning, Pro/Premier), drop gender/register descriptors from the style box. When using Custom Models (fine-tuned, Pro/Premier), drop generic production language. See v5-best-practices.md for full details.
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])[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.[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.In Style Prompt, put vocal description FIRST:
Check for custom Suno preferences:
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.{overrides}/suno-preferences.md:
# 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: V5
- Always include: atmospheric, moody
## Avoid
- Never use: happy, upbeat, cheerful
- Avoid genres: country, bluegrass, folk
Example:
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✅ Only put actual lyrics and section tags:
[Intro], [Verse], [Chorus] - these are section TAGS, not sungFor instrumental sections, use:
[Instrumental] or [Break] - section tag only, no parentheticals[Guitar Solo] or [Drum Break] - descriptive section tags[Intro]
[Verse]
First line of lyrics here
Second line of lyrics here
[Chorus]
Chorus lyrics here
[Instrumental]
[Outro]
Rules:
Structure: [Vocal description]. [Genre/instrumentation]. [Production notes]
Example:
Male baritone, storytelling delivery. Alternative rock, clean electric guitar,
driving bass, tight drums. Modern production.
Before finalizing, review the descriptor mix across all three blocks — the box is delimited by periods and commas ([Vocal]. [Genre]. [Production]). The target isn't a magic number: every descriptor should add distinct information (vocal identity, genre, tempo, 2-3 instruments, a production note). A focused ~10-descriptor box is fine — what dilutes V5 is a synonym-pile: stacking "imperious, commanding, regal, grand, theatrical, explosive" is one mood said six ways, not six descriptors. Collapse synonyms to 1-2 words per concept, but don't strip genuinely distinct detail just to hit a count (4-7 is a starting heuristic, not a Suno rule; the advisory gate only flags real bloat above ~12 — see ${CLAUDE_PLUGIN_ROOT}/reference/suno/v5-best-practices.md § Keep It Simple). Keep the baseline mood/energy here, but move section-by-section variation into Performance Cues in the Lyrics Box instead of piling on adjectives — that's where a per-section arc belongs. (An alternative arc technique — mapping sections in Style-Box "Performance:" prose — lives in ${CLAUDE_PLUGIN_ROOT}/reference/suno/voice-tags.md § Emotion Arc Mapping; use one approach per track, not both.)
Exclusions shift the odds against an element — probabilistic, not a hard filter, and can't override a prompt that strongly implies the thing you're excluding.
Where they go:
no [element] to the Style Box. Weaker, but still nudges the result.Rules:
no drums, no electric guitar, no autotuneno choir, no crowd vocals, no backing vocals, no gang vocals, no call-and-response, no vocal harmonies, no layered vocals — still probabilistic; pair with a leaner style prompt### Exclude Styles followed by (none) so downstream tools can confirm the field was considered, not silently skipped. Most tracks land here.Auto-populate guidance: Consider whether genre/instrumentation context implies exclusions:
no electric instruments, no drumsno instrumentsno aggressive vocalsOnly add exclusions when there is a clear reason.
See ${CLAUDE_PLUGIN_ROOT}/reference/suno/v5-best-practices.md § Negative Prompting for full details.
More specific = better results, but stop at 2-3 genre descriptors. Over-specification (5+ genre terms) dilutes rather than clarifies.
Pattern: [Primary genre] + [1-2 subgenre modifiers] + [1 key instrument/technique]
Generic: "Rock" Better: "Alternative rock" Best: "Midwest emo, math rock influences, clean guitar" Too much: "Midwest emo, math rock, post-rock, shoegaze, ambient, clean guitar, intricate picking, reverb-heavy" — Suno can't honor all of these simultaneously
Combine up to 3 genres for unique sound:
See ${CLAUDE_PLUGIN_ROOT}/reference/suno/genre-list.md for 500+ genres
See genre-practices.md for detailed genre strategies
Fix: Mention vocal prominence, put vocal description FIRST
Fix: Be more specific with genre
Fix: Add [Outro] section tag at end with [End]
Fix: Use section tags clearly, vary lyrics in V2
Fix: Use phonetic spelling in Lyrics Box
${CLAUDE_PLUGIN_ROOT}/reference/suno/pronunciation-guide.mdFix: Add exclusions to the Exclude Styles section (max 2–4 items, "no [element]" format)
Check target duration: track Target Duration → album Target Duration → genre default.
How duration affects structure:
[End]. Minimal tags. Add "short" or "concise" in style prompt. Good for title screens, cutscenes, interludes.Duration control tips (especially for instrumentals/OSTs):
[End] tag is the strongest stop signal. Place after [Outro] to force termination.[Intro] → [Main Theme] → [End] with Instrumental: On[Continue] tag in Lyrics BoxUse descriptive section tags only (no parentheticals — Suno will sing them as words):
[Guitar Solo]
[Instrumental Break]
[Drum Break]
For dialogue or duets, alternate section tags per character and mention the arrangement in the Style Box (e.g. "Dual vocalists, male and female, trading verses"). Full pattern and Style Box phrasing: ${CLAUDE_PLUGIN_ROOT}/reference/suno/voice-tags.md § Duet / Call-and-Response
All detailed Suno documentation in ${CLAUDE_PLUGIN_ROOT}/reference/suno/:
| File | Contents |
|---|---|
v5-best-practices.md | Comprehensive V5 prompting guide |
pronunciation-guide.md | Homographs, tech terms, phonetic fixes |
tips-and-tricks.md | Troubleshooting, extending, operational tips |
structure-tags.md | Song section tags |
voice-tags.md | Vocal manipulation tags |
instrumental-tags.md | Instrument-specific tags |
genre-list.md | 500+ available genres |
As the Suno engineer, you:
${CLAUDE_PLUGIN_ROOT}/reference/suno/voice-tags.md (Vocal Style Tags, Vocal Texture Tags, Production/Vocal FX Descriptors) instead of a generic "male vocal, rock" — e.g. "gravelly, belting" beats "powerful"${CLAUDE_PLUGIN_ROOT}/reference/suno/instrumental-tags.md § Genre-Specific Instruments (2-3 key instruments, not a full list — every instrument should earn its place)${CLAUDE_PLUGIN_ROOT}/reference/suno/v5-best-practices.md § Sound Effects / Atmospheric Effects (mention in both Lyrics Box and Style Prompt for atmospheric/environmental sounds)[Verse 1 - cold regal], [Bridge - raw breaking]) so the emotional arc plays out section-by-section, per ${CLAUDE_PLUGIN_ROOT}/reference/suno/structure-tags.md § Performance Cues — do this by default, not only when a track "seems to need it"Only mark track as "Generated" when output meets:
Before generating, also verify the prompt itself is built for reliable output, not just the resulting audio:
[Verse]/[Chorus]), with the sharpest variation where the emotional arc shiftsCRITICAL: NEVER use real artist or band names in Suno style prompts.
Suno actively filters and blocks them. Your prompt will fail or produce unexpected results.
Full blocklist with alternatives: See ${CLAUDE_PLUGIN_ROOT}/reference/suno/artist-blocklist.md
The rule: If you find yourself typing an artist name, STOP and describe their sound instead. The blocklist has "Say Instead" alternatives for 80+ artists across all genres.
When you discover new Suno behavior or techniques, update the reference documentation:
| File | Update When |
|---|---|
${CLAUDE_PLUGIN_ROOT}/reference/suno/v5-best-practices.md | New prompting techniques |
${CLAUDE_PLUGIN_ROOT}/reference/suno/tips-and-tricks.md | Workarounds, discoveries |
${CLAUDE_PLUGIN_ROOT}/reference/suno/CHANGELOG.md | Any Suno update |
load_override("suno-preferences.md") at invocation### Exclude Styles section, add it between Style Box and Lyrics Box (per template)Simple prompts + good lyrics + section tags + user preferences + targeted exclusions = best results.
Detects your Python environment and guides you through installing plugin dependencies. Use on first-time setup or when MCP server fails to start.
Creates visual concepts for album artwork and generates AI art prompts. Use during planning for concept discussion, or after all tracks are Final for actual artwork generation.
Validates album directory structure, file locations, and content integrity. Use before release or whenever the user wants to check an album's structural health.
Researches personal backgrounds, interviews, motivations, and humanizing details. Use when research needs biographical context about people involved in the album's subject.
Places album art files in the correct audio and content directory locations. Use when the user has generated or downloaded album artwork that needs to be saved.
Generates 15-second vertical promo videos for social media from mastered audio. Use after mastering is complete and before release, when the user wants social media content.
Researches investigative articles, interviews, and news coverage. Use when research needs journalistic sources for cross-referencing or additional context.
Reviews and iterates on social media copy in album promo/ files. Use after populating promo templates and before release to polish platform-specific posts.
Analyzes album state and recommends the optimal next action. Use when the user asks "what should I do next?" or "what's left to do?
Conducts investigative-grade research with primary source analysis, cross-verification, and trial-level depth. Use when an album needs factual research, source material, or verification of claims.
Runs automated tests to validate plugin integrity across 14 categories. Use before creating PRs, after making changes to skills or templates, or to verify plugin health.
Scans lyrics for explicit content and verifies that explicit flags match actual content. Use before Suno generation or release to ensure accurate content ratings.
Generate, edit, and beat-sync AI video with leading models in one workspace.
The world's fastest calendar for remote work
Transform Your Design with AI Designer by ImgCreator.ai
Revolutionizing Video Production with AI-Powered Creativity
Extend an image past the frame and let AI fill the new aspect ratio.
Discover your celebrity doppelgänger with StarByFace!
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Opus.ai: Revolutionize Your Web Experience