Skip to main content
skill CX Codex

music-generation · michaelboeding — Claude Code skill: what it does, how to install

music-generation is a Claude Code skill that turns a music request into an audio file by choosing a provider, refining the prompt and running a script.

MIT 1 installs ★ 30 updated 2026-10-14

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add michaelboeding/skills --skill music-generation -a claude-code
Open on GitHub

What music-generation does

The skill carries a request from a loose idea to a file on disk. It begins by asking whether vocals are wanted, since that alone decides the provider. Google Lyria does instrumental only, and in return takes any length and exposes BPM, scale, brightness and density, handing back 48kHz stereo WAV. Suno covers sung tracks up to 4 minutes and can write the lyrics too. Udio stops at 2 minutes per generation.

Next the skill rewrites the wish into a prompt that a model can use: genre, mood, lead instruments, production feel, tempo. That prompt goes to lyria.py, suno.py or udio.py under scripts/, each started with python3. What comes back is the path to the audio plus the prompt and settings behind it.

One API key is required up front: GOOGLE_API_KEY, SUNO_API_KEY or UDIO_API_KEY. Lyria also needs the google-genai package (pip install google-genai); the script stops without it. A Google key on its own rules out singing, because Lyria has no vocals and Suno or Udio want their own keys.

What it helps with

  • generate a background track for a video cut
  • write a full song with vocals and lyrics
  • produce a lo-fi beat at a set BPM
  • get a game soundtrack in a chosen key
  • switch to instrumental when vocals are in the way

Example prompts for the agent

  • Generate a 60-second lo-fi track with jazzy piano at 85 BPM
  • Make an indie pop song with vocals about summer, write the lyrics yourself
  • I need two minutes of ambient in the key of C for a game menu

How to install music-generation

1Skills CLI (Vercel)

npx skills add michaelboeding/skills --skill music-generation -a claude-code

2Manually: put the files in place

~/.claude/skills/music-generation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/music-generation/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about music-generation

How do I install music-generation in Claude Code?

Run npx skills add michaelboeding/skills --skill music-generation -a claude-code. The skill file lands at ~/.claude/skills/music-generation/SKILL.md.

What does music-generation do?

It settles the vocals question, chooses a provider to match, expands the request into a usable prompt and runs the Python script. You get the audio file path along with the settings used.

Can I use it with only a Google key?

Yes, for instrumental work: Lyria runs on GOOGLE_API_KEY and needs the google-genai package installed. Tracks with vocals require SUNO_API_KEY or UDIO_API_KEY.

Source text

SKILL.md · MIT
---
name: music-generation
description: >
  Use this skill for AI music generation. Triggers include:
  "generate music", "create a song", "make music", "compose", "create a beat", 
  "generate audio", "make a soundtrack", "create a jingle", "instrumental music",
  "background music", "lo-fi beats", "electronic music"
  Supports vocals (Suno/Udio) and instrumental-only (Google Lyria).
---

# Music Generation Skill

Generate music, songs, and audio using AI (Suno, Udio, Google Lyria).

## Prerequisites

At least one API key is required:

- `GOOGLE_API_KEY` - For Google Lyria (same key as video/image) ✅
- `SUNO_API_KEY` - For Suno music generation
- `UDIO_API_KEY` - For Udio music generation

## Available APIs

### Google Lyria (Instrumental Only)
- **Best for**: Background music, beats, soundtracks, game audio
- **Duration**: Any length (streams in real-time)
- **Features**: BPM control, key/scale, brightness, density
- **Output**: 48kHz stereo WAV
- **API Key**: Same `GOOGLE_API_KEY` as video/image generation ✅
- **⚠️ INSTRUMENTAL ONLY** - Cannot generate vocals

### Suno (Recommended for Songs with Vocals)
- **Best for**: Full songs with vocals, catchy melodies, various genres
- **Duration**: Up to 4 minutes
- **Features**: Lyrics generation, instrumental mode, style tags
- **Genres**: Pop, rock, jazz, electronic, classical, hip-hop, and more

### Udio
- **Best for**: High-fidelity audio, experimental styles, remixes
- **Duration**: Up to 2 minutes per generation
- **Features**: Style control, audio quality options
- **Genres**: Wide variety with strong electronic/experimental support

## Workflow

### Step 1: Ask Key Question - Vocals or Instrumental?

**This determines which API to use:**

| Need | API | Why |
|------|-----|-----|
| **Vocals/Lyrics** | Suno or Udio | Lyria cannot generate vocals |
| **Instrumental only** | Lyria (preferred) | Same API key as video/image, real-time control |
| **Background music** | Lyria | Best for soundtracks, game audio |
| **Full songs** | Suno | Best vocal quality |

**Example prompt to user:**

"I'll generate that music! Quick question:

