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 (up to 4K) using PO token providers or browser cookies
• 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.md FIRST: 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.

Non-Technical User Experience (Default)