v2.0.0 to v3.0.0

77 added, 362 removed. Audit A to A.

What this update changes in the checks

No check changed: every fixed check gives the same answer before and after this update.

A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.

---
name: suno-prompt-architect
- description: Expert Suno AI prompt engineering for professional music creation. Use this skill when creating Suno prompts for any AI-generated music that needs commercial quality.
- version: 2.0.0
+ description: "Convert a finished creative brief and lyrics into a precise Suno Custom Mode packet: title, style, exclusions, structure/performance tags, pronunciation notes, and one controlled alternate. Use before any Suno browser generation."
+ version: 3.0.0
---
# Suno Prompt Architect
- ## Professional Music Generation with Suno AI
- This skill transforms musical intentions into precisely crafted Suno AI prompts that generate commercial-quality tracks for focus sessions, content creation, and professional use.
-
- ---
-
- ## Core Philosophy
-
- **Professional Music Production**
- Every Suno-generated track should meet commercial standards - suitable for streaming, licensing, or professional use.
-
- **Prompt Engineering as Composition**
- Writing Suno prompts is like composing a detailed arrangement. Every element matters: genre, mood, instrumentation, production quality, tempo.
-
- ---
-
- ## Suno Prompt Anatomy
-
- ### The 5-Layer Structure
-
- ```
- [FOUNDATION] + [MOOD] + [INSTRUMENTATION] + [PRODUCTION] + [USE CASE]
- ```
-
- **1. FOUNDATION (Genre/Style)**
- - Primary genre + fusion elements
- - Reference aesthetic periods or movements
- - Define rhythmic foundation
-
- **2. MOOD (Emotional Character)**
- - Core emotion (one word)
- - Secondary feeling (supporting)
- - Energy level (low/mid/high)
-
- **3. INSTRUMENTATION (Sonic Palette)**
- - Lead instruments (2-3 max)
- - Rhythmic elements
- - Atmospheric textures
- - Avoid over-specifying
-
- **4. PRODUCTION (Sonic Quality)**
- - Mix characteristics (spacious, intimate, cinematic)
- - Effects (reverb, delay, compression feel)
- - Frequency balance
- - Reference quality level
-
- **5. USE CASE (Purpose)**
- - What is this track for?
- - Listening context
- - Desired listener experience
-
- ---
-
- ## Genre Vocabulary & Fusion Patterns
-
- ### Focus & Productivity Styles
-
- **Deep Focus**
- ```
- "Ambient downtempo with steady pulse"
- "Minimal techno for sustained concentration"
- "Lo-fi electronic with subtle textures"
- ```
- - Base: Ambient, Downtempo, Minimal
- - Add: Steady, focused, non-distracting
- - Instrumentation: Synth pads, soft beats, subtle textures
- - Tempo: 60-90 BPM
-
- **High Energy**
- ```
- "Cinematic orchestral hybrid with driving energy"
- "Epic trailer music meets modern electronic"
- "Motivational orchestral with powerful builds"
- ```
- - Base: Cinematic, Orchestral, Epic
- - Add: Electronic elements, modern production
- - Instrumentation: Strings, brass, epic drums, synths
- - Tempo: 120-140 BPM
-
- **Creative Flow**
- ```
- "Lo-fi hip hop with smooth progressions"
- "Jazzy electronic with flowing groove"
- "Atmospheric trip-hop for creative work"
- ```
- - Base: Lo-fi, Jazz, Trip-hop
- - Add: Flowing, evolving elements
- - Instrumentation: Rhodes, soft beats, atmospheric pads
- - Tempo: 80-110 BPM
-
- **Relaxation**
- ```
- "Ambient soundscape with natural textures"
- "Soft electronic with gentle movement"
- "Peaceful acoustic with subtle atmosphere"
- ```
- - Base: Ambient, Acoustic, Drone
- - Add: Gentle, peaceful, spacious
- - Instrumentation: Soft synths, nature sounds, light instruments
- - Tempo: <60 BPM or free
-
- **Tech/Work**
- ```
- "Minimal techno for focused work"
- "Deep progressive house with hypnotic patterns"
- "Intelligent dance music without vocals"
- ```
- - Base: Techno, Progressive House, IDM
- - Add: Minimal, hypnotic, evolving
- - Instrumentation: Clean synths, precise drums
- - Tempo: 120-128 BPM
-
- ---
-
- ## Mood Mapping System
-
- ### Primary Moods & Musical Translation
-
- **Calm / Reflective**
- - Tempo: 60-80 BPM
- - Key: Minor modes, Dorian, Phrygian
- - Dynamics: Consistent, gentle swells
- - Space: Wide, reverberant
- - Example: "contemplative and spacious"
-
- **Energizing / Motivating**
- - Tempo: 128-145 BPM
- - Key: Major, Mixolydian
- - Dynamics: Building, crescendos
- - Space: Powerful, present
- - Example: "uplifting and determined"
-
- **Creative / Flowing**
- - Tempo: 90-110 BPM
- - Key: Major 7ths, jazz harmony
- - Dynamics: Evolving, conversational
- - Space: Balanced, intimate
- - Example: "exploratory and fluid"
-
- **Relaxing / Restorative**
- - Tempo: <60 BPM or free
- - Key: Drones, perfect 5ths
- - Dynamics: Minimal variation
- - Space: Expansive, oceanic
- - Example: "nurturing and gentle"
-
- **Focused / Concentrated**
- - Tempo: 120-128 BPM (consistent)
- - Key: Modal, minimal harmony
- - Dynamics: Stable, hypnotic
- - Space: Clear, organized
- - Example: "precise and steady"
-
- ### Emotional Gradient Words
-
- **Low Energy → High Energy**
- - Tranquil → Peaceful → Calm → Contemplative → Serene
- - Gentle → Soft → Flowing → Moving → Energetic
- - Intimate → Present → Vibrant → Powerful → Intense
-
- **Dark → Light**
- - Mysterious → Introspective → Reflective → Hopeful → Bright
- - Deep → Rich → Warm → Radiant → Luminous
-
- **Simple → Complex**
- - Minimal → Clean → Balanced → Textured → Layered
- - Spacious → Open → Full → Dense → Intricate
+ ## Input requirement
- ---
+ Do not prompt from a vague mood alone when the full workflow is requested. First establish:
+ - listener/use case;
+ - emotional start → turn → ending;
+ - song form and duration intent;
+ - lyric or instrumental status;
+ - sonic thesis and negative space.
- ## Instrumentation Vocabulary
+ If lyrics are part of the work, run `lyric-composer` first. For meditations, run `guided-meditation-composer` and prefer a separate instrumental bed.
- ### By Function
+ ## Build this exact packet
- **Melodic Leaders**
- - Piano (acoustic, electric, Rhodes)
- - Synth leads (analog, digital, modular)
- - Strings (solo violin, string ensemble, cellos)
- - Guitar (acoustic, electric, ambient)
- - Woodwinds (flute, clarinet, saxophone)
+ ### TITLE
- **Rhythmic Foundation**
- - Drums (acoustic, electronic, hybrid, hand percussion)
- - Bass (upright, electric, sub bass, synthesized)
- - Percussion (shakers, congas, tabla, frame drums)
+ Concrete, memorable, easy to pronounce. Usually 1–5 words. Avoid generic mood labels.
- **Atmospheric Textures**
- - Synth pads (ambient, evolving, swelling)
- - String pads (sustained, lush, cinematic)
- - Vocal textures (wordless, ethereal, choir)
- - Nature sounds (water, wind, birds, rain)
- - Found sounds (field recordings, environmental)
+ ### MODE
- ### Combination Patterns
+ - Custom Mode: on.
+ - Instrumental: on only for a true instrumental/meditation bed.
+ - Model: choose the newest stable model visible in UI at execution time.
- **Minimalist (2-3 elements)**
- ```
- "soft piano, ambient pads, gentle rain"
- "electric bass, minimal beats, atmospheric synth"
- "acoustic guitar, soft strings, subtle reverb"
- ```
+ ### STYLE
- **Balanced (4-5 elements)**
- ```
- "acoustic piano, soft strings, light percussion, warm bass, subtle synth"
- "electric piano, jazzy bass, brush drums, string pads, vinyl crackle"
- "ambient synths, soft beats, gentle bass, atmospheric textures, subtle voices"
- ```
+ Write one compact natural-language paragraph in priority order:
- **Rich (6+ elements)**
- ```
- "orchestral strings, epic brass, cinematic drums, soaring choir, deep bass, atmospheric pads, subtle electronics"
- "full band with drums, bass, guitars, keys, strings, and subtle electronic elements"
+ ```text
+ <genre/fusion and era attributes>; <emotional state>; <BPM/meter/pocket>; <focal instruments and negative space>; <vocal persona/delivery or no vocals>; <section dynamic journey>; <mix/spatial character>; <ending>.
```
- ---
-
- ## Production Quality Descriptors
-
- ### Mix Characteristics
-
- **Spatial Qualities**
- - Spacious, wide, panoramic, expansive
- - Intimate, close, personal, focused
- - Cavernous, cathedral-like, reverberant
- - Dry, direct, present, immediate
-
- **Frequency Balance**
- - Warm (emphasized low-mids, gentle highs)
- - Bright (present highs, clear articulation)
- - Deep (strong sub bass, foundational lows)
- - Airy (open highs, breathing room)
- - Full spectrum (balanced across all frequencies)
-
- **Production Style**
- - Pristine, crystal clear, hi-fi
- - Lo-fi, vintage, analog warmth
- - Cinematic, epic, film-quality
- - Organic, natural, unprocessed feel
- - Modern, polished, radio-ready
- - Experimental, textured, layered
-
- **Dynamic Range**
- - Compressed, consistent, even
- - Dynamic, breathing, natural
- - Building, evolving, crescendoing
- - Minimal variation, steady
-
- ---
-
- ## Tempo & Rhythm Guidance
-
- ### BPM Ranges by Use Case
-
- **Sleep & Deep Relaxation (0-60 BPM)**
- - Free-flowing, arhythmic soundscapes
- - Very slow pulse (40-60 BPM)
- - Example: "slow and drifting"
-
- **Deep Focus & Study (60-80 BPM)**
- - Gentle, consistent rhythm
- - Non-distracting pulse
- - Example: "steady and calm"
-
- **Creative Flow (80-110 BPM)**
- - Natural walking pace
- - Conversational rhythm
- - Example: "flowing and organic"
-
- **Productivity & Energy (110-128 BPM)**
- - Motivated, forward motion
- - Consistent drive
- - Example: "steady and uplifting"
-
- **High Energy & Motivation (128-150 BPM)**
- - Powerful, driving force
- - Peak performance pace
- - Example: "powerful and determined"
-
- ### Rhythmic Patterns
- - Straight (4/4, metronomic, consistent)
- - Swung (triplet feel, jazz, groove)
- - Syncopated (off-beat, complex, engaging)
- - Polyrhythmic (layered, evolving, textural)
- - Free (rubato, breathing, organic)
-
- ---
+ Use semicolons to separate layers. Prefer specific verbs and acoustic behavior over long adjective lists.
- ## Complete Prompt Examples
+ ### EXCLUDE STYLES
- ### Example 1: Deep Focus
- ```
- Ambient electronic, calm and spacious, with soft synth pads, subtle beats at 70 BPM, gentle bass, atmospheric textures, wide reverb, pristine production, for sustained concentration and deep work.
- ```
+ List only the highest-risk drift: 3–8 concise exclusions.
- ### Example 2: High Energy Motivation
- ```
- Cinematic orchestral hybrid, powerful and uplifting, with soaring strings, epic brass, thunderous drums, modern electronic elements, wide stereo field, film-quality production, building from 120 to 140 BPM with dramatic crescendo.
- ```
+ ### LYRICS / STRUCTURE
- ### Example 3: Creative Flow
- ```
- Lo-fi hip hop with smooth jazz elements, exploratory and fluid, featuring warm Rhodes piano, jazzy bass, soft brush drums, vinyl crackle, atmospheric space, intimate mix with analog warmth, steady 95 BPM with evolving textures.
- ```
+ Use clean tags and whitespace. Put performance cues in the section heading only when needed. Example:
- ### Example 4: Relaxation
- ```
- Ambient soundscape, gentle and peaceful, with soft synth drones, nature sounds, light chimes, expansive reverb, crystal clear production, for relaxation and unwinding, free-flowing and spacious.
- ```
+ ```text
+ [Intro - sparse, 4 bars]
- ### Example 5: Tech Productivity
- ```
- Minimal techno for deep focus, precise and steady, with clean analog synths, crisp electronic drums at 124 BPM, subtle bass progression, dry and organized mix, modern polished production, hypnotic and consistent.
- ```
+ [Verse 1 - close, conversational]
+ ...
- ---
+ [Pre-Chorus - rising]
+ ...
- ## Session Templates
+ [Chorus - open, harmonized]
+ ...
- ### Focus Session Pack
+ [Bridge - stripped]
+ ...
- **Track 1: "Entry Point"**
- ```
- Ambient electronic, calm and steady, with soft pads, gentle pulse at 65 BPM, atmospheric textures, spacious production, for easing into focused work.
- ```
+ [Final Chorus - full lift]
+ ...
- **Track 2: "Deep Work"**
- ```
- Minimal techno, precise and focused, with clean synths, steady beats at 120 BPM, subtle evolution, dry mix, for sustained concentration.
+ [Outro - intimate hard stop]
+ ...
```
- **Track 3: "Flow State"**
- ```
- Progressive electronic, building and evolving, with layered synths, driving rhythm, subtle builds, wide production, for peak creative output.
- ```
+ Do not add production prose between every lyric line.
- ### Creative Session Pack
+ ### PRONUNCIATION NOTES
- **Track 1: "Open Mind"**
- ```
- Ambient jazz fusion, relaxed and exploratory, with soft piano, gentle bass, brushed drums, warm production, for creative openness.
- ```
+ List only risky names, numbers, acronyms, multilingual words, or deliberate stretched vowels. Apply phonetic fixes directly in the lyrics after approval.
- **Track 2: "Ideas Flow"**
- ```
- Lo-fi electronic with organic textures, flowing and inspiring, with Rhodes, soft beats, atmospheric pads, intimate mix, for creative exploration.
- ```
+ ## Prompt checks
- **Track 3: "Momentum"**
- ```
- Uplifting electronic, energetic and forward-moving, with bright synths, driving rhythm, building energy, pristine production, for productive finishing.
- ```
+ - No named artists, bands, songs, labels, franchises, or cloned voices.
+ - No contradictory genre, tempo, vocal, or energy instructions.
+ - No impossible precision disguised as control.
+ - No more than one main vocal persona.
+ - Style and lyrics describe the same dynamic arc.
+ - Exclusions do not negate the positive prompt.
+ - The strongest words appear early.
+ - The ending is specified.
- ---
+ ## Controlled alternate
- ## Quality Checklist
+ Create an alternate only when it tests one useful variable, such as:
+ - pulse: free-time vs 72 BPM;
+ - texture: organic acoustic vs glassy electronic;
+ - vocal delivery: restrained close-mic vs open ensemble chorus.
- Before finalizing a Suno prompt, verify:
+ Keep hook, lyrics, and emotional contract fixed. State the single variable changed.
- - [ ] Clear genre/style foundation
- - [ ] Specific mood descriptors (2-3 words)
- - [ ] Instrumentation details (3-6 elements)
- - [ ] Production quality specified
- - [ ] Use case clearly stated
- - [ ] Tempo or rhythmic feel indicated
- - [ ] Avoids over-specification (let Suno be creative)
- - [ ] Reads naturally (not just keyword list)
+ ## Final delivery
- ---
+ Return:
+ 1. recommended title;
+ 2. full copy/paste STYLE field;
+ 3. EXCLUDE STYLES field;
+ 4. complete LYRICS field (or `instrumental, no vocals`);
+ 5. pronunciation notes;
+ 6. one-sentence reason this packet serves the brief;
+ 7. optional one-variable alternate.
- ## Common Pitfalls to Avoid
+ Before browser execution, write the packet into the run's `style-prompt.md` and run the taste gate.
- ❌ **Too Generic**
- "Relaxing music with piano"
- - Missing: mood depth, production, use case, specificity
+ ## Shared fundamentals and provider boundary
- ❌ **Over-Specified**
- "C major scale piano with exactly 4 chords, reverb at 2.3 seconds..."
- - Too technical, Suno can't control that detail level
+ Read the relevant modules in `https://github.com/frankxai/agentic-music-producer-os/blob/18dc9bee02001befb3a2a3bd7747b78f798dff13/docs/MUSIC-FUNDAMENTALS.md`, then `https://github.com/frankxai/agentic-music-producer-os/blob/18dc9bee02001befb3a2a3bd7747b78f798dff13/docs/PROVIDER-CAPABILITIES.md` and `https://github.com/frankxai/agentic-music-producer-os/blob/18dc9bee02001befb3a2a3bd7747b78f798dff13/docs/MUSIC-FACTORY-CONTRACT.md` when selecting tools or executing production. Canonical public source: https://github.com/frankxai/agentic-music-producer-os. The craft precedes the provider packet.
- ❌ **Contradictory Elements**
- "Energizing music for deep sleep"
- - Conflicting purposes
+ Suno v6 is the documented baseline checked 2026-10-01; capture the actual account model, settings, limits and credit cost before operating. No official public generation API was verified. Preserve the approved lyrics across adapters. Score/text analysis and a prompt review do not prove audio quality. Record real listening and measurements separately; keep unknown values null. Personal preferences and artist canon remain in their owner project.
- ❌ **Missing Purpose**
- Technically perfect prompt but no clear use case
- - Lacks direction
+ For MiniMax Music 3, translate section tags to their own lines; never share inline Suno performance tags blindly. For Eleven Music, use a prompt or a chunk plan and preserve exact approved lyric text. For Lyria, treat duration and harmony as requested direction. These are separate provider packets, not Suno endpoints.
- ---
+ Resolve `docs/...` paths from the repository root, not from the skill folder. If using only this skill outside a checkout, read the same named documents from the canonical public source.
- ## When to Use This Skill
- Activate `suno-prompt-architect` when:
- - Creating focus/productivity music
- - Designing background tracks for content
- - Building playlists for different activities
- - Generating music for courses or products
- - Need professional-quality Suno prompts
+ ## Current craft and production integration
- This skill ensures every Suno-generated track meets professional standards for its intended purpose.
+ Checked 2026-10-01. Use the public [music fundamentals](https://github.com/frankxai/agentic-music-producer-os/blob/18dc9bee02001befb3a2a3bd7747b78f798dff13/docs/MUSIC-FUNDAMENTALS.md), [provider register](https://github.com/frankxai/agentic-music-producer-os/blob/18dc9bee02001befb3a2a3bd7747b78f798dff13/docs/PROVIDER-CAPABILITIES.md) and [factory contract](https://github.com/frankxai/agentic-music-producer-os/blob/18dc9bee02001befb3a2a3bd7747b78f798dff13/docs/MUSIC-FACTORY-CONTRACT.md). They cover harmony/voice leading, groove, motif, prosody, hooks, form, vocals, arrangement, low end, mixing, measured delivery, provenance and durable jobs. Load only the modules needed for this task.
- ---
+ Keep local artist/persona canon, identity, preferences and account entitlements scoped to this project. Shared craft does not assign a singer or overwrite canon. Select the current account-visible Suno model (documented baseline v6); no official public Suno generation API was verified. Lyria, Eleven Music and fal MiniMax Music 3 have separate documented API routes and constraints. A skill or MCP tool is not a connected generation account.
- **Skill Version:** 2.0.0
- **Last Updated:** January 24, 2026
- **Optimized For:** Suno AI v4.5+
+ Preserve approved lyrics across adapters. Prepare, authorize/reserve, submit, reconcile, archive, listen, measure, attest rights and stage release separately. Bind receipts to exact contract/asset hashes. Never infer audio quality, measured BPM, playback, rights or publication from a text review or completed job. Unknown paid submissions remain held for reconciliation; no blind rerender.