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.
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.
| name | youtube-download |
|---|---|
| description | 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. |
| license | MIT |
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 (providesuvxcommand)
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
~/Downloadsbut can be changed based on user preference - MP3 downloads go to
~/Library/CloudStorage/SynologyDrive-sync/music/(Synology NAS music folder) uvxensures you always have the latestyt-dlpversion without manual updates- YouTube URLs should be quoted to handle special characters