youtube-transcript · glebis — Claude Code skill: extract YouTube subtitles
The youtube-transcript skill pulls subtitles and video metadata from YouTube, saves them as Markdown with YAML frontmatter into an Obsidian vault.
MIT 258 installs ★ 414 updated 2026-10-23
npx skills add glebis/claude-skills --skill youtube-transcript -a claude-codeWhat youtube-transcript does
The skill runs yt-dlp to fetch video metadata (title, channel, upload date, tags, view count) and subtitles in VTT format. Subtitles are grouped by video chapters if present, with timestamps for each segment. The file is saved to ~/Brains/brain/ with a sanitized filename based on the video title.
The script looks for English subtitles first, falls back to Russian if English is unavailable. Video and audio files are not downloaded. The description is truncated to 500 characters. Requires yt-dlp installed (pip install yt-dlp). A bundled deduplicate_transcript.py script removes duplicate lines from processed files — VTT format sometimes accumulates repeated entries.
The skill works with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode.
What it helps with
- extract subtitle text from YouTube videos
- save video metadata in YAML format
- split transcript by video chapters
- remove duplicate lines from VTT subtitles
Example prompts for the agent
- Download subtitles from this video and save to Obsidian
- Extract the transcript from this YouTube link and split by chapters
- Run
extract_transcript.pyfor this YouTube URL
How to install youtube-transcript
1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill youtube-transcript -a claude-code2Manually: put the files in place
~/.claude/skills/youtube-transcript/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/youtube-transcript/
1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill youtube-transcript -a codex2Manually: put the files in place
.agents/skills/youtube-transcript/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill youtube-transcript -a cursor2Manually: put the files in place
.cursor/skills/youtube-transcript/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install glebis/claude-skills youtube-transcript2Manually: put the files in place
.github/skills/youtube-transcript/SKILL.md1Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill youtube-transcript -a gemini-cli2Platform CLI
gemini skills install https://github.com/glebis/claude-skills --path youtube-transcriptManually: put the files in place
.devin/skills/youtube-transcript/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add glebis/claude-skills --skill youtube-transcript -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about youtube-transcript
How to install youtube-transcript in Claude Code?
Run npx skills add glebis/claude-skills --skill youtube-transcript -a claude-code, the skill will appear in ~/.claude/skills/youtube-transcript/SKILL.md.
What does youtube-transcript do?
The skill extracts subtitles and metadata from YouTube videos using yt-dlp, formats them as Markdown with YAML frontmatter, and saves them to an Obsidian vault. Video and audio files are not downloaded.
What does youtube-transcript require?
Requires yt-dlp installed (pip install yt-dlp). The video must have subtitles available — auto-generated or manual, in English or Russian.
Source text
SKILL.md · MIT
--- 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: ```bash python scripts/extract_transcript.py <youtube_url> ``` Optional: Specify custom output filename: ```bash python scripts/extract_transcript.py <youtube_url> custom_filename.md ``` ## Output Format ### YAML Frontmatter The generated Markdown includes comprehensive metadata: - `title` - Video title - `channel` - Channel name - `url` - YouTube URL - `upload_date` - Upload date (YYYY-MM-DD) - `duration` - Video duration (HH:MM:SS) - `description` - Video description (truncated to 500 chars) - `tags` - Array of video tags - `view_count` - View count - `like_count` - Like count ### Body Structure Transcript organized by video chapters (if available): ```markdown ## 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 1. Extract metadata and subtitles using yt-dlp 2. Parse VTT subtitle format to extract timestamps and text 3. Group transcript segments by video chapters (if present) 4. Format as Markdown with YAML frontmatter 5. Save to ~/Brains/brain/ with sanitized filename based on video title 6. Clean up temporary subtitle files ## Deduplication To remove duplicates from existing transcript files: ```bash 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: ```bash 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
© glebis · MIT · glebis/claude-skills
Similar skills
All skills for Notes, tasks and projects →youtube-transcript by other authors comes first.