youtube-transcript

Download YouTube video transcripts and convert VTT subtitles into timestamped Markdown.

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/Jansen611/Agent-Skills --skill youtube-transcript-jansen611
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: youtube-transcript
Source: https://github.com/Jansen611/Agent-Skills/tree/main/skills/youtube-transcript
Command: npx skills add https://github.com/Jansen611/Agent-Skills --skill youtube-transcript-jansen611

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of getting readable text from YouTube videos when you need captions, subtitles, or a transcript for analysis, quoting, or note-taking.

Core Features & Use Cases

  • Subtitle discovery first: Lists available subtitle languages/tracks before downloading so you use the best available option.
  • Manual then auto fallback: Prefers human-created subtitles, falls back to auto-generated captions, and only uses Whisper if no subtitles exist with confirmation.
  • Timestamped transcript output: Converts downloaded VTT into a clean Markdown transcript with per-line timestamps and a source link.
  • Practical use cases: Turn a talk or interview into searchable text, extract quotes, and generate notes from a specific video.

Quick Start

Ask the skill to download the transcript for the provided YouTube URL and output a timestamped Markdown file with the video link as the first line.

Frequently Asked Questions about youtube-transcript

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

FAQPage Schema
How do I download YouTube captions and convert VTT to a Markdown transcript?▼

To download YouTube captions and convert VTT to a Markdown transcript, the Skill fetches available subtitle tracks, downloads the VTT file, and uses a local conversion script to produce timestamped text. It outputs a clean Markdown file with per-line timestamps and the source video link.

How does subtitle discovery work when fetching a YouTube video transcript?▼

Subtitle discovery works by listing all available subtitle languages and tracks before downloading the YouTube video transcript. This ensures you can select the best available option, prioritizing human-created subtitles over auto-generated captions.

Do I need yt-dlp installed to download YouTube subtitles?▼

Yes, you need yt-dlp installed to download YouTube subtitles, as the Skill relies on it to fetch available tracks. The tool resolves yt-dlp availability via the system PATH or a shared virtual environment.

What happens if a YouTube video has no manual subtitles?▼

If a YouTube video has no manual subtitles, the Skill falls back to downloading auto-generated captions to produce the transcript. If no subtitles exist at all, it only uses Whisper transcription after confirming with the user.

Can I extract quotes and searchable text from a YouTube interview?▼

Yes, you can extract quotes and searchable text from a YouTube interview by downloading its captions and converting them into a timestamped Markdown transcript. This format makes it easy to search content and pull specific quotations for notes.

Are there limitations when transcribing YouTube videos without available subtitles?▼

Yes, a limitation exists when transcribing YouTube videos without available subtitles, as the Skill cannot automatically generate text from audio alone. It requires explicit user confirmation to invoke Whisper as a fallback for auto-generated transcription.