universal-video-downloader
// Download videos from YouTube, Instagram, TikTok, Twitter/X, and 1000+ other sites using yt-dlp. Supports quality selection and automatic cleanup. Use when a user provides a video link from any platform and wants to download it.
$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
nameuniversal-video-downloader
descriptionDownload videos from YouTube, Instagram, TikTok, Twitter/X, and 1000+ other sites using yt-dlp. Supports quality selection and automatic cleanup. Use when a user provides a video link from any platform and wants to download it.
metadata[object Object]
Universal Video Downloader
Download videos from almost any platform using the powerful yt-dlp tool.
Features
- Platform Support: YouTube, Instagram, TikTok, Twitter/X, Facebook, and many more.
- Quality Selection: Choose from 144p up to 4K/8K resolutions.
- Automatic Cleanup: Files are deleted from the server immediately after successful upload to the chat.
- Smart Merging: Automatically merges high-quality video and audio streams into a single MP4 file.
Workflow
- Trigger: User sends a video link (e.g., YouTube, Instagram).
- Information Gathering: The agent uses
scripts/download.py infoto fetch available qualities and the video title. - User Choice: The agent presents resolutions to the user and asks which one they prefer.
- Download: Once selected, the agent runs
scripts/download.py downloadwith the specific Format ID. - Delivery: The agent sends the resulting file using the
messagetool withfilePath. - Cleanup: The agent must delete the file from disk using
rmimmediately after the message is successfully sent to save disk space.
Usage for Agents
1. Fetch Video Info
python3 scripts/download.py info "URL"
2. Download Specific Format
python3 scripts/download.py download "URL" "FORMAT_ID"
Safety & Storage
- This skill is intended for temporary processing.
- CRITICAL: Always delete the downloaded file after the user receives it to maintain disk space.