1. **Do you need vocals/lyrics?**
   - Yes → I'll use Suno (best for songs)
   - No, instrumental only → I'll use Lyria (same key as video/image)

2. **What genre/mood?** (e.g., chill lo-fi, epic orchestral, upbeat pop)

3. **How long?** (Lyria: any length, Suno: up to 4 min)

4. **Any BPM preference?** (e.g., 90 for chill, 128 for dance)"

---

### Step 2: Understand the Request

Parse the user's music request for:
- **Genre/style**: Pop, rock, jazz, electronic, classical, etc.
- **Mood**: Happy, sad, energetic, calm, dramatic
- **Tempo**: Fast, slow, medium, specific BPM
- **Vocals**: With vocals → Suno/Udio, Instrumental → Lyria
- **Purpose**: Background music, song, jingle, soundtrack
- **Duration**: How long should it be?

### Step 2: Craft the Prompt

Transform the user request into an effective music generation prompt:

1. **Specify genre**: Be specific about the style
2. **Describe mood**: Emotional tone and energy level
3. **Include instruments**: What should be prominent
4. **Add production style**: Lo-fi, polished, vintage, modern
5. **Set tempo**: BPM or descriptive (upbeat, slow)

**Example transformation:**
- User: "happy summer song"
- Enhanced: "Upbeat indie pop song with bright acoustic guitar, cheerful ukulele, and sunny vibes. Feel-good summer anthem with catchy hooks and positive energy. Male vocals, 120 BPM, radio-friendly production"

### Step 3: Handle Lyrics (If Needed)

For songs with vocals:
- **User provides lyrics**: Use them directly
- **Generate lyrics**: Ask Suno/Udio to generate, or use Claude to write them first
- **Instrumental**: Specify "instrumental" to skip vocals

Lyrics format for Suno:
```
[Verse 1]
Your lyrics here

[Chorus]
Catchy chorus lyrics

[Verse 2]
More lyrics
```

### Step 4: Select the API

Choose based on requirements:

| Use Case | Recommended API | Reason |
|----------|----------------|--------|
| **Instrumental/background** | Lyria | Same API key, any duration, real-time control |
| **Full songs with vocals** | Suno | Best vocal quality |
| **Lo-fi beats** | Lyria | Great for ambient/chill |
| **Experimental/electronic** | Udio | Strong in these genres |
| **Specific lyrics needed** | Suno | Lyrics input support |
| **Game/video soundtrack** | Lyria | Precise BPM/key control |

### Step 5: Generate the Music

Execute the appropriate script from `${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/`:

**For Google Lyria (Instrumental):**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "chill lo-fi hip hop, jazzy piano, vinyl crackle" \
  --duration 60 \
  --bpm 85
```

**Lyria with key/scale:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "ambient, ethereal synths, dreamy" \
  --duration 120 \
  --scale "C" \
  --brightness 0.7
```

**Lyria with multiple prompts (blended):**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "minimal techno" \
  --prompt "deep bass, 808" \
  --bpm 128 \
  --duration 90
```

**For Suno (with vocals):**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/suno.py \
  --prompt "upbeat indie pop, summer vibes, acoustic guitar" \
  --title "Summer Days"
```

**For Udio:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/udio.py \
  --prompt "cinematic orchestral, epic trailer music" \
  --duration 120
