# Video Podcast Maker

Use when the user gives a topic and wants an automated topic-driven narrated explainer...

- Repository: https://github.com/Agents365-ai/video-podcast-maker (1708 stars)
- Category: Design
- License: MIT
- Last updated: 2026-10-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Agents365-ai/video-podcast-maker --skill video-podcast-maker -g -a claude-code -y`
Codex: `npx skills add Agents365-ai/video-podcast-maker --skill video-podcast-maker -g -a codex -y`
Cursor: `npx skills add Agents365-ai/video-podcast-maker --skill video-podcast-maker -g -a cursor -y`
Gemini CLI: `npx skills add Agents365-ai/video-podcast-maker --skill video-podcast-maker -g -a gemini-cli -y`

## Description

Use when the user gives a topic and wants an automated topic-driven narrated explainer, podcast, or knowledge-summary video (Bilibili / YouTube / Xiaohongshu / Douyin / WeChat Channels), or asks to learn visual design patterns from a reference video/image. Trigger when the user mentions creating a knowledge video, narrated explainer, video podcast, or animated infographic-style video from a topic, even if they don't say "video podcast" explicitly. Also trigger when the user wants to regenerate, re-render, rebuild, update, or iterate on a narrated video this skill already produced, e.g. they edited the script/prompt, changed the visuals, or swapped the background music and want the final video remade (reuse the existing videos/{name}/ directory, never start a new project). Do NOT trigger for generic video editing, trimming, format conversion, color grading, or non-narrative video tasks. Produces 4K video via research → script → TTS → Remotion → MP4 + BGM.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

> **Recommended: Load Remotion Best Practices**
>
> This skill benefits from `remotion-best-practices` (not bundled) for the full
> Remotion pattern library. It is optional, minimum rules are below if absent.
>
> - **Pi**: read the loaded skill at `remotion-best-practices` (listed in available skills).
> - **Claude Code**: invoke `remotion-best-practices` skill/tool before proceeding.
>
> Not installed? Get it from [remotion-dev/skills](https://github.com/remotion-dev/skills) (docs: [remotion.dev/docs/ai/skills](https://www.remotion.dev/docs/ai/skills)).
>
> If `remotion-best-practices` is not installed, minimum rules: chromium must be available, always wrap 4K content in `<Scale4K>`, use `<TransitionSeries>` with `linearTiming`, and treat audio as the master clock.

# Video Podcast Maker

Automated pipeline for **4K Bilibili horizontal knowledge videos** from a topic. Coding agent + TTS backend + Remotion + FFmpeg.

## Contents

- [Bootstrap](#bootstrap), prerequisites (run before Step 1)
- [Execution Modes](#execution-modes), Auto vs Interactive → [references/workflow-script.md](references/workflow-script.md)
- [Regenerating an Existing Video](#regenerating-an-existing-video), iterate on a finished video
- [Workflow](#workflow), the 11-step pipeline + phase-file pointers + mandatory stops
- [Hard Rules](#hard-rules), non-negotiable production constraints
- [Audio-Master Clock & Sync](#audio-master-clock--sync)
- [Per-Video Layout](#per-video-layout)
- [Additional Resources](#additional-resources), when to load each `references/` file
- [User Preferences](#user-preferences)
- [Troubleshooting](#troubleshooting)

---

## Bootstrap

Resolve `SKILL_DIR` to the directory containing this `SKILL.md`:

- **Pi**: the agent knows the skill path from the loaded skill list, set `SKILL_DIR` to that directory before running commands.
- **Claude Code**: `${CLAUDE_SKILL_DIR}` is auto-populated.

```bash
SKILL_DIR="${SKILL_DIR:-${CLAUDE_SKILL_DIR}}"

The rest: https://github.com/Agents365-ai/video-podcast-maker/blob/HEAD/skills/video-podcast-maker/SKILL.md