podcast-generation

Podcast Generation

Generate podcast audio from text content. The workflow: create a structured JSON dialogue script, then execute audio generation via a bundled Python script that handles TTS synthesis and audio mixing.

All script paths below are relative to this skill's directory. Resolve them against the directory containing the manifest file shown in <location> (e.g., if <location> is ~/.comis/skills/podcast-generation/SKILL.md, then scripts/generate.py means ~/.comis/skills/podcast-generation/scripts/generate.py). Invoke the resolved script by its absolute path while keeping the tool working directory inside the execution workspace. Never set cwd to the skill directory; it is outside workspace bounds. In command examples below, replace each relative scripts/... path with its resolved absolute path.

Write script files and generated outputs to your workspace directory (shown in the "Workspace" section of your system prompt).

The bundled script requires the requests Python package (pip install requests).

Workflow

Step 1: Understand requirements

Identify from the user's request:

• Source content: The text/article/report to convert
• Language: en or zh (based on content)

Step 2: Create script JSON

Write a structured JSON script file to your workspace directory with naming pattern {descriptive-name}-script.json.

{
  "title": "Episode Title",
  "locale": "en",
  "lines": [
    {"speaker": "male", "paragraph": "Hello Deer! Welcome back to another episode."},
    {"speaker": "female", "paragraph": "Hey everyone! Today we have an exciting topic."},
    {"speaker": "male", "paragraph": "That's right! We're going to talk about..."}
  ]
}

Fields:

• title: Episode title (optional, used as heading in transcript)
• locale: Language code -- "en" or "zh"
• lines: Array of dialogue lines, each with speaker ("male" or "female") and paragraph

Step 3: Execute generation

python3 scripts/generate.py \
  --script-file ~/.comis/workspace/script-file.json \
  --output-file ~/.comis/workspace/generated-podcast.mp3 \
  --transcript-file ~/.comis/workspace/generated-podcast-transcript.md