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):

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):

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:

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:

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:

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:

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:

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:

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:

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):

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:

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

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:

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:

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:

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:

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."