youtube-downloader

Use it when:: You want a YouTube video saved to disk, or only its audio.
It does:: Runs a Python script that has yt-dlp pick the best streams for your settings and merge video and audio.
You get:: One file named after the video's title, in /mnt/user-data/outputs/ unless you pass -o: MP4, WebM or MKV from 360p up to the best available, or an MP3.
Needs:: Python; if yt-dlp is missing, the script installs it with pip install --break-system-packages, without asking.
Skips:: Playlists: it downloads single videos only.

Its script installs yt-dlp with pip --break-system-packages when it's missing, without asking, and saves to /mnt/user-data/outputs/ unless you pass -o.

TL;DR

A thin wrapper around yt-dlp. The agent runs scripts/download_video.py with the video's URL and your options: -q for quality (best by default, 1080p, 720p, 480p, 360p or worst), -f for the container (MP4 by default, WebM or MKV), -a for audio only as MP3, and -o for the output folder. If yt-dlp isn't installed, the script installs it without asking, running pip with --break-system-packages, a flag that overrides the guard against pip installing into a Python your operating system manages. It then prints the video's title, length and uploader, downloads the matching streams and merges video and audio when needed. Files are named from the video's title and land in /mnt/user-data/outputs/ unless you name another folder. Playlists are skipped. Its frontmatter names it youtube-downloader.

Summarizes the skill at be2a406.

npx skills add https://github.com/ComposioHQ/awesome-claude-skills --skill youtube-downloader

skills.sh page Source on GitHub All skills from ComposioHQ/awesome-claude-skills

Total Downloads: 6,300 on skills.sh, Nov 9, 2026
Repo stars: 79,081 ComposioHQ/awesome-claude-skills
First seen: Jan 20, 2026 on skills.sh

Weekly Downloads

119

+14% over the 8 weeks to Nov 9

Weekly values

Week to	Installs
Sep 21	104
Sep 28	103
Oct 5	151
Oct 12	123
Oct 19	116
Oct 26	111
Nov 2	127
Nov 9	119

Category	category:media Generate and edit video, images and audio.
Type	type:tool Operates a CLI, API, app or bundled script to get something done.
Effect	effect:local Its own steps create or change files, git state or local tools.
Needs	needs:cli A specific command-line tool or desktop app must be installed, such as gh, agent-browser, LibreOffice, Obsidian or a vendor CLI.
Publisher	by:official A verified publisher on skills.sh, or the company or maintainer behind the product the skill operates.
Topics	video audio
Stack	stack:youtube stack:yt-dlp stack:python

SKILL.md

From ComposioHQ/awesome-claude-skills at be2a406. Checked daily, last changed Nov 6, 2026.

Frontmatter

name: youtube-downloader
description: Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

YouTube Video Downloader

Download YouTube videos with full control over quality and format settings.

Quick Start

The simplest way to download a video:

python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"

This downloads the video in best available quality as MP4 to /mnt/user-data/outputs/.

Options

Quality Settings

Use -q or --quality to specify video quality:

best (default): Highest quality available
1080p: Full HD
720p: HD
480p: Standard definition
360p: Lower quality
worst: Lowest quality available

Example:

python scripts/download_video.py "URL" -q 720p

Format Options

Use -f or --format to specify output format (video downloads only):

mp4 (default): Most compatible
webm: Modern format
mkv: Matroska container

Example:

python scripts/download_video.py "URL" -f webm

Audio Only

Use -a or --audio-only to download only audio as MP3:

python scripts/download_video.py "URL" -a

Custom Output Directory

Use -o or --output to specify a different output directory:

python scripts/download_video.py "URL" -o /path/to/directory

Complete Examples

Download video in 1080p as MP4:

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p

Download audio only as MP3:

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a

Download in 720p as WebM to custom directory:

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path

How It Works

The skill uses yt-dlp, a robust YouTube downloader that:

Automatically installs itself if not present
Fetches video information before downloading
Selects the best available streams matching your criteria
Merges video and audio streams when needed
Supports a wide range of YouTube video formats

Important Notes

Downloads are saved to /mnt/user-data/outputs/ by default
Video filename is automatically generated from the video title
The script handles installation of yt-dlp automatically
Only single videos are downloaded (playlists are skipped by default)
Higher quality videos may take longer to download and use more disk space