youtube-download

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.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill enables seamless YouTube video and audio downloads by leveraging the powerful yt-dlp engine. It allows users to save high-quality content for offline viewing, extract MP3 audio, and manage media files directly through automated commands, supporting various resolutions and custom output templates for efficient media processing.

Use Cases

  • Offline Viewing: Download educational tutorials, webinars, or entertainment videos for access in environments without stable internet connectivity.
  • Audio Extraction: Convert YouTube videos into high-quality MP3 files for personal music libraries or offline podcast listening.
  • Content Archiving: Save important digital content, such as live streams or research presentations, to local storage or NAS for long-term preservation.
  • Creative Workflows: Quickly fetch video assets for research, fair-use commentary, or as reference material for video editing and production.
nameyoutube-download
descriptionDownloads 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.
licenseMIT

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