---
name: "music-prompter"
description: "MUSS vor Musik-Generierung gelesen werden. Prompt-Framework, Struktursyntax, Multi-Clip-Strategie."
---

# music-prompter

Dieser Skill **MUSS vor dem Wechsel in den Generierungsmodus für Musikaufgaben gelesen werden**. Behandelt das Framework zur Prompt-Erstellung, die Struktursyntax und die Multi-Clip-Strategie.

## Wann verwenden

**Pflicht-Lektüre** bei:
- User fragt nach Song, Jingle, Beat, Loop, Soundtrack, Anthem, Instrumental
- Musik-Generierung mit Vocals oder rein instrumental
- Multi-Track-Produktion (Intro/Verse/Chorus/Outro)

## Tools

- **Primär:** `music_generate`
- **Status:** `music_generate action="status"`
- **Provider:** `music_generate action="list"`

## Prompt-Framework

### Anatomie eines guten Music-Prompts

```
[Genre] + [Mood] + [Tempo] + [Instrumente] + [Vocals/Instrumental] + [Verwendungszweck]
```

**Beispiel:**
> "Uplifting indie folk anthem, 110 BPM, acoustic guitar + cello + soft female vocals, cinematic build, suitable for travel montage outro"

### Was wohin gehört

| Feld | Inhalt | Beispiel |
|---|---|---|
| `prompt` | Stil, Genre, Mood, Zweck | "lo-fi hip-hop, melancholic, 80 BPM..." |
| `lyrics` | NUR exakte gesungene Worte | "I see the stars / falling down..." |
| `instrumental` | true wenn nur Musik | `true` / `false` |
| `durationSeconds` | Zielzeit (Provider clampt) | 30-180 |
| `format` | `mp3` oder `wav` | `mp3` |

⚠️ **WICHTIG:** `lyrics` nur befüllen wenn der User explizit Text/Vocals will. Für Style-Requests (z.B. "mach mir einen Beat") → `prompt` nutzen, `lyrics` leer lassen.

## Struktursyntax (in Lyrics)

Bei Provider die Section-Tags unterstützen:

```
[Intro]
(instrumental, 8 bars)

[Verse 1]
Walking down the empty street
City lights beneath my feet

[Chorus]
We are the dreamers tonight
Burning, burning bright

[Bridge]
...

[Outro]
(fade out)
```

## Multi-Clip-Strategie

Für längere/komplexere Produktionen:

1. **Teile aufsplitten:** Intro → Verse → Chorus separat generieren
2. **BPM + Key fixieren** im Prompt jeder Section
3. **Übergänge planen:** "ends on G major, ready to transition into chorus in C"
4. **Merge:** `ffmpeg -i intro.mp3 -i verse.mp3 -filter_complex concat=...`

## Genre-Hint-Wörter

| Genre | Trigger-Wörter |
|---|---|
| Lo-fi | "lo-fi, vinyl crackle, mellow, study beats" |
| Cinematic | "epic, orchestral, hybrid, trailer score" |
| Synthwave | "80s retro, analog synths, neon, Carpenter" |
| Indie Folk | "fingerpicked, intimate, organic" |
| EDM | "drop, sidechain, 128 BPM, festival" |

## Fallstricke

- ⚠️ Provider clampt Duration (oft 30-240s)
- ⚠️ Lyrics-Mode + Instrumental=true → Konflikt
- ⚠️ Zu viele Anweisungen im Prompt → Generic Output. Lieber 3-5 starke Descriptors.
- ⚠️ Background-Task: nicht erneut callen für gleiche Anfrage
- ⚠️ Sprache der Vocals im Prompt erwähnen ("German vocals", "English vocals")

## Lieferung

- `MEDIA:<pfad>.mp3` auf eigener Zeile
- Bei mehreren Versionen: jeweils eigene MEDIA-Zeile
- Kurze Beschreibung was im Track passiert (BPM, Stil, Länge)
