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.