suno-engineer
Constructs technical Suno style prompts for the current model family (v6, v6-wild, v6-mini), selects models and generation settings, and optimizes prompts
Install / Use
npx skills add bitwize-music-studio/claude-ai-music-skills --skill suno-engineerInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Our assessment of suno-engineer
suno-engineer scores 92/100 on our quality scale, 73rd of 328 Other skills we index (top 23%).
Its SKILL.md is 22 KB long, well organised into 45 sections with 4 code examples: a thorough specification that gives an agent plenty to work with.
It has 512 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so suno-engineer is actively maintained.
- Our last check on 2026-11-18 found the source still online.
- It is released under the CC0-1.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit โ read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-05. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk โ read a skill before letting an agent act on it.
suno-engineer compared with similar skills
All 4 of these similar skills score higher than suno-engineer; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| suno-engineer (this skill)by bitwize-music-studio | 92 | 512 | 56d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 113.0k | 10d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 86.4k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install suno-engineer?
- Run
npx skills add bitwize-music-studio/claude-ai-music-skills --skill suno-engineer. The install tabs above show the steps for each supported agent. - Which AI agents does suno-engineer work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is suno-engineer safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is CC0-1.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is suno-engineer still maintained?
- The repository was last updated about 2 months ago, so suno-engineer is actively maintained.
Skill content
View source on GitHubname: suno-engineer description: Constructs technical Suno style prompts for the current model family (v6, v6-wild, v6-mini), selects models and generation settings, and optimizes prompts. Use when creating or refining Suno prompts for track generation. argument-hint: <track-file-path or "create prompt for [concept]"> model: opus effort: max prerequisites:
- lyric-writer allowed-tools:
- Read
- Edit
- Write
- Grep
- Glob
- Bash
- bitwize-music-mcp
Your Task
Input: $ARGUMENTS
When invoked with a track file:
- Read the track file
- Check if instrumental: Look for
instrumental: truein frontmatter or**Instrumental** | Yesin Track Details - 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. - Construct the style prompt and fill the Generation Settings table (model, Variety, Max Mode โ see ยง Generation Settings)
- Update the track file's Suno Inputs section
For instrumental tracks (no lyric-writer prerequisite):
- Set
Instrumental: Onin 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:
- Design complete Suno prompting strategy
- Provide style prompt, structure tags, and recommended settings
Supporting Files
- 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; full detail: 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.mdfor 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
- 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. - If found: read and incorporate preferences
- If not found: use base Suno knowledge only
Override File Format
{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: v6
- Variety: Off
- Always include: atmospheric, moody
## Avoid
- Never use: happy, upbeat, cheerful
- Avoid genres: country, bluegrass, folk
How to Use Override
- Load at invocation start
- Check for genre mappings when generating style prompts
- Apply default settings and avoidance rules
- 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:
[Intro],[Verse],[Chorus]- these are section TAGS, not sung- Actual words you want sung
For instrumental sections, use:
[Instrumental]or[Break]- section tag only, no parentheticals[Guitar Solo]or[Drum Break]- descriptive section tags
Lyrics Box Format
[Intro]
[Verse]
First line of lyrics here
Second line of lyrics here
[Chorus]
Chorus lyrics here
[Instrumental]
[Outro]
Rules:
- Use section tags for every section
- Section tags only for instrumental parts (no parentheticals โ Suno sings them)
- Clean lyrics only (no vocalist names, no extra instructions)
- Phonetic spelling for pronunciation issues
Style Prompt (Style of Music Box)
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 Suno 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/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.)
Exclude Styles (Negative Prompting)
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:
- Pro/Premier โ Suno's dedicated Exclude Styles field (Custom Mode โ Advanced Options). The reliable path.
- Inline
no [element]in the Style Box does not work on v6 โ a launch-week test saw "no drums" ignored (The Verge). Use the Exclude Styles field; on a plan without it, restructure the prompt to not imply the element instead.
Rules:
- Max 2โ4 items โ over-specification dilutes the effect
- Bare elements, never "no":
drums,electric guitar,autotune. The field is the negation;no drumsin it is redundant at best, and if the value ever lands in the Style Box it asks for drums - Suppressing unwanted group vocals (a common Suno over-add):
choir,crowd vocals,backing vocals,gang vocals,call-and-response,vocal harmonies,layered vocalsโ still probabilistic; pair with a leaner style prompt - Always record them in the track file's Exclude Styles section, even when none apply โ write
### Exclude Stylesfollowed 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:
- Acoustic folk โ
electric instruments, drums - A cappella โ
instruments - Lo-fi chill โ
aggressive vocals
Only add exclusions when there is a clear reason.
See ${CLAUDE_PLUGIN_ROOT}/reference/suno/best-practices.md ยง Negative Prompting for full details.
Generation Settings
Fill the track's ### Generation Settings table (Advanced Mode โ More Options). Defaults are in templates/track.md; the catalog is ${CLAUDE_PLUGIN_ROOT}/reference/suno/models.md.
| Setting | Rule |
|---|---|
| Model | v6 for finished tracks. v6-wild for a first pass on an undecided sound, or on the genres where v6 is reported weak or generic โ grunge, metal, alt-country, synth-pop, and any rock or era-soul vocal that keeps drifting to a stock timbre (in a seven-genre A/B, wild won on character in indie rock, R&B/soul and metal; v6 won fidelity everywhere). Then Cover the keeper on v6 โ two Generation Log rows โ but treat that step as experimental: nobody has shown a Cover that keeps wild's character. Custom: <name> for album-wide consistency. v6-mini only on a Free account (its output is not releasable). |
| Variety | Off, always, when the Style Box was engineered. Normal (the default on v6/v6-mini) lets Suno rewrite the box. State the reason in Production Notes if you ever raise it. |
| Max Mode | On for tracks over ~2:00, any Cover, any Voice (Suno's recommendation; 20 credits instead of 10). Off for short ideas and sketches. Untested on v6-wild โ log the result if you try it. |
| Vocal Gender | From the track's vocal description; โ when a Voice or Custom Model supplies the voice. |
| Duration | Auto unless the track or album sets a Target Duration; Custom accepts 10 sโ6:00 and hard-cuts at the value, so the lyric load must fit. |
| Weirdness / Style Influence | 50 / 50 unless a genre range in creative-sliders.md says otherwise. Style Influence at 50 discards half the prompt's authority โ raise it before blaming the prompt. |
| Audio Influence | Only with attached audio (Cover / Voice): ~0.70โ0.85 for a Voice; see the Cover / Voice Setup block
Truncated for display โ read the full file on GitHub.
Related Skills
Agent-Reach
113.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu โ one CLI, zero API fees.
hyperframes
86.4kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.0k๐ The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.1kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit โ see the Safety scan above for what the skill file itself contains.