```

### Step 6: Deliver the Result

1. Provide the generated audio file path
2. Share the prompt and settings used
3. Mention the duration and format
4. Offer to:
   - Generate variations
   - Try different style/genre
   - Adjust tempo or mood
   - Extend the track
   - Add or remove vocals

## Error Handling

**Missing API key**: Inform the user which key is needed:
- Lyria: Same `GOOGLE_API_KEY` as video/image - https://aistudio.google.com/apikey
- Suno: https://suno.com/api (or app.suno.ai)
- Udio: https://udio.com/api

**Lyria requires google-genai package**: `pip install google-genai`

**User wants vocals but only has GOOGLE_API_KEY**: Explain Lyria is instrumental-only, suggest Suno/Udio.

**Content policy violation**: Rephrase lyrics or prompt.

**Generation failed**: Retry with simplified prompt.

**Quota exceeded**: Suggest waiting or trying other provider.

## Prompt Engineering Tips

### Genre Tags (Suno Style)
Include specific genre tags for best results:
- `[pop, upbeat, female vocals, 128 BPM]`
- `[jazz, smooth, saxophone, laid-back]`
- `[electronic, synthwave, 80s, driving]`
- `[classical, orchestral, emotional, strings]`

### Mood Descriptors
- **Energetic**: upbeat, driving, powerful, intense
- **Calm**: relaxing, ambient, peaceful, gentle
- **Happy**: cheerful, bright, sunny, joyful
- **Sad**: melancholic, emotional, heartfelt, somber
- **Epic**: cinematic, dramatic, sweeping, grand

### Production Style
- **Lo-fi**: warm, vintage, tape hiss, nostalgic
- **Polished**: crisp, modern, radio-ready, professional
- **Raw**: garage, live, organic, unpolished
- **Electronic**: synthesizers, digital, processed

## API Comparison

| Feature | Lyria | Suno | Udio |
|---------|-------|------|------|
| API Key | `GOOGLE_API_KEY` ✅ | `SUNO_API_KEY` | `UDIO_API_KEY` |
| Max duration | **Unlimited** | 4 minutes | 2 minutes |
| Vocals | ❌ **No** | ✅ Excellent | ✅ Good |
| Instrumentals | ✅ Excellent | ✅ Great | ✅ Excellent |
| BPM control | ✅ 60-200 | ❌ No | ❌ No |
| Key/Scale control | ✅ Yes | ❌ No | ❌ No |
| Audio quality | 48kHz WAV | Very good | Excellent |
| Lyrics input | ❌ No | ✅ Yes | ✅ Yes |
| Real-time steering | ✅ Yes | ❌ No | ❌ No |
| Best for | Beats, soundtracks | Songs | Experimental |

## Example Prompts

### Pop Song
```
Catchy pop song with female vocals, bright synths, and an anthemic chorus. 
Feel-good energy, summer vibes, 120 BPM, radio-friendly production.
```

### Cinematic Score
```
Epic orchestral trailer music with building tension. Powerful brass, 
sweeping strings, thundering percussion. Dramatic and emotional.
```

### Lo-fi Beat
```
Chill lo-fi hip hop beat, jazzy piano samples, vinyl crackle, 
relaxed drums, perfect for studying. 85 BPM, nostalgic mood.
```

### Electronic Dance
```
High-energy EDM track with massive drops, pulsing synths, 
four-on-the-floor beat. Festival-ready, 128 BPM.
```

## Lyria-Specific Examples

### Lo-fi Study Beats
```bash
python3 lyria.py -p "lo-fi hip hop, jazzy piano, vinyl crackle, chill" \
  --duration 300 --bpm 85 --brightness 0.3
```

### Techno/Dance
```bash
python3 lyria.py -p "minimal techno, deep bass, 808 drums" \
  --duration 120 --bpm 128 --density 0.7
```

### Ambient/Meditation
```bash
python3 lyria.py -p "ambient, ethereal, soft pads, dreamy" \
  --duration 180 --brightness 0.8 --density 0.2
```

### Game Soundtrack
```bash
python3 lyria.py -p "epic orchestral, cinematic, dramatic strings" \
  --duration 90 --scale "D" --mode quality
```

### Lyria Prompt Tips
- **Instruments**: piano, guitar, synth, drums, bass, strings, 808, Rhodes, Moog
- **Genres**: lo-fi hip hop, minimal techno, ambient, jazz fusion, synthwave, chillout
- **Moods**: chill, energetic, dreamy, dark, upbeat, melancholic, epic
- **Combine prompts**: Use multiple `-p` flags to blend styles

© michaelboeding · MIT · michaelboeding/skills

Similar skills

All skills for AI and ML →

music-generation by other authors comes first.

music-generation bytedance music-generation turns a style and mood description into a finished track through the MiniMax music API, with sung lyrics or as a pure instrumental. CX Codex +1 314installs style-specification a5c-ai The style-specification skill writes a detailed style brief for a track — genre, BPM, instruments, vocals, references — then folds it into one prompt for Suno or Udio. CX Codex +1 1installs suno-music acedatacloud The suno-music Claude Code skill creates songs, instrumental music, and lyrics through Suno. It activates for requests to generate music or a song. CX Codex +1 287installs elevenlabs-music-generation prime-skills elevenlabs-music-generation — a skill for Claude Code, Codex, Cursor, GitHub Copilot and Gemini CLI that calls ElevenLabs Music via the runcomfy CLI and delivers 44.1 kHz stereo audio. CX Codex +1 387,700installs google-lyria calesthio google-lyria is a Claude Code skill that configures music generation using Google Lyria 2 and Lyria 3 on Google Cloud. Builds prompts for background tracks, ads, and video scores. CX Codex +1 137installs suno-music-creator Schwepps suno-music-creator — a skill that walks your agent through making tracks and playlists in Suno AI V5 and Suno Studio, from brief to export. CX Codex +1 1,400installs songwriting-and-ai-music Teknium (teknium1), Hermes Agent songwriting-and-ai-music provides songwriting structures, prosody techniques, and Suno AI prompt formulas that rely on sound details rather than artist names. CX Codex +1 649installs

From the same set3

Project sponsors

Companies that keep this analytics open