youtube-subs

Fetch YouTube subtitles and convert them into clean plain-text transcripts.

Updated Feb 12, 2026
One-click install
npx skills add https://github.com/tonyoconnell/agent-ui --skill youtube-subs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: youtube-subs
Source: https://github.com/tonyoconnell/agent-ui/tree/main/.claude/skills/youtube-subs
Command: npx skills add https://github.com/tonyoconnell/agent-ui --skill youtube-subs

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Pull subtitles from YouTube videos and convert them into clean, plain-text transcripts suitable for ingestion by large language models.

Core Features & Use Cases

  • Automated subtitle download for videos, playlists, and channels
  • Transcript cleaning: strip timestamps, deduplicate captions, and reflow text for readability
  • Indexing: output index.tsv with id, title, duration, upload date, and view counts
  • Use Case: learn from lectures, seminars, or podcasts by extracting and summarizing transcripts

Quick Start

Run the fetch script on a YouTube video or playlist to download subtitles and generate clean transcripts in the output directory.

Frequently Asked Questions about youtube-subs

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

FAQPage Schema
How do I extract clean plain-text transcripts from YouTube subtitles for LLM ingestion?

To extract clean plain-text transcripts from YouTube subtitles, this Skill fetches VTT files via yt-dlp and strips timestamps, deduplicates captions, and reflows text. This produces readable transcripts specifically formatted for large language model ingestion.

Can I download subtitles from an entire YouTube playlist or channel at once?

Yes, you can download subtitles from a YouTube playlist or channel at once. The fetch script supports automated batch subtitle downloading for multiple videos, generating clean transcripts and an index.tsv file containing metadata like duration and view counts.

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

Yes, you need yt-dlp, Python 3, and jq installed in a local Bash environment to download YouTube transcripts. These dependencies execute the subtitle fetching and text cleaning scripts required to output the final plain-text files.

Why do YouTube subtitle transcripts contain duplicate lines and how are they cleaned?

YouTube subtitle transcripts contain duplicate lines due to overlapping VTT caption timestamps. The transcript cleaning process strips these timestamps, deduplicates the repeated text, and reflows the remaining characters into continuous plain-text.

What is the best way to summarize learning lectures from YouTube video transcripts?

The best way to summarize learning lectures from YouTube video transcripts is to batch download the subtitles as clean plain-text. This Skill outputs deduplicated text and an index.tsv file, making the content immediately ready for AI summarization.

What metadata is included when extracting transcripts from YouTube videos?

When extracting transcripts from YouTube videos, the Skill generates an index.tsv file containing metadata for each video. This index includes the video ID, title, duration, upload date, and view counts to help organize large-scale learning batches.