youtube-to-markdown

Extract YouTube video transcripts and generate categorized Markdown summaries.

276|46|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/nicepkg/ai-workflow --skill youtube-to-markdown-nicepkg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: youtube-to-markdown
Source: https://github.com/nicepkg/ai-workflow/tree/main/workflows/video-creator-workflow/.claude/skills/youtube-to-markdown
Command: npx skills add https://github.com/nicepkg/ai-workflow --skill youtube-to-markdown-nicepkg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yt-dlp, openai-whisper, mlx-whisper, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of extracting and structuring information from YouTube videos, saving users the time and effort of manually transcribing, summarizing, and organizing content.

Core Features & Use Cases

  • Automated Transcription: Downloads video transcripts (manual or auto-generated) and cleans them.
  • Content Summarization: Generates concise summaries of video content, categorized by type (Tips, Interview, Educational, Tutorial).
  • Structured Output: Creates well-organized Markdown files containing video metadata, descriptions, summaries, and transcripts.
  • Use Case: Quickly get the key takeaways from a long tutorial video, a podcast interview, or an educational lecture without watching the entire video.

Quick Start

Use the youtube-to-markdown skill to convert the YouTube video at https://www.youtube.com/watch?v=dQw4w9WgXcQ into a markdown file.

Frequently Asked Questions about youtube-to-markdown

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

FAQPage Schema
How do I convert a YouTube video to markdown with summaries and transcripts?

To convert a YouTube video to markdown, this Skill downloads video transcripts, generates categorized summaries, and outputs a structured markdown file containing metadata, descriptions, and transcripts. It uses yt-dlp for data extraction and optionally Whisper for transcription fallback.

Do I need yt-dlp installed to extract transcripts from YouTube videos?

Yes, yt-dlp is required to extract transcripts and video metadata from YouTube videos. The Skill relies on yt-dlp to fetch video data, which is then cleaned and structured into markdown format.

Can Whisper transcribe YouTube videos that lack auto-generated captions?

Yes, openai-whisper and mlx-whisper serve as fallback transcription tools when a YouTube video lacks manual or auto-generated captions. They process the video audio to generate a transcript that is then structured into markdown format.

What is the best way to summarize long educational lectures or podcast interviews from YouTube?

The best way to summarize long educational lectures or podcast interviews is to use a content summarization tool that categorizes video content into types like Tips, Interview, Educational, or Tutorial, extracting key takeaways without watching the entire video.

Does this YouTube to markdown transcription approach support metadata extraction?

Yes, this YouTube to markdown transcription approach supports metadata extraction. It automatically fetches video descriptions and metadata, organizing them alongside cleaned transcripts and categorized summaries into well-organized markdown output files.

Why do some YouTube video transcripts fail to convert into structured markdown?

YouTube video transcripts may fail to convert into structured markdown if the video has no available captions and the optional Whisper fallback transcription dependencies are not installed or configured properly.