music-generation

Files (4)

• SKILL.md
• lyria.py · scripts/
• suno.py · scripts/
• udio.py · scripts/

SKILL.md (first lines)

# 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 |

From michaelboeding/skills, MIT.

More from michaelboeding/skills