yt-dlp-downloader
Download videos from YouTube, Bilibili, Twitter, and thousands of other sites using yt-dlp. Use when the user provides a video URL and wants to download it, extract audio (MP3), download subtitles, or select video quality. Triggers on phrases like "下载视频", "download video", "yt-dlp", "YouTube", "B站",
By mapleshaw · 751 installs
npx skills add mapleshaw/yt-dlp-downloader-skill --skill yt-dlp-downloader
Source repository · Upstream listing
yt dlp Video Downloader
Download videos from thousands of websites using yt dlp.
Prerequisites
Before downloading, verify dependencies are installed:
If not installed, install them first:
Quick Start
Basic Download (Best Quality)
YouTube Download (Recommended with cookies)
YouTube often blocks direct downloads with 403 errors. Always use browser cookies for YouTube:
Supported browsers: chrome , firefox , safari , edge , brave , opera
Download with Custom Output Path
Common Tasks
1. Download Video (Default Best Quality)
2. Extract Audio Only (MP3)
3. Download with Subtitles
4. Download Specific Quality
720p:
1080p:
Best available:
5. List Available Formats (Before Download)
Then download specific format by ID:
6. Download Playlist
7. Download with Thumbnail
Workflow
When user provides a video URL:
1. Identify the platform :
YouTube/YouTube Music → Always use cookies from browser chrome
Other sites → Try without cookies first
2. Ask what they want (if not specified):
Just download the video?
Extract audio only?
Need subtitles?
Specific quality?
3. Construct the command based on requirements
4. Execute the download using Shell tool with required permissions: ["all", "network"]
5. Handle errors :
403 Forbidden → Retry with cookies from browser
Connection issues → yt dlp auto resumes, just retry
Format unavailable → Use F to list formats, then select
6. Report the result file location and any errors
Example Interaction
User: "帮我下载这个视频 https://www.youtube.com/watch?v=xxx"
Response:
User: "下载这个视频的音频 https://www.bilibili.com/video/xxx"
Response:
User: "下载这个 Twitter 视频 https://twitter.com/xxx/status/123"
Response:
Supported Sites
yt dlp supports thousands of sites including:
YouTube, YouTube Music
Bilibili (B站)
Twitter/X
TikTok, Douyin (抖音)
Vimeo
Twitch
And many more...
Full list: https://github.com/yt dlp/yt dlp/blob/master/supportedsites.md
Troubleshooting
Common Errors and Solutions
Error Cause Solution
HTTP 403 Forbidden YouTube blocks unauthenticated requests Use cookies from browser chrome
Video unavailable Geo restricted or private Use cookies or VPN
Download interrupted Network issues Retry yt dlp auto resumes
Format not available Requested format doesn't exist Use F to list formats
Error: "yt dlp: command not found"
Error: "ffmpeg not found" (for audio extraction)
Error: HTTP 403 Forbidden (YouTube)
This is the most common YouTube error. Always use cookies for YouTube:
Supported browsers: chrome , firefox , safari , edge , brave , opera
Error: Video unavailable or geo restricted
Error: Download keeps failing
Best Practices
1. YouTube downloads : Always use cookies from browser chrome
2. Large files : yt dlp auto resumes, just retry if interrupted
3. Keep yt dlp updated : pip install U yt dlp
4. Check formats first : Use F before downloading if unsure