OpenParable
Skip to content
← Back to skills

Youtube Download

Documents
youtube-download

Youtube Download is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Downloads a YouTube video using yt-dlp. Use this when you need to download a video from YouTube to the local machine for offline viewing or processing.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/development/youtube-download/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/youtube-download, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

YouTube Video Downloader

This skill downloads YouTube videos using yt-dlp, always using the latest version via uvx.

Usage

Download a video to the default location (~/Downloads):

uvx yt-dlp -o "~/Downloads/%(title)s.%(ext)s" "VIDEO_URL"

Download to a custom location:

uvx yt-dlp -o "/path/to/folder/%(title)s.%(ext)s" "VIDEO_URL"

Requirements

  • uv - The Python package runner (provides uvx command)

No pre-installation of yt-dlp is needed. The uvx command automatically fetches and runs the latest version.

Common Options

Download best quality (default):

uvx yt-dlp -o "~/Downloads/%(title)s.%(ext)s" "VIDEO_URL"

Download audio only (mp3) - downloads to Synology music folder:

uvx yt-dlp -x --audio-format mp3 -o "~/Library/CloudStorage/SynologyDrive-sync/music/%(title)s.%(ext)s" "VIDEO_URL"

Download specific quality (e.g., 720p):

uvx yt-dlp -f "bestvideo[height<=720]+bestaudio/best[height<=720]" -o "~/Downloads/%(title)s.%(ext)s" "VIDEO_URL"

List available formats:

uvx yt-dlp -F "VIDEO_URL"

Output Template

The -o flag uses a template for the output filename:

  • %(title)s - Video title
  • %(ext)s - File extension
  • %(id)s - Video ID
  • %(uploader)s - Channel name

Notes

  • The default output format is webm (what YouTube natively provides for best quality)
  • The download location defaults to ~/Downloads but can be changed based on user preference
  • MP3 downloads go to ~/Library/CloudStorage/SynologyDrive-sync/music/ (Synology NAS music folder)
  • uvx ensures you always have the latest yt-dlp version without manual updates
  • YouTube URLs should be quoted to handle special characters