youtube-download
使用 yt-dlp 下载 YouTube 视频。当您需要将视频从 YouTube 下载到本地计算机以供离线观看或处理时,请使用此选项。
📖 中文导读:使用 yt-dlp 下载 YouTube 视频。当您需要将视频从 YouTube 下载到本地计算机以供离线观看或处理时,请使用此选项。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
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