Video Podcast Maker

What it does

When your agent uses it

• Making a narrated knowledge video from a single topic
• Learning visual design patterns from a reference video or image
• Producing a Bilibili-style horizontal video with background music
• Saving or reusing a video style profile

Example prompts

• “Make a video podcast about how vector databases work.”
• “Learn the visual style of this reference video and apply it to my next episode.”
• “Create a video podcast on AI agent tutorials with a clean white style.”

Requirements

• Remotion with the `remotion-best-practices` skill
• FFmpeg
• A TTS backend, with edge as the default
• Python 3 for the prerequisites check

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

1. 1Step 9: Launch Remotion Studio — user reviews in real-time, requests changes until satisfied
2. 2Step 10: Only triggered when user explicitly says "render 4K" / "render final version"

What it can do on your machine

Read from SKILL.md and the folder at commit 0a9c6fc. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/, which the agent can run.

  Shell commands in SKILL.md call:

  • git
  • npx
  • python3

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use git and npx, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Video Podcast Maker loads about 3.4k tokens when it runs, and up to ~21k if it reads all its reference files. Until then it costs about 59 tokens; SKILL.md has 979 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~59

When it runs · the whole SKILL.md, loaded when a task matches

~3.4k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~21k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from dtsola/xiaoyaosearch at commit 0a9c6fc, republished under its MIT licence (© dtsola). 979 words, ~3,389 tokens.

name

video-podcast-maker

description

Use when the user gives a topic and wants an automated video podcast created, or asks to learn visual design patterns from a reference video/image. Produces 4K video via research → script → TTS → Remotion → MP4 + BGM.

argument-hint

[topic]

effort

high

author

Agents365-ai

category

Content Creation

version

2.0.0

created

2025-01-27

updated

2026-04-03

bilibili

https://space.bilibili.com/441831884

github

https://github.com/Agents365-ai/video-podcast-maker

dependencies

remotion-best-practices

SKILL_DIR="${SKILL_DIR:-${CLAUDE_SKILL_DIR}}"
STAMP="${SKILL_DIR}/.last_update_check"
NOW=$(date +%s)
LAST=$(cat "$STAMP" 2>/dev/null || echo 0)
if [ ! -d "${SKILL_DIR}/.git" ]; then
  echo "MANUAL_INSTALL"
elif [ $((NOW - LAST)) -gt 86400 ]; then
  timeout 5 git -C "${SKILL_DIR}" fetch --quiet 2>/dev/null || true
  LOCAL=$(git -C "${SKILL_DIR}" rev-parse HEAD 2>/dev/null)
  REMOTE=$(git -C "${SKILL_DIR}" rev-parse origin/main 2>/dev/null)
  echo "$NOW" > "$STAMP"
  if [ -n "$LOCAL" ] && [ -n "$REMOTE" ] && [ "$LOCAL" != "$REMOTE" ]; then
    echo "UPDATE_AVAILABLE"
  else
    echo "UP_TO_DATE"
  fi
else
  echo "SKIPPED_RECENT_CHECK"
fi

project-root/                           # Remotion project root
├── src/remotion/                       # Remotion source
│   ├── compositions/                   # Video composition definitions
│   ├── Root.tsx                        # Remotion entry
│   └── index.ts                        # Exports
│
├── public/                             # Remotion default (unused — use --public-dir videos/{name}/)
│
├── videos/{video-name}/                # Video project assets
│   ├── topic_definition.md             # Step 1
│   ├── topic_research.md               # Step 2
│   ├── podcast.txt                     # Step 4: narration script
│   ├── podcast_audio.wav               # Step 8: TTS audio
│   ├── podcast_audio.srt               # Step 8: subtitles
│   ├── timing.json                     # Step 8: timeline
│   ├── thumbnail_*.png                 # Step 7
│   ├── output.mp4                      # Step 10
│   ├── video_with_bgm.mp4             # Step 11
│   ├── final_video.mp4                 # Step 12: final output
│   └── bgm.mp3                         # Background music
│
└── remotion.config.ts

# All render/studio/still commands use --public-dir
npx remotion studio src/remotion/index.ts --public-dir videos/{name}/
npx remotion render src/remotion/index.ts CompositionId videos/{name}/output.mp4 --public-dir videos/{name}/ --video-bitrate 16M
npx remotion still src/remotion/index.ts Thumbnail16x9 videos/{name}/thumbnail.png --public-dir videos/{name}/

 1. Define topic direction → topic_definition.md
 2. Research topic → topic_research.md
 3. Design video sections (5-7 chapters)
 4. Write narration script → podcast.txt
 4.5. Pronunciation pre-flight (zh-CN only) → videos/{name}/phonemes.json
 5. Collect media assets → media_manifest.json
 6. Generate publish info (Part 1) → publish_info.md
 7. Generate thumbnails (16:9 + 4:3) → thumbnail_*.png
 8. Generate TTS audio → podcast_audio.wav, timing.json
 9. Create Remotion composition + Studio preview (mandatory stop)
10. Render 4K video (only on user request) → output.mp4
11. Mix background music → video_with_bgm.mp4
12. Add subtitles (optional) → final_video.mp4
13. Complete publish info (Part 2) → chapter timestamps
14. Verify output & cleanup
15. Generate vertical shorts (optional) → shorts/

Final = merge(Root.tsx defaults < global < topic_patterns[type] < current instructions)

© dtsola, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 89 other files (scripts, references, assets) in .claude/skills/video-podcast-maker of dtsola/xiaoyaosearch.

• SKILL.md
• .env.example
• .gitignore
• .python-version
• LICENSE
• README.md
• README_CN.md
• assets/bilibili-triple-black.mp4
• assets/bilibili-triple-white.mp4
• assets/perfect-beauty-191271.mp3
• assets/snow-stevekaldes-piano-397491.mp3
• assets/workflow.mmd
• assets/workflow.png
• package.json
• phonemes.template.json
• prefs_schema.json
• references/design-guide.md
• references/design-learning.md
• references/troubleshooting.md
• … and 71 more

Open the folder on GitHubat commit 0a9c6fc