youtube

name	youtube
description	Download YouTube content — transcripts, captions, subtitles, MP3s, playlists. Triggers on YouTube URLs or 'download', 'transcribe', 'get content from' a video.
allowed-tools	Bash,Read,Write

YouTube

Download and process content from YouTube videos and playlists.

Capabilities

This skill handles two main workflows:

Task	Reference	Use When
Transcripts	references/transcripts.md	User wants captions, subtitles, or text content from a video
Music/MP3s	references/mp3-download.md	User wants to download audio, tag MP3s, or build a music library

Quick Start

For Transcripts

# Check available subtitles
yt-dlp --list-subs "YOUTUBE_URL"

# Download auto-generated subtitles
yt-dlp --write-auto-sub --skip-download -o "transcript" "YOUTUBE_URL"

Load references/transcripts.md for the full workflow including VTT-to-text conversion and Whisper fallback.

For Music/MP3s

# Check playlist info
ytmp3 info "YOUTUBE_URL"

# Download playlist
ytmp3 download "YOUTUBE_URL"

Load references/mp3-download.md for the full tagging and organization workflow.

Prerequisites

• yt-dlp — YouTube downloader (install via brew install yt-dlp)
• eyeD3 — MP3 tagging (install via brew install eye-d3, needed for MP3 workflow)

Workflow Selection

Based on the user's request:

• "transcript", "captions", "subtitles", "transcribe", "text from video" → Load references/transcripts.md
• "download music", "MP3", "playlist", "tag", "album", "music library" → Load references/mp3-download.md

If unclear, ask the user what they want to do with the YouTube content.