podcast-synthesize

Convert YouTube podcasts into structured markdown knowledge notes with transcript metadata.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/mostafa-K-raihan/skills --skill podcast-synthesize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: podcast-synthesize
Source: https://github.com/mostafa-K-raihan/skills/tree/main/podcast-synthesize
Command: npx skills add https://github.com/mostafa-K-raihan/skills --skill podcast-synthesize

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates turning a YouTube podcast into a structured, easily searchable knowledge document by capturing transcripts, metadata, and a consistent template.

Core Features & Use Cases

  • Transcript retrieval from YouTube or transcripts API
  • Metadata extraction: episode title, channel, guests, duration
  • Markdown synthesis using a fixed template, saved to the knowledge base
  • Topic-based organization under ~/playground/pensieve/podcasts/{topic}/
  • Quick, repeatable process for adding new episodes and updating the knowledge index

Quick Start

Synthesize a podcast by providing a YouTube URL and topic; the system will fetch the transcript, generate a structured markdown note, and save it to the podcasts knowledge base with an updated index.

Frequently Asked Questions about podcast-synthesize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a YouTube podcast transcript into structured markdown notes?

To convert a YouTube podcast transcript into structured markdown notes, provide the episode URL and topic. The system retrieves the transcript, extracts metadata, and generates a searchable markdown document saved to your local knowledge base.

Can I automatically extract podcast metadata like episode title and guests from YouTube?

Yes, you can automatically extract podcast metadata from YouTube. The system retrieves the episode title, channel name, guest information, and duration alongside the transcript to populate the structured markdown template.

What is the best way to organize YouTube podcast research notes in a local knowledge base?

The best way to organize YouTube podcast research notes is by topic. The system automatically saves generated markdown files under a dedicated topic directory and updates the knowledge base index for repeatable, searchable access.

Do I need yt-dlp to retrieve YouTube transcripts for markdown synthesis?

You do not necessarily need yt-dlp to retrieve YouTube transcripts for markdown synthesis. The system supports transcript retrieval using either yt-dlp or the YouTube Transcript API to fetch the text content.

How does transcript retrieval work for YouTube podcasts without manual downloads?

Transcript retrieval works by fetching available caption data directly via yt-dlp or the YouTube Transcript API. The system processes this text output to synthesize structured markdown notes without requiring manual audio downloads.

Are there limitations when generating markdown from YouTube podcast transcripts?

Limitations when generating markdown from YouTube podcast transcripts depend on YouTube caption availability. If a podcast lacks auto-generated or manual transcripts, the retrieval APIs cannot extract text, preventing markdown synthesis.