youtube-downloader

Download YouTube videos and audio with configurable quality and format options.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/johsquaree/claude-basic-docs --skill youtube-downloader-johsquaree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: youtube-downloader
Source: https://github.com/johsquaree/claude-basic-docs/tree/main/.claude/skills/video-downloader
Command: npx skills add https://github.com/johsquaree/claude-basic-docs --skill youtube-downloader-johsquaree

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yt-dlp, and includes scripts (resource) components.

What problem does it solve? Downloading YouTube videos manually requires navigating third-party websites or complex command-line tools. This Skill wraps yt-dlp in a simple script that handles installation, quality selection, format conversion, and audio extraction automatically. ## Core Features & Use Cases - Quality Control: Choose from best, 1080p, 720p, 480p, 360p, or worst quality settings to balance file size and resolution. - Format Selection: Output videos as MP4, WebM, or MKV, or extract audio-only as MP3. - Automatic Setup: Installs yt-dlp automatically if missing and fetches video metadata (title, duration, uploader) before downloading. - Use Case: Save a tutorial video in 720p MP4 for offline viewing, or extract just the audio from a lecture as an MP3 for listening on the go. ## Quick Start Ask the AI to download a YouTube video by providing its URL, optionally specifying quality, format, or audio-only mode.

Frequently Asked Questions about youtube-downloader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download a YouTube video from the command line?

Run the download script with the video URL: python scripts/download_video.py "URL". It uses yt-dlp to fetch the best quality video as MP4 and saves it to the output directory, installing yt-dlp automatically if needed.

How to extract audio from a YouTube video as MP3?

Use the -a or --audio-only flag with the download script. This tells yt-dlp to extract the audio track and convert it to MP3 at the best available quality, skipping the video stream entirely.

What video quality options does yt-dlp support?

This script supports best, 1080p, 720p, 480p, 360p, and worst. For specific resolutions, it selects the best video stream at or below the requested height and merges it with the best audio stream.

Can I download an entire YouTube playlist with this script?

No, the script passes --no-playlist to yt-dlp, so only single videos are downloaded. If you paste a playlist URL, only the individual video is fetched and playlist entries are skipped.

Why does the YouTube download fail with a format error?

Failures typically occur when the requested resolution is unavailable for that video or yt-dlp is outdated. The script selects streams at or below the requested height to reduce this, and reinstalling yt-dlp often resolves extraction errors.