A comprehensive Claude Code plugin for creating professional, production-ready music prompts for Suno AI. This plugin transforms music creation from guesswork into a systematic, research-driven process that produces reliable, high-quality results through automated web research and intelligent sub-agents.
Suno Song Creator guides you through the entire music prompt creation workflow:
- Interactive questioning to understand your vision
- Automated artist/song research via song-researcher sub-agent (NEW in v1.1.0)
- Web pattern extraction from Genius, HookTheory, Spotify (NEW in v1.1.0)
- Structured prompt building within 1000 character limit
- Model and parameter selection based on genre
- Professional lyric writing with meta tags
- Copyright-safe style descriptions (no artist/album/song names)
- AI-slop avoidance for authentic, human-centered lyrics
- Independent quality review via quality-reviewer sub-agent
- Automatic file export to organized project directories
- 🚀 Chrome automation to upload directly to Suno (NEW in v2.0.0)
- Understand the Vision - Interactive questioning to gather genre, mood, vocals, constraints
- Research (AUTOMATED) - When artist mentioned, automatically launch song-researcher sub-agent for pattern analysis
- Select Model & Parameters - Choose optimal Suno model (v4, v4.5, v4.5+, v5)
- Build Structured Prompt - Genre, vocal, instrumentation, production, mood (within 1000 char limit)
- Configure Advanced Parameters - MAX Mode, weirdness, style influence, exclusions
- Write Effective Lyrics - Meta tags, syllable control, AI-slop avoidance
- Apply Realism & Genre Techniques - Genre-specific strategies
- Quality Review (OPTIONAL) - Launch quality-reviewer sub-agent for professional assessment
- Upload to Suno (OPTIONAL) - Automated Chrome-based upload to suno.com (NEW in v2.0.0)
- Save to File - Organized project-based export with all metadata
- Acoustic/Folk: Realism descriptors, MAX Mode, proximity effect
- Electronic/EDM: Synthesis control, anti-sawtooth strategies, sidechain techniques
- Rock/Alternative: Managing pop gravity wells, raw production, 90s aesthetics
- Pop: Vocal production, modern polish, radio-ready sound
- And more: Hip-hop, country, jazz, experimental
Song-Researcher Sub-Agent automatically analyzes artist styles when you mention them:
Automated Web Research:
- Genius.com: Fetches lyrics, analyzes structure, extracts annotations
- HookTheory.com: Searches chord progressions, harmonic patterns
- Spotify/Music Sites: Identifies genre tags, similar artists, production context
Pattern Extraction:
- Syllable counts per line (verses, chorus, bridge)
- Rhyme scheme analysis (AABB, ABAB, ABCB, etc.)
- Song structure patterns (lines per section, repetition)
- Metaphor usage and thematic elements
- Emotional arc progression
- Characteristic vocabulary and tone
- Production cues (instruments, recording style)
Multi-Song Analysis:
- When specific song mentioned: Deep analysis of that song + 2-3 context songs
- When artist only: Analyzes 3-4 representative tracks
- Synthesizes patterns: artist signature vs. song-specific variations
Confidence Scoring:
- 90-100% (Comprehensive): All sources, multiple songs
- 70-89% (Good): 2/3 sources, solid patterns
- 50-69% (Basic): Limited data, proceed cautiously
- <50% (Insufficient): Manual research recommended
Structured Output: Returns actionable recommendations ready for Suno prompt building:
- Genre descriptors
- Vocal style characteristics
- Lyrical structure patterns
- Production notes
- Research limitations (missing data noted)
Complete End-to-End Automation - Upload your prompts to suno.com with zero manual intervention:
Automated Upload Features:
- Parses prompt.md files - Extracts title, lyrics, styles, model, and all parameters
- Navigates to Suno automatically - Opens suno.com/create and switches to Custom mode
- Fills ALL form fields - Including complex React slider components (weirdness, style influence)
- Slider automation working - Uses coordinate-based dragging for precise control
- Submits and monitors - Clicks Create button and tracks generation
- Returns song URLs - Provides direct links to your generated songs
How It Works:
- After creating a prompt with the suno-song-creator skill, you'll be asked if you want to upload
- If yes, the suno-upload skill automatically:
- Reads your saved prompt.md file
- Opens Chrome and navigates to suno.com/create
- Fills in lyrics (with meta tags preserved, divider line removed)
- Sets the structured prompt in the Styles field
- Selects the correct model (v5, v4.5, etc.)
- Sets sliders to exact percentages (weirdness, style influence)
- Clicks vocal gender button (Female/Male)
- Adds excluded styles (Rock, Metal, etc.)
- Shows you a preview for final confirmation
- Clicks Create and returns your song URLs
Technical Achievement:
- Solved React slider interaction with coordinate-based dragging using
getBoundingClientRect() - Handles all Suno form types: text inputs, dropdowns, buttons, custom sliders
- Validated with successful song generation and parameter accuracy within ±1%
Requirements:
- Chrome MCP server (browser automation)
- Suno account with available credits
Standalone Usage:
/suno-uploadCan upload any properly formatted prompt.md file, even if not created with this plugin
Comprehensive guidance to avoid generic AI lyric clichés:
- Overused technology words (neon, static, wire, circuits)
- Generic abstractions (echoes, shadows, void, broken)
- Ghost in the Machine themes
- Provides concrete, human-centered alternatives
- Self-review checklists for authenticity
Two specialized sub-agents provide automated analysis with independent context:
- Purpose: Automated artist/song pattern analysis
- Tools: WebFetch, WebSearch, Read, Grep
- Triggers: When you mention an artist in your request
- Process:
- Fetches data from Genius, HookTheory, Spotify
- Extracts lyrical patterns (syllables, rhyme, structure)
- Analyzes 1-4 songs depending on specificity
- Synthesizes artist signature vs. song-specific patterns
- Returns structured report with recommendations
- Independence: No shared context - evaluates objectively
- Output: Actionable recommendations for prompt sections
- Purpose: Professional quality assessment of prompts/lyrics
- Tools: Read, Grep
- Triggers: Optionally at Step 8, or via
/review-song - Process:
- Evaluates prompt structure, specificity, copyright safety
- Detects AI-slop, clichés, poor quality lines
- Analyzes syllable patterns, rhyme schemes, metaphors
- Checks style-lyric consistency, gender-pronoun clarity
- Rates overall quality (X/10)
- Independence: No shared context - unbiased assessment
- Output: Categorized recommendations (CRITICAL/SUGGESTED/OPTIONAL)
This plugin includes standalone skills for independent usage:
- Upload any prompt.md file to suno.com with full automation
- Handles all form fields including sliders
- No human intervention required (except final confirmation)
- Usage:
/suno-upload(finds prompt.md in current directory) - Works with prompts created anywhere, not just this plugin
- Returns song URLs after generation starts
- Review existing Suno prompts before submission
- Launch quality-reviewer sub-agent without creating new song
- Usage:
/review-song path/to/prompt.mdor/review-song(paste content) - Get professional feedback on prompts created anywhere
- Research artist styles independently before song creation
- Launch song-researcher sub-agent for pattern exploration
- Usage:
/research-artist Phoebe Bridgersor/research-artist Sabrina Carpenter - Manchild - Explore multiple artists to compare styles
- Save research for later reference
Ensures Suno accepts your prompts by avoiding:
- Artist names (Taylor Swift, Radiohead, etc.)
- Band names (Foo Fighters, The Beatles, etc.)
- Producer names (Rick Rubin, Max Martin, etc.)
- Album/song titles
Instead, uses:
- Genre + era + descriptors
- Scene/movement + geography
- Technical + emotional characteristics
- Time period anchoring
Saves complete prompts to organized directories:
project-name/
└── song-title-slug/
└── prompt.md
Includes: model configuration, structured prompt, lyrics, research notes
/plugin install https://github.com/nwp/suno-song-creator-plugin- Clone this repository:
git clone https://github.com/nwp/suno-song-creator-plugin.git
cd suno-song-creator-plugin- Install in Claude Code:
cc --plugin-dir /path/to/suno-song-creator-pluginOr copy to your local plugins directory:
cp -r suno-song-creator-plugin ~/.claude/plugins/Main Skill - Complete Song Creation:
Create a Suno prompt for a melancholic indie folk song
Help me write a Suno song like Phoebe Bridgers
Generate a dark electronic track with 80s synth vibes
Standalone Skills:
/suno-upload
Automatically uploads prompt.md to Suno with full form automation
/research-artist Phoebe Bridgers
Researches artist patterns independently for later use
/research-artist Sabrina Carpenter - Manchild
Deep analysis of specific song + artist context
/review-song path/to/prompt.md
Independent quality review of existing prompt
The skill will guide you through:
- Clarifying questions about genre, mood, vocals, constraints
- Artist research if you mention specific artists
- Model selection based on your genre and quality needs
- Prompt building with proper structure and formatting
- Lyric creation with meta tags and authenticity checks
- Optional upload to Suno via Chrome automation
- File export to your project directory
You: I want a sad song like Phoebe Bridgers' Motion Sickness
Claude: I'll research Phoebe Bridgers' "Motion Sickness" to understand the style...
[Automatically launches song-researcher sub-agent]
Song-Researcher: [Fetches lyrics from Genius for "Motion Sickness"]
[Analyzes "Scott Street" and "Kyoto" for artist context]
[Searches HookTheory for chord progressions]
[Gathers genre tags from Spotify]
[Extracts patterns: syllables, rhyme, metaphors, tone]
[Returns structured research report]
Claude: Research complete! Analyzed "Motion Sickness" + 2 context songs.
Confidence Score: 85% (Good)
Key findings:
- Syllables: 8-10 per line in verses, 6-9 in chorus
- Rhyme: Loose ABCB, prefers slant rhymes
- Metaphors: Concrete imagery (car crashes, specific places)
- Tone: Confessional, intimate, lo-fi aesthetic
Based on research, I'll create an indie folk prompt with:
- Intimate, confessional lyrics following analyzed patterns
- Soft female alto vocals with whisper-to-belt delivery
- Lo-fi bedroom pop production
- Melancholic mood with vulnerable-to-defiant arc
[Creates complete structured prompt with copyright-safe descriptors]
[Writes original lyrics avoiding AI clichés using researched patterns]
[Optionally launches quality-reviewer for assessment]
Claude: Would you like me to upload this song to Suno now using Chrome automation?
You: Yes
Claude: [Launches suno-upload skill]
[Opens Chrome, navigates to suno.com/create]
[Fills all form fields: lyrics, styles, model v5, sliders at 40%/60%]
[Shows preview for confirmation]
Ready to create on Suno. Submit?
You: Yes
Claude: [Clicks Create button]
[Monitors generation]
✅ Song submitted to Suno!
Generation started for "Fixer-Upper"
URLs:
- https://suno.com/song/abc123...
- https://suno.com/song/def456...
[Also saves prompt to organized project directory]
No configuration required! The skill works out of the box.
For Chrome automation (suno-upload):
- Requires Chrome MCP server to be installed and running
- Requires Suno account with available credits
- If Chrome MCP not available, manual upload instructions will be provided
Optional: Customize project organization by specifying project names in your requests:
Create a song for my "Summer Vibes" album
The skill helps you choose the right model:
| Model | Best For | Strengths | Limitations |
|---|---|---|---|
| v5 | Acoustic, pop, vocals-first | Cleanest audio, natural vocals | Adds intro vocals, conservative |
| v4.5 | Heavy genres, reliable results | Workhorse, consistent | May mangle lyrics |
| v4.5+ | Creative experimentation | Interesting surprises | Unstable, random elements |
| v4 | Intentional chaos | Unpredictable brilliance | Poor adherence, outdated |
Suno uses co-occurrence patterns ("genre clouds") where related genres are linked. Example: Rock has 315 billion links to pop, creating a gravity well. The skill teaches strategies to escape these gravity wells.
Uses colon-and-quotes format for maximum clarity:
genre: "indie folk rock, 2020s bedroom pop aesthetic"
vocal: "soft female alto, intimate delivery"
instrumentation: "fingerpicked acoustic guitar, warm bass"
production: "lo-fi intimacy, tape warmth"
mood: "melancholic, nostalgic"
Inline lyrics formatting for section control:
[Verse 1 | intimate delivery | sparse instrumentation]
Lyrics here
[Chorus | anthemic | full production]
Chorus lyrics here
Technical recording engineer language for acoustic music:
- Proximity effect
- Room tone
- Single-mic capture
- Natural dynamics
suno-song-creator-plugin/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
└── skills/
├── suno-song-creator/
│ ├── SKILL.md # Main skill (v1.1.0)
│ ├── agents/ # Sub-agents for specialized tasks
│ │ ├── quality-reviewer.md # Quality assessment agent
│ │ └── song-researcher.md # Artist/song research agent
│ ├── skills/ # Additional standalone skills
│ │ ├── review-song/ # Independent quality review
│ │ │ └── SKILL.md
│ │ └── research-artist/ # Independent artist research
│ │ └── SKILL.md
│ ├── references/ # Reference documentation
│ │ ├── genre-clouds.md
│ │ ├── meta-tags-reference.md
│ │ ├── realism-descriptors.md
│ │ ├── model-comparison.md
│ │ └── artist-research-guide.md
│ ├── examples/ # Working prompt examples
│ │ ├── acoustic-folk-prompt.md
│ │ ├── electronic-edm-prompt.md
│ │ └── rock-alternative-prompt.md
│ └── utils/ # Utility templates
│ ├── quality-review-prompt.md
│ └── research-report-template.md (future)
└── suno-upload/ # Chrome automation upload (NEW in v2.0.0)
└── SKILL.md # Automated Suno upload skill
The skill includes comprehensive reference documentation:
- genre-clouds.md - Understanding genre co-occurrence patterns
- meta-tags-reference.md - Complete catalog of Suno meta tags
- realism-descriptors.md - Technical vocabulary for acoustic production
- model-comparison.md - Detailed Suno model comparison
- artist-research-guide.md - How to research artists effectively (used by song-researcher agent)
The skill includes three complete working examples:
- acoustic-folk-prompt.md - Indie folk/singer-songwriter
- electronic-edm-prompt.md - Dark synthwave/EDM
- rock-alternative-prompt.md - Alternative rock/grunge
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch (
git checkout -b feature/improvement) - Make your changes
- Test thoroughly with Claude Code
- Submit a pull request
- Additional genre examples (metal, jazz, classical, etc.)
- More artist research patterns
- Enhanced meta tag documentation
- Translations to other languages
- 2.0.0 - Added complete Chrome automation for Suno uploads
- NEW:
/suno-uploadskill - Automated upload to suno.com with zero manual intervention - Parses prompt.md files (YAML, lyrics, structured prompts, parameters)
- Navigates to suno.com/create automatically, switches to Custom mode
- Fills ALL form fields: lyrics, styles, title, model selection
- Slider automation achieved - Coordinate-based dragging for weirdness/style influence sliders
- Handles React components using getBoundingClientRect() + left_click_drag
- Removes divider line (
///*****///) from lyrics while preserving meta tags - Sets vocal gender, exclude styles, and all advanced parameters
- User confirmation before submission
- Returns song URLs after generation starts
- Validated with successful song generation (±1% slider accuracy)
- Updated suno-song-creator to v1.1.0 with Step 9: Optional Upload to Suno
- NEW:
- 1.1.0 - Added automated artist/song research via song-researcher sub-agent
- Automated web fetching from Genius, HookTheory, Spotify
- Pattern extraction (syllables, rhyme, structure, metaphors)
- Multi-song synthesis (specific song + context songs)
- Confidence scoring and structured reports
- New
/research-artiststandalone skill for independent research - Updated workflow to 10 steps with automated research in Step 2
- 1.0.0 - Added quality-reviewer sub-agent for independent quality assessment
- Professional prompt/lyric review via
/review-songskill - AI-slop detection, cliché detection, poor quality line identification
- Syllable pattern, rhyme scheme, metaphor consistency analysis
- Style-lyric fit and gender-pronoun consistency checks
- Categorized recommendations (CRITICAL/SUGGESTED/OPTIONAL)
- Professional prompt/lyric review via
- 0.6.0 - Added 1000 character limit guidance with optimization strategies
- 0.5.0 - Added copyright-safe style descriptions
- 0.4.0 - Added AI-slop avoidance guidance
- 0.3.0 - Added automatic file export
- 0.2.0 - Added interactive questioning and artist research
- 0.1.0 - Initial release
MIT License - see LICENSE file for details
Based on "The Complete Guide to Mastering Suno: Advanced Strategies for Professional Music Generation" - A comprehensive guide to understanding Suno's probabilistic nature, genre clouds, advanced prompting strategies, and production techniques.
For issues, questions, or suggestions:
- Open an issue on GitHub
- Contributions and feedback welcome!
- Suno AI - The AI music generation platform
- Claude Code - AI coding assistant
- Genius.com - Lyric analysis
- HookTheory.com - Music theory analysis
- LyricSoul - LLM Lyric Benchmark
- N8+GR8 - My Suno profile
Made with ❤️ for the Suno community