mirror of https://gitee.com/wanwujie/deer-flow synced 2026-04-03 06:12:14 +08:00

Files

hetao dddd745b5b refactor: simplify podcast-generation to use direct JSON script input

- Remove LLM script generation from Python script, model now generates
  JSON script directly (similar to image-generation skill)
- Add --transcript-file option to generate markdown transcript
- Add optional "title" field in JSON for transcript heading
- Remove dependency on OPENAI_API_KEY for podcast generation
- Update SKILL.md with new workflow and JSON format documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-26 14:01:48 +08:00

1.9 KiB

Raw Blame History

Tech Explainer Podcast Template

Use this template when converting technical documentation, API guides, or developer tutorials into podcasts.

Input Preparation

When the user wants to convert technical content to a podcast, help them structure the input:

Simplify Code Examples: Replace code snippets with plain language descriptions
- Instead of showing actual code, describe what the code does
- Focus on concepts rather than syntax
Remove Complex Notation:
- Mathematical formulas should be explained in words
- API endpoints described by function rather than URL paths
- Configuration examples summarized as settings descriptions
Add Context:
- Explain why the technology matters
- Include real-world use cases
- Add analogies for complex concepts

Example Transformation

Original Technical Content:

# Using the API

POST /api/v1/users
{
  "name": "John",
  "email": "john@example.com"
}

Response: 201 Created

Podcast-Ready Content:

# Creating Users with the API

The user creation feature allows applications to register new users in the system.
When you want to add a new user, you send their name and email address to the server.
If everything goes well, the server confirms the user was created successfully.
This is commonly used in signup flows, admin dashboards, or when importing users from other systems.

Generation Command

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

Tips for Technical Podcasts

Keep episodes focused on one main concept
Use analogies to explain abstract concepts
Include practical "why this matters" context
Avoid jargon without explanation
Make the dialogue accessible to beginners

1.9 KiB Raw Blame History