youtube-transcript
Extract YouTube video transcripts with metadata and save as Markdown to Obsidian vault. Use this skill when the user requests downloading YouTube transcripts, converting YouTube videos to text, or extracting video subtitles. Does not download video/audio files, only metadata and subtitles.
When & Why to Use This Skill
This Claude skill automates the extraction of YouTube video transcripts and comprehensive metadata, converting them into structured Markdown files optimized for Obsidian vaults. It leverages yt-dlp to capture video titles, channel info, and chapter-based timestamps, enabling users to transform video content into a searchable, organized personal knowledge base without manual note-taking.
Use Cases
- Personal Knowledge Management (PKM): Automatically archive YouTube video insights into an Obsidian vault with full YAML frontmatter for easy tagging and linking.
- Academic and Professional Research: Convert long-form lectures, interviews, or documentaries into text-based documents for quick scanning, citation, and deep-dive analysis.
- Content Repurposing: Extract transcripts from video content to serve as a foundation for blog posts, newsletters, or social media threads.
- Study Aid Creation: Generate structured study guides from educational videos, utilizing the chapter-based organization to navigate complex topics efficiently.
| name | youtube-transcript |
|---|---|
| description | "Extract YouTube video transcripts with metadata and save as Markdown to Obsidian vault. Use this skill when the user requests downloading YouTube transcripts, converting YouTube videos to text, or extracting video subtitles. Does not download video/audio files, only metadata and subtitles." |
YouTube Transcript
Overview
Extract YouTube video transcripts, metadata, and chapters using yt-dlp. Output formatted as Markdown with YAML frontmatter, saved to ~/Brains/brain/ (Obsidian vault).
Quick Start
To extract a transcript from a YouTube video:
python scripts/extract_transcript.py <youtube_url>
Optional: Specify custom output filename:
python scripts/extract_transcript.py <youtube_url> custom_filename.md
Output Format
YAML Frontmatter
The generated Markdown includes comprehensive metadata:
title- Video titlechannel- Channel nameurl- YouTube URLupload_date- Upload date (YYYY-MM-DD)duration- Video duration (HH:MM:SS)description- Video description (truncated to 500 chars)tags- Array of video tagsview_count- View countlike_count- Like count
Body Structure
Transcript organized by video chapters (if available):
## Chapter Title
**00:05:23** Transcript text for this segment.
**00:05:45** Next segment text.
If no chapters exist, all content appears under "## Transcript" heading.
Timestamps formatted as HH:MM:SS for consistency.
Workflow
- Extract metadata and subtitles using yt-dlp
- Parse VTT subtitle format to extract timestamps and text
- Group transcript segments by video chapters (if present)
- Format as Markdown with YAML frontmatter
- Save to ~/Brains/brain/ with sanitized filename based on video title
- Clean up temporary subtitle files
Deduplication
To remove duplicates from existing transcript files:
python scripts/deduplicate_transcript.py <markdown_file>
This removes transcript entries that are prefixes of subsequent entries (common in VTT files where subtitles accumulate).
Requirements
Ensure yt-dlp is installed:
pip install yt-dlp
Limitations
- Extracts subtitles in English first, falls back to Russian if English unavailable
- Requires video to have subtitles (auto-generated or manual)
- Does not download video or audio files
- Description truncated to 500 characters in frontmatter