Suno

This skill stores all persistent data under ~/Clawic/data/suno/ (config, preferences, project tracking, downloaded audio — see setup.md on first use, memory-template.md for the memory format). If you have data at an old location (~/suno/ or ~/clawic/suno/), move it to ~/Clawic/data/suno/.

Configuration

User-dependent variables. Defaults apply until the user states a preference; store them in ~/Clawic/data/suno/config.yaml.

Preference areas to record as the user reveals them:

• taste — go-to genres, moods, vocal textures, eras; steers first-draft prompts (stated preference → config; observed reactions → memory.md)
• workflow — present-and-pick vs auto-download both clips; how many rerolls before checking in
• spend posture — confirm before multi-extend builds or runs beyond a credit threshold
• conventions — song/file naming, project folder layout under ~/Clawic/data/suno/
• delivery — where finished audio lands, whether stems are fetched by default

When To Use

• Generating a song, jingle, theme, intro, or background track with Suno
• Turning existing lyrics into audio, or writing lyrics meant to be sung
• Crafting style prompts, tags, or structured lyrics for manual pasting into suno.com
• Building long tracks, covers, personas, stems, or preparing a commercial release
• Diagnosing bad output: generic sound, off-genre, garbled vocals, cut-off endings, moderation rejections
• Not for editing or mixing existing audio files — use audio or ffmpeg

Quick Reference

Depth on demand: debug.md symptom→cause chains · prompts.md style prompt craft · styles.md tag vocabulary · lyrics.md structure, delivery, word budget · extend.md long tracks, crop, stitch · covers.md covers, personas, uploads · jingles.md functional audio briefs · release.md downloads, stems, rights · api.md hosted APIs · browser.md suno.com automation · setup.md first run · memory-template.md memory format.

Core Rules

1. Style field describes; lyrics field gets sung. Genre words typed into the lyrics box become sung words ("upbeat pop song" turns into the opening line). Sound goes in the style field, words in the lyrics field, structure in [bracketed] tags on their own lines.

2. Each generation is sampling, not drafting. One run returns two clips from the same prompt — two rolls, not a draft and a revision. When a roll lands, save its exact style string to memory.md and reuse it verbatim; rewording a working prompt resets the odds.

3. Pick the method by situation.

   Situation	Method
   Deliver audio files programmatically	Hosted API (api.md)
   No API key, browser tool available	Automate suno.com (browser.md)
   User will paste into suno.com themselves	Craft prompt + lyrics only
   Unclear (default)	default_method from config; if audio delivery is requested and neither key nor browser exists, ask once and record the answer

4. Force endings. Clips without an ending cue stop mid-phrase. Close the lyrics with an [Outro] section and [End] as the final tag; for instrumentals, [Fade Out] then [End].

5. Long songs are built, not one-shotted. Generate the strongest opening clip, extend from the last good timestamp (not the raw end), repeat until [End], stitch with Get Whole Song. Target 2-4 minutes; Suno >=3.5 generates 4-minute clips and >=4.5 allows 8-minute songs, but one-shot epics drift in melody and mix. Full workflow and segment planning: extend.md.

6. Translate artist names into attributes. Moderation rejects or strips artist and brand names — and the credits are still spent. Convert with three knobs: voice texture + era + production. "Like Springsteen" → "raspy heartland rock male vocals, 80s arena production, driving piano and saxophone".

7. API pattern: generate → poll every 5 seconds → download immediately. Audio URLs expire; generation runs 30-90 seconds. Working code in api.md.

Prompt Essentials

Layered formula (full guide: prompts.md, vocabulary: styles.md):

[genre] [subgenre] [mood] [tempo] [instruments] [vocals] [era/influence]

Example: "indie folk melancholic slow acoustic guitar soft female vocals 90s"

• Front-load: earlier terms steer harder in practice — genre first, garnish last.
• Specificity beats quantity: "shoegaze" outsteers "rock, reverb, dreamy, atmospheric".
• Stay within 8-12 style terms (canonical limits: styles.md).
• Instrumental: set the instrumental toggle AND leave the lyrics box empty; stray text gets sung.

Output Gates

Before submitting any generation, check:

• No artist, band, or brand names in prompt or lyrics?
• Everything that should not be sung is inside [brackets] on its own line?
• Ending cue present ([End] last) for a standalone song?
• Style terms 8-12, no contradictions (lo-fi + polished, happy + mournful)?
• Instrumental toggle matches the request — and lyrics box empty if instrumental?
• Song over 4 minutes → full lyrics written and segment plan made before the first run (extend.md)?
• Commercial deliverable → user confirmed a paid Suno plan at generation time (release.md)?

Traps

Where Experts Disagree

• Tags vs natural-language prose. Suno >=4.5 handles prose descriptions as well as comma tags; prose reads better, tags are more reproducible and easier to mutate one term at a time. Default: tags; prose when a mood is easier to describe than to enumerate. Reproducibility needs (albums, clients) → tags.
• Write lyrics vs let Suno generate them. Generated lyrics are serviceable but generic — competent rhymes, no specifics. Anything with an emotional stake or a client → write them (lyrics.md); throwaway background tracks → generated is fine.
• One-shot vs extend-built long songs. >=4.5 can one-shot 8 minutes; drift risk rises with length. Boundary: past ~4 minutes, or when any section must be exactly right, build by extending (rule 5).

Security & Privacy

Data storage. This skill creates ~/Clawic/data/suno/ on first use:

• config.yaml — Declared preferences (variables above)
• memory file — Observed preferences, successful prompts
• projects folder — Per-project tracking
• songs folder — Downloaded audio (optional)

All data stays local. API keys live in environment variables, never in files.

This skill does:

• Generate music via hosted APIs (requires API key from provider)
• Navigate suno.com with browser automation
• Craft optimized prompts for Suno's model
• Write lyrics with proper structure tags
• Track projects and successful patterns locally

This skill does NOT:

• Store API keys in plain text files
• Access files outside ~/Clawic/data/suno/
• Make requests without user direction

External endpoints. When using hosted APIs, requests go to:

API keys authenticate requests; prompts and lyrics are sent for processing.

Guardrails. By using this skill with APIs, prompts and lyrics are sent to third-party services for music generation. Only use services you trust with your creative content.

Related Skills

More Clawic skills, get them at https://clawic.com/skills/suno (install if the user confirms):

• audio — Audio processing and editing
• video — Combine music with video content
• ffmpeg — Audio format conversion, cropping, cross-fades

Feedback

• If useful, star it: https://clawic.com/skills/suno
• Latest version: https://clawic.com/skills/suno

Part of Clawic, the verified skill library. Get this skill: https://clawic.com/skills/suno.