youtube-transcript

Download and clean YouTube video transcripts using yt-dlp and Python.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/nferrer-dev/claude-dotfiles --skill youtube-transcript-nferrer-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: youtube-transcript
Source: https://github.com/nferrer-dev/claude-dotfiles/tree/main/skills/youtube-transcript
Command: npx skills add https://github.com/nferrer-dev/claude-dotfiles --skill youtube-transcript-nferrer-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yt-dlp, python3.

What problem does it solve?

This skill eliminates the need for manual transcription or watching long videos to find specific information by programmatically extracting text content from YouTube videos.

Core Features & Use Cases

  • Subtitle Extraction: Downloads manual or auto-generated captions directly from YouTube URLs.
  • Text Cleaning: Automatically removes VTT formatting, timestamps, and HTML tags to provide clean, readable text.
  • Fallback Transcription: Offers an integrated Whisper-based transcription workflow for videos lacking existing subtitles.
  • Use Case: Quickly generate a searchable text summary of a long technical tutorial or lecture video without needing to watch the entire duration.

Quick Start

Use the youtube-transcript skill to download and clean the subtitles for the video at the provided URL.

Frequently Asked Questions about youtube-transcript

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

FAQPage Schema
How do I extract subtitles from a YouTube video?

To extract subtitles from a YouTube video, this skill uses yt-dlp to download captions and Python to clean VTT formatting, timestamps, and HTML tags. It processes the URL directly to provide plain, readable text without manual transcription.

Can I transcribe YouTube audio to text if the video has no subtitles?

Yes, you can transcribe YouTube audio to text when subtitles are missing by using the integrated Whisper-based transcription workflow. This fallback mechanism processes the video's audio track to generate a text transcript.

Do I need Python and yt-dlp to download YouTube transcripts?

Yes, you need both Python 3 and yt-dlp installed to download YouTube transcripts. These dependencies are required to execute the retrieval pipeline, download caption files, and run the text formatting and cleaning processes.

What is the best way to clean VTT formatting from YouTube captions?

The best way to clean VTT formatting from YouTube captions is using a Python-based text cleaning pipeline. It automatically strips timestamps and HTML tags from the downloaded subtitle files to provide a clean, searchable text summary.

How does automated YouTube transcription handle long technical lectures?

Automated YouTube transcription handles long technical lectures by extracting the existing text content programmatically. This eliminates the need to watch the entire duration, quickly generating a searchable text summary of the video.

Are there limitations when extracting auto-generated YouTube captions?

Limitations when extracting auto-generated YouTube captions include potential formatting artifacts from VTT files, though the Python cleaning pipeline removes timestamps and HTML tags. If captions are entirely absent, the Whisper fallback workflow is required.