audio-producer-agent

# Audio Producer

Create single-speaker audio content: audiobooks, voiceovers, narrations, jingles, and more.

**This is an orchestrator skill** that combines:
- Text-to-speech / narration (Gemini TTS, ElevenLabs, or OpenAI TTS)
- Background music / ambient audio (Lyria)
- Audio assembly (FFmpeg via media-utils)

**For dialogues and conversations**, use `podcast-producer` instead.

## What You Can Create

| Type | Example |
|------|---------|
| Audiobook | Long-form narration of text/chapters |
| Voiceover | Narration for video, presentation, or slideshow |
| Audio ad | Radio or podcast advertisement |
| Jingle | Short brand music with optional tagline |
| Sonic logo | Audio brand identifier (few seconds) |
| Audio guide | Museum/tour style narration |
| Meditation | Guided relaxation with ambient audio |
| Soundscape | Ambient audio environment |

## Prerequisites

- `GOOGLE_API_KEY` - For Gemini TTS (voice) and Lyria (music)
- FFmpeg installed: `brew install ffmpeg`

## Workflow

### Step 1: Gather Requirements (REQUIRED)

⚠️ **DO NOT skip this step. Use interactive questioning — ask ONE question at a time.**

#### Question Flow

⚠️ **Use the `AskUserQuestion` tool for each question below.** Do not just print questions in your response — use the tool to create interactive prompts with the options shown.

**Q1: Type**
> "I'll create that audio for you! First — **what type of audio?**
> 
> - Audiobook / narration
> - Voiceover (for video/presentation)
> - Audio ad / radio ad
> - Jingle / sonic logo
> - Meditation / guided audio
> - Or describe your own"

*Wait for response.*

**Q2: Content**
> "What's the **text/content** to speak?
> 
> - Paste the text here
> - Or describe what you need and I'll write it"

*Wait for response.*

**Q3: Voice**
> "What **voice style**?
> 
> - Professional
> - Warm/friendly
> - Energetic
> - Calm/soothing
> - Dramatic
> - Or describe your own"

*Wait for response.*

**Q4: Music**
> "Do you want **background music**?
> 
> - Yes — describe the style (ambient, upbeat, cinematic, etc.)
> - No — voice only"

*Wait for response.*

**Q5: Duration**
> "What's the **target duration**?
> 
> - Let it be natural length
> - Or specify (e.g., 30 seconds, 2 minutes)"

*Wait for response.*

#### Quick Reference

| Question | Determines |
|----------|------------|
| Type | Processing approach and output format |
| Content | TTS input text |
| Voice | Voice selection and style parameters |
| Music | Whether to generate and mix music |
| Duration | Pacing and content length |

---

### Step 2: Prepare the Content

**For narration/voiceover:**
- Optimize text for speech (spell out numbers if needed)
- Add natural pause points (commas, periods)
- Break long content into chunks if > 32k tokens

**For jingles/audio ads:**
- Write the tagline/copy
- Determine music style
- Plan structure: music intro → voice → music outro

**For audiobooks:**
- Split into chapters
- Consider different voice styles for different sections
- Plan ambient music (subtle, low volume)

---

### Step 3: Generate Assets

#### Type: Voiceover / Narration

**Generate narration (Gemini TTS):**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/voice-generation/scripts/gemini_tts.py \
  --text "Your narration text here..." \
  --voice Charon \
  --style "Professional, measured pace, warm and authoritative"
```

**Generate background music if needed (Lyria):**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "subtle ambient, corporate, unobtrusive, background" \
  --duration 120 \
  --density 0.2 \
  --brightness 0.4
```

**Mix voice with music:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/media-utils/scripts/audio_mix.py \
  --voice narration.wav \
  --music background.wav \
  --music-volume 0.15 \
  --fade-in 2 \
  --fade-out 3 \
  -o final_voiceover.mp3
```

---

#### Type: Audio Ad / Radio Spot

**Structure: 30-second radio ad**
```
0-3s:   Music hook (attention grabber)
3-25s:  Voice with music bed underneath
25-30s: Music + tagline + CTA
```

**Generate energetic music:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "upbeat, energetic, advertising, catchy, radio jingle" \
  --duration 35 \
  --bpm 120
```

**Generate voice with style:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/voice-generation/scripts/gemini_tts.py \
  --text "Tired of ordinary coffee? Wake up to extraordinary! Premium beans, perfect roast, delivered fresh. Visit BestCoffee.com today and get 20% off your first order!" \
  --voice Puck \
  --style "Energetic, radio announcer style, enthusiastic, clear call to action"
```

**Mix and assemble:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/media-utils/scripts/audio_mix.py \
  --voice ad_voice.wav \
  --music ad_music.wav \
  --music-volume 0.35 \
  --fade-in 1 \
  --fade-out 2 \
  -o radio_ad.mp3
```

---

#### Type: Jingle / Sonic Logo

**For jingle with tagline:**

**Generate catchy music:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "catchy jingle, memorable, brand audio, upbeat, major key" \
  --duration 10 \
  --bpm 110 \
  --scale C
