podcast-producer-agent

Podcast Producer

Create complete podcast episodes, interviews, and conversation-style audio content.

This is an orchestrator skill that combines:

• Script/dialogue generation (Claude)
• Multi-speaker voice synthesis (Gemini TTS)
• Intro/outro music (Lyria)
• Audio assembly (FFmpeg via media-utils)

What You Can Create

Type	Example
Podcast episode	Two hosts discussing a topic
Interview	Q&A format with host and guest
Dialogue	Scripted conversation between characters
Audio drama	Story with multiple characters
Radio show	Formatted audio program with segments

Prerequisites

• GOOGLE_API_KEY - For Gemini TTS (voices) and Lyria (music)
• FFmpeg installed: brew install ffmpeg (macOS) or apt install ffmpeg (Linux)

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

"I'll create that podcast episode! First — what's the topic?

(What should the hosts discuss?)"

Wait for response.

Q2: Hosts

"Who are the hosts/speakers?

(Names and brief personality — e.g., 'Sarah, enthusiastic tech expert' — max 2 for TTS)"

Wait for response.

Q3: Duration

"How long should the episode be?

• 5 minutes
• 10 minutes
• 15 minutes
• Or specify your own"

Wait for response.

Q4: Tone

"What tone?

• Professional
• Casual/conversational
• Funny/entertaining
• Serious/educational
• Or describe your own"

Wait for response.

Q5: Music

"What music style for intro/outro?

• Upbeat pop
• Chill lo-fi
• Corporate/professional
• Electronic
• Or describe your own"

Wait for response.

Quick Reference

Question	Determines
Topic	Script content and discussion points
Hosts	Voice selection and script style
Duration	Script length
Tone	Writing style and energy
Music	Lyria prompt for intro/outro

---

Step 2: Generate the Script

Use Claude to create the dialogue script with speaker labels:

[INTRO MUSIC: 10 seconds, upbeat tech podcast vibe]

Sarah: Welcome back to Tech Talk! I'm Sarah, and today we have something exciting.

Mike: Hey everyone! I'm Mike, and yes - we're diving into AI in healthcare.

Sarah: So Mike, what's the biggest change you've seen this year?

Mike: Great question! The use of AI for diagnostic imaging has exploded...

[Continue dialogue...]

[OUTRO MUSIC: Fade under last lines, 5 seconds after]

Sarah: Thanks for listening! Follow us for more episodes.

Mike: See you next time!

Script Guidelines:

• Use speaker names exactly as they'll be configured in TTS
• Include music cues in brackets: [INTRO MUSIC: description]
• Natural conversation flow with back-and-forth
• Aim for ~150 words per minute of audio

---

Step 3: Plan Asset Generation

Create a manifest of what needs to be generated:

{
  "project": "tech_talk_ai_healthcare",
  "duration_target": "5 minutes",
  "speakers": [
    {"name": "Sarah", "voice": "Kore", "style": "Enthusiastic, upbeat"},
    {"name": "Mike", "voice": "Puck", "style": "Friendly, knowledgeable"}
  ],
  "assets": [
    {
      "type": "music",
      "name": "intro_music",
      "prompt": "upbeat tech podcast, electronic, modern",
      "duration": 15,
      "script": "lyria"
    },
    {
      "type": "dialogue", 
      "name": "main_content",
      "speakers": ["Sarah", "Mike"],
      "text": "[the dialogue script]",
      "script": "gemini_tts"
    },
    {
      "type": "music",
      "name": "outro_music",
      "prompt": "same as intro, fade out",
      "duration": 10,
      "script": "lyria"
    }
  ],
  "assembly": [
    {"action": "mix", "voice": "intro_with_music", "music": "intro_music", "music_volume": 0.8},
    {"action": "concat", "files": ["intro_with_music", "main_content"]},
    {"action": "mix", "voice": "main_content_end", "music": "outro_music", "fade_out": 5}
  ]
}

---

Step 4: Generate Assets

