name: aio-youtube
description: |
Search YouTube and extract video transcripts/subtitles/metadata via yt-dlp. Use whenever the user mentions a youtube.com URL, asks to summarize a video, pull a transcript, fetch video metadata, list a channel/playlist, or download subtitles in any language.
when_to_use: search YouTube, get transcript, summarize video, extract subtitles, youtube.com, yt-dlp, video transcript, YouTube search, video metadata, playlist, channel videos, video chapters, youtube.com URLs
effort: medium
argument-hint:
YouTube
Environment
- yt-dlp: !
which yt-dlp 2>/dev/null || echo "NOT INSTALLED"
- jq: !
which jq 2>/dev/null || echo "NOT INSTALLED"
- curl: !
which curl 2>/dev/null || echo "NOT INSTALLED"
- Scripts: !
echo "${CLAUDE_PLUGIN_ROOT}/skills/aio-youtube/scripts"
YT="${CLAUDE_PLUGIN_ROOT}/skills/aio-youtube/scripts"
Then call scripts as: $YT/yt-search "query"
Scripts
| Script |
Usage |
Description |
yt-search |
yt-search "query" [N] [--date] |
Search N videos (default 5), --date sorts by date |
yt-transcript |
yt-transcript "URL" [lang] [output] |
Get clean transcript (default: en, /tmp/transcript-clean.txt) |
yt-meta |
yt-meta "URL" [--full] |
Get metadata, --full includes description/chapters |
yt-channel |
yt-channel "@Name" [N] |
Get N recent videos from channel |
yt-playlist |
yt-playlist "URL" [--duration] |
List videos, --duration shows total time |
yt-chapters |
yt-chapters "URL" |
Get video chapters/timestamps |
yt-links |
yt-links "URL" [--github] |
Extract links from description |
Quick Examples
# Resolve scripts path first
YT="${CLAUDE_PLUGIN_ROOT}/skills/aio-youtube/scripts"
# Search
$YT/yt-search "react hooks tutorial" 10
$YT/yt-search "typescript 2025" --date
# Get transcript
$YT/yt-transcript "https://youtube.com/watch?v=xxx"
# Then read /tmp/transcript-clean.txt
# Video info
$YT/yt-meta "URL" --full
$YT/yt-chapters "URL"
# Channel/Playlist
$YT/yt-channel "@ThePrimeagen" 5
$YT/yt-playlist "PLAYLIST_URL" --duration
Use Cases
Summarize Video Before Watching
$YT/yt-meta "URL"
$YT/yt-transcript "URL"
# Read /tmp/transcript-clean.txt, provide:
# - Main topic, Key points (3-5), Who should watch, Skip recommendation
Research a Topic
$YT/yt-search "topic" 5
# Pick 2-3 relevant videos, get transcripts
$YT/yt-transcript "URL1"
$YT/yt-transcript "URL2"
# Synthesize: consensus points, different perspectives, recommended deep-dive
Extract Tutorial Steps
$YT/yt-chapters "URL"
$YT/yt-transcript "URL"
# Extract: Prerequisites, Step-by-step instructions, Common mistakes, Tips
Compare Multiple Videos
$YT/yt-search "controversial topic" 8
# Get transcripts from different viewpoints
# Present: Position A, Position B, Disagreements, Agreements
Programming Tutorial
$YT/yt-meta "URL" --full
$YT/yt-links "URL" --github
$YT/yt-transcript "URL"
# Extract: Code blocks, Dependencies, Config steps
Errors
| Error |
Fix |
| No subtitles for language |
Script shows available languages |
| Private video |
Not accessible |
| Age-restricted |
Sign-in required |
By