Skills Guide

Suno AI Music Generation

VerifiedSafe

Generate music using Suno AI's API. Supports custom lyrics, instrumental-only, and style tags. Useful when users want to create songs, melodies, or tracks programmatically.

Download and use
Sby Skills Guide Bot
ContentIntermediate
6/2/2026
Claude Code
#music-generation#ai-songs#custom-lyrics#instrumental

Recommended for

Claude CodeUI/UX designerSEO & contentProduct managerWriter / marketerSolo / indie hacker

Automated summary

Generates music via the Suno AI API from textual descriptions, custom lyrics, or specific style tags.

Strengths

  • Quick generation of original songs from a simple description
  • Supports custom lyrics and instrumental-only tracks
  • Style tags (genre, voice, mood) to refine the output
  • Free tier available with 50 credits per day

Limitations

  • Authentication token expires every hour and must be manually refreshed
  • Limited number of songs per day (5 on free plan)
  • No fine-grained control over mixing or mastering
When to use it

When you need a quick draft or demo of a song, background music, or jingle with a specific mood or lyrics.

When not to use it

For professional music production requiring precise mixing, mastering, or long-term iterative composition, or when reliable offline generation is needed.

Security analysis

Safe
Quality score90/100

The skill uses a Bash command to invoke a local Python script that interacts with Suno AI's API using a session cookie obtained manually by the user. There are no destructive commands, exfiltration, or obfuscation. The token handling is entirely local and standard for API usage. No elevated risk beyond normal API interaction.

No concerns found

How this analysis is made

Examples

Generate a pop song with custom lyrics
Create a pop song with the following lyrics about summer: 'Sun is high, sky is blue, feeling like there's nothing we can't do' – make it upbeat and include a female voice.
Generate an instrumental track
Generate an instrumental electronic track that sounds futuristic and energetic, suitable for a tech product launch.
Generate a song from description only
Make a song that sounds like a melancholic indie folk ballad, with male vocals and acoustic guitar.

name: suno-music description: Generate music using AI. Use when the user asks to create, generate, or make music, songs, audio, melodies, tracks, or beats. Supports custom lyrics, instrumental-only, and style tags. allowed-tools: Bash, Read, Write

Suno Music - AI Music Generation

Generate music using Suno AI's API.