```

**Generate tagline:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/voice-generation/scripts/gemini_tts.py \
  --text "TechCorp. Innovation for tomorrow." \
  --voice Kore \
  --style "Confident, aspirational, slight pause between company name and tagline"
```

**Mix tagline over music:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/media-utils/scripts/audio_mix.py \
  --voice tagline.wav \
  --music jingle.wav \
  --music-volume 0.5 \
  -o brand_jingle.mp3
```

**For sonic logo (music only):**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "sonic logo, 3 seconds, memorable, brand identifier, simple, distinctive" \
  --duration 5 \
  --bpm 100
```

---

#### Type: Audiobook

**Process chapters:**

```bash
# Chapter 1
python3 ${CLAUDE_PLUGIN_ROOT}/skills/voice-generation/scripts/gemini_tts.py \
  --text-file chapter1.txt \
  --voice Algieba \
  --style "Audiobook narrator, measured pace, engaging storytelling" \
  -o chapter1.wav

# Chapter 2
python3 ${CLAUDE_PLUGIN_ROOT}/skills/voice-generation/scripts/gemini_tts.py \
  --text-file chapter2.txt \
  --voice Algieba \
  -o chapter2.wav
```

**Optional: Add subtle ambient music:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "ambient, subtle, reading music, calm, unobtrusive, soft piano" \
  --duration 600 \
  --density 0.1 \
  --brightness 0.3
```

**Concatenate chapters:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/media-utils/scripts/audio_concat.py \
  -i chapter1.wav chapter2.wav chapter3.wav \
  --crossfade 0.5 \
  -o audiobook.mp3
```

---

#### Type: Meditation / Relaxation Audio

**Generate calming narration:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/voice-generation/scripts/gemini_tts.py \
  --text "Close your eyes. Take a deep breath in... and slowly release..." \
  --voice Achernar \
  --style "Calm, soothing, slow pace, relaxing, gentle, meditation guide"
```

**Generate ambient soundscape:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "ambient, meditation, peaceful, nature sounds, gentle, calming" \
  --duration 300 \
  --density 0.1 \
  --brightness 0.6
```

**Mix with high ambient volume:**
```bash
python3 ${CLAUDE_PLUGIN_ROOT}/skills/media-utils/scripts/audio_mix.py \
  --voice meditation_guide.wav \
  --music ambient.wav \
  --music-volume 0.5 \
  -o meditation_session.mp3
```

---

### Step 4: Deliver the Result

**Example delivery:**

"✅ Your audio ad is ready!

**File:** `coffee_radio_ad.mp3` (30s)

**What I created:**
- Energetic voiceover (Puck voice, radio announcer style)
- Upbeat background music (120 BPM)
- Music ducks under voice, fades out at end

**Structure:**
- 0-3s: Music hook
- 3-25s: Voice + music bed
- 25-30s: Music swell + tagline

**Want me to:**
- Try a different voice?
- Change the music energy?
- Adjust timing?"

---

## Voice Recommendations by Type

| Audio Type | Recommended Voices | Style Direction |
|------------|-------------------|-----------------|
| Corporate voiceover | Charon, Orus | Professional, measured |
| Audiobook | Algieba, Despina | Smooth, engaging |
| Radio ad | Puck, Laomedeia | Energetic, upbeat |
| Meditation | Achernar, Sulafat | Calm, soothing |
| Jingle tagline | Kore, Alnilam | Confident, memorable |
| Documentary | Gacrux, Rasalgethi | Mature, authoritative |
| Tutorial | Achird, Charon | Friendly, clear |

## Music Recommendations by Type

| Audio Type | Lyria Prompt | Settings |
|------------|--------------|----------|
| Corporate VO | "subtle, professional, ambient" | density: 0.2, brightness: 0.4 |
| Radio ad | "upbeat, energetic, catchy" | bpm: 120, density: 0.6 |
| Audiobook | "soft, ambient, unobtrusive" | density: 0.1, brightness: 0.3 |
| Meditation | "peaceful, ambient, nature" | density: 0.1, brightness: 0.6 |
| Jingle | "catchy, memorable, brand" | bpm: 110, density: 0.5 |

---

## Limitations

- **Gemini TTS max**: 32k tokens per request (split longer content)
- **Lyria instrumental only**: No vocals in background music
- **Processing time**: Long audiobooks take time to generate

## Example Prompts

**Voiceover:**
> "Create a professional voiceover for this script: '...' Add subtle corporate background music."

**Audio ad:**
> "Create a 30-second radio ad for our coffee brand. Energetic, memorable, with catchy music. End with 'Visit BestCoffee.com'"

**Jingle:**
> "Create a 5-second jingle for TechCorp. Modern, memorable, with the tagline 'Innovation for tomorrow'"

**Audiobook:**
> "Convert this text into an audiobook chapter. Use a warm, engaging narrator voice. Add subtle ambient music."

**Meditation:**
> "Create a 5-minute guided meditation. Calm, soothing voice with peaceful ambient background."