Execute each generation step:

Generate intro music (Lyria):

python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "upbeat tech podcast, electronic, modern, positive energy" \
  --duration 15 \
  --bpm 120

Generate dialogue (Gemini TTS multi-speaker):

python3 ${CLAUDE_PLUGIN_ROOT}/skills/voice-generation/scripts/gemini_tts.py \
  --multi \
  --speaker "Sarah:Kore" \
  --speaker "Mike:Puck" \
  --text "[dialogue script from Step 2]" \
  --style "Make Sarah sound enthusiastic and upbeat. Mike sounds friendly and knowledgeable."

Generate outro music (same as intro or variation):

python3 ${CLAUDE_PLUGIN_ROOT}/skills/music-generation/scripts/lyria.py \
  --prompt "upbeat tech podcast, electronic, fade out feel" \
  --duration 10 \
  --bpm 120

---

Step 5: Assemble the Podcast

Use media-utils to stitch everything together:

Mix intro music with beginning of dialogue:

python3 ${CLAUDE_PLUGIN_ROOT}/skills/media-utils/scripts/audio_mix.py \
  --voice dialogue.wav \
  --music intro_music.wav \
  --music-volume 0.4 \
  --fade-out 3 \
  -o intro_mixed.wav

Concatenate all segments:

python3 ${CLAUDE_PLUGIN_ROOT}/skills/media-utils/scripts/audio_concat.py \
  -i intro_mixed.wav main_dialogue.wav outro_mixed.wav \
  --crossfade 1.0 \
  -o final_podcast.mp3

---

Step 6: Deliver the Result

Provide:

1. The final audio file
2. Summary of what was created
3. Offer adjustments

Example delivery:

"✅ Your podcast episode is ready!

File: tech_talk_ai_healthcare.mp3 (5:23)

What I created:

• Dialogue between Sarah (Kore voice) and Mike (Puck voice)
• 15s upbeat electronic intro music
• 10s outro music fade

Want me to:

• Adjust the voices or tone?
• Change the music style?
• Extend or shorten any section?
• Add more topics to the discussion?"

---

Voice Pairing Suggestions

Host Type	Suggested Voice	Description
Main host (energetic)	Kore, Puck, Laomedeia	Firm, upbeat
Co-host (calm)	Charon, Algieba	Informative, smooth
Guest (expert)	Rasalgethi, Gacrux	Knowledgeable, mature
Interviewer	Achird	Friendly
Narrator	Charon, Orus	Informative, clear

Music Style Suggestions

Podcast Type	Music Prompt
Tech/Business	"upbeat electronic, modern, corporate, positive"
Casual/Comedy	"fun, playful, acoustic guitar, lighthearted"
News/Serious	"subtle, professional, ambient, understated"
Storytelling	"cinematic, emotional, orchestral, atmospheric"
Health/Wellness	"calm, peaceful, ambient, gentle piano"
True Crime	"dark, suspenseful, minimal, tension"

Limitations

• Max 2 speakers per Gemini TTS call (for more, generate separate files and concatenate)
• Lyria is instrumental only - no vocals in music
• Duration estimates may vary - dialogue length depends on speaking pace
• Music loops if shorter than dialogue

Error Handling

Error	Solution
"GOOGLE_API_KEY not set"	Set up API key per README
"FFmpeg not found"	Install: brew install ffmpeg
"google-genai not installed"	Run: pip install google-genai
TTS too long	Split script into segments, generate separately, concat

Example Prompts

Simple:

"Create a 3-minute podcast episode about remote work tips with two hosts"

Detailed:

"Create a 5-minute tech podcast episode. Hosts: Alex (enthusiastic, tech-savvy) and Jordan (skeptical, asks good questions). Topic: The future of AI assistants. Include upbeat electronic intro/outro music. Casual but informative tone."

With provided script:

"Turn this dialogue into a podcast episode with intro/outro music: Alex: Hey everyone, welcome back! Jordan: Today we're talking about..."