Setup (One-Time)

  1. Sign in to suno.ai
  2. Open browser DevTools (F12) → Console tab
  3. Run: document.cookie
  4. Find the __session=eyJ... part (it's a long JWT token)
  5. Export it: export SUNO_COOKIE="__session=eyJ..."

Note: The __session token expires after ~1 hour. You'll need to refresh it periodically.

Usage

Run the generation script:

python3 ~/.claude/skills/suno-music/generate_music.py "your prompt here" [options]

Options

| Option | Description | Default | |--------|-------------|---------| | --custom | Treat prompt as lyrics (not description) | False | | --tags | Style/voice tags (e.g., "female voice, pop, upbeat") | None | | --title | Song title | None | | --instrumental | Generate instrumental only (no vocals) | False | | --output | Output directory path | ./generated_music | | --model | Model key (e.g., chirp-auk-turbo) | Default free model |

Examples

Generate from description

python3 ~/.claude/skills/suno-music/generate_music.py "an upbeat electronic track for a tech product demo"

Custom lyrics with style

python3 ~/.claude/skills/suno-music/generate_music.py "[Verse 1]
Walking through the morning light
Everything feels just right" --custom --tags "indie folk, acoustic guitar, male voice" --title "Morning Light"

Instrumental track

python3 ~/.claude/skills/suno-music/generate_music.py "epic orchestral trailer music with building tension" --instrumental

Output

Songs are saved with format: {timestamp}_{sanitized_title}_{n}.mp3

Example: 20260106_morning_light_1.mp3

Suno generates 2 variations per request by default.

Credits

  • Free tier: 50 credits/day (renews daily)
  • Each generation uses 10 credits (5 per song × 2 variations)
  • So you can generate 5 songs per day on the free tier

Check remaining credits:

python3 ~/.claude/skills/suno-music/generate_music.py --credits

Models

| Model | Key | Notes | |-------|-----|-------| | v4.5-all | chirp-auk-turbo | Best free model (default) | | v5 | chirp-crow | Pro only, beta | | v4.5+ | chirp-bluejay | Pro only | | v4 | chirp-v4 | Pro only |

Requirements

  • Python 3.x
  • requests library (usually pre-installed)
  • SUNO_COOKIE environment variable with __session token

Troubleshooting

"API Error: 401" - Token expired. Get a fresh __session token from the browser.

"API Error: 402" - Out of credits. Wait for daily refresh or upgrade.

From the file to a first result

The download contains exactly the content displayed on this page. This copy may differ from the latest version in the source repository.

View the source and supporting files

This download contains SKILL.md only. Any scripts, references, templates and dependencies are not included. Get the required files from the source, preserving their directory structure, before continuing.

1. Download the file

Download SKILL.md

From the root of a test project, save the file as .skill-downloads/suno-ai-music-generation-mmk3nhjc/SKILL.md, or use the command below. This folder is for inspecting the skill before installation.

Command for macOS/Linux or WSL: requires a POSIX shell and curl. On Windows without WSL, use the download button and create the folder manually.

mkdir -p '.skill-downloads/suno-ai-music-generation-mmk3nhjc' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/suno-ai-music-generation-mmk3nhjc/download' --output '.skill-downloads/suno-ai-music-generation-mmk3nhjc/SKILL.md.part' && mv '.skill-downloads/suno-ai-music-generation-mmk3nhjc/SKILL.md.part' '.skill-downloads/suno-ai-music-generation-mmk3nhjc/SKILL.md'

2. Check prerequisites

Read SKILL.md before using it. If it references scripts or external services, inspect them and prepare the required access in your test environment.

Tools declared by the author (check availability in your agent): Bash, Read, Write

Original excerpt: Requirements
  • Python 3.x
  • requests library (usually pre-installed)
  • SUNO_COOKIE environment variable with __session token

The platforms on this page are catalog indications. The paths below follow tool documentation; they do not prove this skill has been run in those tools. No minimum tool version is confirmed for this listing.

3. Load the skill

After inspection, copy the complete folder into your project using one of the commands below, then open a new tool session. The command stops if a folder with the same name already exists: compare the files before replacing it.

Claude Code
test -f '.skill-downloads/suno-ai-music-generation-mmk3nhjc/SKILL.md' && test -s '.skill-downloads/suno-ai-music-generation-mmk3nhjc/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/suno-music' && cp -R '.skill-downloads/suno-ai-music-generation-mmk3nhjc' '.claude/skills/suno-music'

OpenSkills

OpenSkills must already be installed. The local install/read procedure is checked with OpenSkills 1.5.0, which requires Node.js ≥ 20.6.0. Catalog slugs are not resolved automatically.

Official OpenSkills installation
openskills install './.skill-downloads/suno-ai-music-generation-mmk3nhjc'

openskills read 'suno-ai-music-generation-mmk3nhjc'

Reading should display the installed file content and its base directory. It does not run the skill or install its dependencies.

For an agent that reads AGENTS.md, then sync the index. This command changes AGENTS.md: review the diff before using it.

openskills sync

Manual method or another tool: attach SKILL.md to a conversation, or open it in an agent that can read files. Include any required supporting resources. No universal folder is recognized by every tool.

4. Try a first task

Use a short, synthetic input: an API endpoint, a small document or an interface brief. In a new conversation, attach the file or give the agent its path, then adapt this request:

Read .skill-downloads/suno-ai-music-generation-mmk3nhjc/SKILL.md and apply its instructions to this example: [describe a test input]. Identify any missing files, dependencies or access. Produce the result requested by the skill without inventing data or running unreviewed scripts.

Expected result: output matching the skill instructions, or a precise list of missing prerequisites. A read confirmation alone does not validate a first use. If an external resource is unavailable, that path remains untested.

Related skills

Writing Fragments

Content

Mine raw writing fragments through a relentless interview, without imposing structure. Capture ideas, quotes, and leading words for later use.

Claude CodebeginnerSafe 240,316
Skills Guide Bot

UI Copywriting & Auditing

Content

Write or audit user-facing UI copy including buttons, errors, empty states, and tooltips across the monorepo, following the design system source of truth.

Claude CodeCursorbeginnerSafe 108,623
Skills Guide Bot

Music MIDI Extraction

Content

Extracts the MIDI or score from an existing music production via the CogMusic MCP tool and confirms availability.

Claude CodebeginnerSafe 69,866
Skills Guide Bot