youtube-transcript

Fetch YouTube video captions and generate transcripts, summaries, or TL;DRs.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/dsonyy/dotfiles --skill youtube-transcript-dsonyy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: youtube-transcript
Source: https://github.com/dsonyy/dotfiles/tree/main/skills/youtube-transcripting
Command: npx skills add https://github.com/dsonyy/dotfiles --skill youtube-transcript-dsonyy

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Getting the text content of a YouTube video normally means watching the whole thing or paying for transcription services. This Skill pulls the caption track YouTube already has (creator-uploaded or auto-generated) and turns it into a transcript, summary, TL;DR, or chapter breakdown in seconds, without running any speech-to-text. ## Core Features & Use Cases - Transcript Extraction: Accepts any YouTube URL format (watch, youtu.be, /shorts/, /live/) or a bare video ID and returns the full caption text. - Flexible Output Formats: Plain text, timestamped lines with [mm:ss] prefixes for chapters and jump links, or structured JSON segments for programmatic use. - Summarization Workflow: Produces TL;DRs, bulleted key points, and chapter breakdowns directly from the fetched transcript. - Use Case: A user pastes a 45-minute conference talk link and asks for the key takeaways. The Skill fetches the captions and returns a timestamped summary without watching the video. ## Quick Start Give the AI a YouTube link and ask it to fetch the transcript and summarize the key points with timestamps.

Frequently Asked Questions about youtube-transcript

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

FAQPage Schema
How do I get a transcript of a YouTube video?▼

Run the fetch script with the video URL or ID: python3 scripts/fetch_transcript.py "<url-or-id>". It pulls the existing caption track (creator-uploaded or auto-generated) and prints the full transcript as plain text.

How to get a YouTube transcript with timestamps?▼

Add the --with-timestamps flag when running the script to prefix each line with [mm:ss] markers. This is useful for chapter breakdowns, jump links, and timestamped notes.

Does YouTube transcript extraction work without yt-dlp installed?▼

Yes. The script auto-downloads yt-dlp to ~/.cache/youtube-transcript-skill/ on first run if it is not on PATH. If that fails, it falls back to a zero-dependency watch-page scrape using only the Python standard library.

Why does YouTube transcript fetching return no transcript found?▼

This error means the video has captions disabled or YouTube token-gated the request. Private, age-restricted, or region-locked videos may also be unreachable. Try another video or confirm captions are enabled.

Can I get YouTube transcripts in languages other than English?▼

Yes. Pass --lang with a language code such as --lang es to prefer Spanish captions. The script requests the exact language plus variants and falls back to whatever caption track is available.