podcast-generation

Podcast Generation Skill

Overview

This skill generates high-quality podcast audio from text content. The workflow includes creating a structured JSON script (conversational dialogue) and executing audio generation through text-to-speech synthesis.

Core Capabilities

• Convert any text content (articles, reports, documentation) into podcast scripts
• Generate natural two-host conversational dialogue (male and female hosts)
• Synthesize speech audio using text-to-speech
• Mix audio chunks into a final podcast MP3 file
• Support both English and Chinese content

Workflow

Step 1: Understand Requirements

When a user requests podcast generation, identify:

• Source content: The text/article/report to convert into a podcast
• Language: English or Chinese (based on content)
• Output location: Where to save the generated podcast
• You don't need to check the folder under /mnt/user-data

Step 2: Create Structured Script JSON

Generate a structured JSON script file in /mnt/user-data/workspace/ with naming pattern: {descriptive-name}-script.json

The JSON structure:

{
  "locale": "en",
  "lines": [
    {"speaker": "male", "paragraph": "dialogue text"},
    {"speaker": "female", "paragraph": "dialogue text"}
  ]
}

Step 3: Execute Generation

Call the Python script:

python /mnt/skills/public/podcast-generation/scripts/generate.py \
  --script-file /mnt/user-data/workspace/script-file.json \
  --output-file /mnt/user-data/outputs/generated-podcast.mp3 \
  --transcript-file /mnt/user-data/outputs/generated-podcast-transcript.md

Parameters:

• --script-file: Absolute path to JSON script file (required)
• --output-file: Absolute path to output MP3 file (required)
• --transcript-file: Absolute path to output transcript markdown file (optional, but recommended)

[!IMPORTANT]

• Execute the script in one complete call. Do NOT split the workflow into separate steps.
• The script handles all TTS API calls and audio generation internally.
• Do NOT read the Python file, just call it with the parameters.
• Always include --transcript-file to generate a readable transcript for the user.
• The TTS provider and its concurrency are selected automatically from environment variables — you do not choose or tune them.