How does the 'cleaning' process work for transcripts?

The skill uses an AI subagent to remove filler words (like 'um' and 'uh'), fix transcription errors, add proper punctuation, and insert logical headings based on the video's chapters or topic shifts.

What happens if a YouTube video doesn't have a transcript?

The skill automatically detects the absence of a native transcript and offers a fallback to Whisper AI (either MLX Whisper for Mac or OpenAI Whisper) to generate a high-quality transcript from the audio.

Can I analyze viewer comments along with the video content?

Yes, the workflow includes an optional final step to chain the extraction with the youtube-comment-analysis skill for cross-referencing viewer feedback with the video summary.

Does this skill support non-English videos?

Yes, it detects the video language and allows you to specify which transcript language to download. It ensures the final Markdown output preserves the original language unless you explicitly request a translation.

YouTube to Markdown

Name: YouTube to Markdown
Author: vre

byvre

•

学習とドキュメンテーション

Converts YouTube videos into structured, cleaned, and summarized Markdown documents including transcripts and metadata.

This skill automates the entire process of transforming YouTube video content into professional, searchable documentation. It extracts metadata, chapters, and descriptions, then fetches native transcripts or generates them using Whisper AI when necessary. Beyond simple extraction, the skill performs intelligent deduplication, cleans speech artifacts like filler words, applies natural paragraph breaks, and generates a structured AI summary. The result is a cohesive, high-quality Markdown file suitable for technical documentation, study notes, or content repurposing, with optional support for integrated comment analysis.

主な機能

01Automated metadata, description, and chapter extraction

02Intelligent speech artifact cleaning and paragraph formatting using AI subagents

03Seamless integration with comment analysis for deeper audience insights

04Multi-language transcript support with Whisper AI fallback for private or uncaptioned videos

056 GitHub stars

06Structured summarization including TL;DR, 5Ws, and hidden gems

ユースケース

01Converting technical video tutorials into searchable internal documentation

02Generating structured study notes and summaries from long-form educational lectures

03Repurposing video content into blog drafts or knowledge base articles

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add vre/flow-state youtube-to-markdown

For use in Claude.ai and ChatGPT

Download Skill