SKILL.md
YouTube Downloader
Overview
Enable reliable video and audio downloads from YouTube and HLS streaming platforms (Mux, Vimeo, etc.) using yt-dlp and ffmpeg. This skill provides workflows for:
- YouTube downloads at available quality, with optional PO token and authorized cookie recovery
- HLS stream downloads with authentication headers
- Handling protected content and troubleshooting common download failures
Goal Split: File vs. Text (Read First)
Before downloading anything, classify the request:
- User wants the video/audio file itself (save it, edit it, watch offline) → continue with the download flow below, unchanged.
- User wants the spoken content as text (transcript, subtitles, meeting notes, archive, "what was said") → follow
references/text-first.mdFIRST: existing archived transcripts → platform transcript APIs → yt-dlp subtitle-only → authorized audio track + ASR. Do not download the full video just to obtain text.
The text-first route never blocks a file request: when the user wants the file, download it with the unchanged flow below.