← Back to Skills Marketplace
download-video
by
Pengfei Ni
· GitHub ↗
· v1.0.1
· MIT-0
89
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install feiskyer-download-video
Description
Download videos from 1000+ websites (YouTube, Bilibili, Twitter/X, TikTok, Vimeo, Instagram, Twitch, etc.) using yt-dlp. Use this skill whenever a user share...
README (SKILL.md)
Download Video
Download videos from YouTube, Bilibili, Twitter/X, TikTok, and 1000+ other sites using yt-dlp.
Step 1: Check prerequisites
which yt-dlp && yt-dlp --version
which ffmpeg
If yt-dlp is missing, install it:
# macOS
brew install yt-dlp ffmpeg
# Cross-platform
pip install yt-dlp
Step 2: Download
Use the bundled script — it wraps yt-dlp with sensible defaults and clear error messages.
python3 scripts/download.py "VIDEO_URL"
Default output: ~/Downloads/Videos/
Common options
python3 scripts/download.py "URL" -f 1080 # Max 1080p
python3 scripts/download.py "URL" -a # Audio only (MP3)
python3 scripts/download.py "URL" -F # List formats
python3 scripts/download.py "URL" --subs # With subtitles
python3 scripts/download.py "URL" -o ~/Desktop # Custom output dir
python3 scripts/download.py "URL" --cookies chrome # Use browser cookies
Direct yt-dlp commands
For cases the script doesn't cover, use yt-dlp directly:
# Download playlist
yt-dlp -P ~/Downloads/Videos "PLAYLIST_URL"
# Custom filename template
yt-dlp -o "%(uploader)s - %(title)s.%(ext)s" "VIDEO_URL"
# Download with subtitles in specific languages
yt-dlp --write-subs --sub-lang zh,en -P ~/Downloads/Videos "VIDEO_URL"
Troubleshooting
Most download failures fall into these categories:
| Symptom | Fix |
|---|---|
| "Sign in required" or age-restricted | Add --cookies chrome to use browser session |
| Only low quality available | Update yt-dlp (brew upgrade yt-dlp), then try with --cookies chrome |
| Slow downloads | Try --concurrent-fragments 3 or --downloader aria2c |
| Network errors (behind firewall) | Use --proxy socks5://127.0.0.1:1080 or set ALL_PROXY env var |
For platform-specific details (YouTube PO tokens, Bilibili series, TikTok watermark removal, etc.), see references/platform-tips.md.
Usage Guidance
This skill is a thin wrapper around yt-dlp and is internally consistent. Before installing/using it: 1) ensure you install yt-dlp/ffmpeg from trusted sources (brew or pip from reputable indexes); 2) be cautious when using --cookies-from-browser — it grants yt-dlp access to your browser session cookies (which can include auth tokens); only use that with trusted local environments and avoid posting exported cookies; 3) the references mention installing a third-party plugin (bgutil-ytdlp-pot-provider) — verify its trustworthiness before installing; 4) respect copyright and site terms of service when downloading content; and 5) the included script invokes yt-dlp via subprocess with argument lists (no shell), which reduces shell-injection risk, but always be careful with untrusted URLs or running commands on shared systems.
Capability Analysis
Type: OpenClaw Skill
Name: feiskyer-download-video
Version: 1.0.1
The skill is a functional wrapper for the yt-dlp utility, providing capabilities to download videos and extract audio. It is classified as suspicious because it includes high-risk behaviors such as accessing sensitive browser cookies (--cookies-from-browser) and performing arbitrary file writes to the local filesystem, which are explicitly listed as risky capabilities in the analysis criteria. While these features are plausibly needed for the stated purpose (e.g., bypassing age restrictions), the script (scripts/download.py) and documentation (SKILL.md, references/platform-tips.md) facilitate access to user credentials and external network resources without additional safeguards.
Capability Assessment
Purpose & Capability
Name/description (download videos using yt-dlp) matches the included script and SKILL.md. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
Runtime instructions stay within the expected scope (check for yt-dlp/ffmpeg, run provided Python wrapper or yt-dlp directly). Note: the docs and script recommend using yt-dlp's --cookies-from-browser which will access browser session cookies (expected for authenticated downloads) and reference installing an optional third-party plugin for PO tokens — both are outside the core download logic and should be used with caution.
Install Mechanism
No install spec included (instruction-only). The skill includes a small Python script only; it does not download arbitrary archives or install executables itself.
Credentials
The skill does not request environment variables or credentials. It suggests use of ALL_PROXY or browser cookies for certain cases — these are reasonable optional suggestions for network/proxy or authenticated downloads but are not required by the skill.
Persistence & Privilege
No elevated persistence requested. always is false and the skill does not modify other skills or system-wide config.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install feiskyer-download-video - After installation, invoke the skill by name or use
/feiskyer-download-video - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Expanded skill description to clarify supported video platforms and common user triggers.
- Improved usage documentation with clear step-by-step instructions for checking prerequisites, installing dependencies, and downloading videos.
- Added sample command-line options for audio extraction, format selection, subtitles, custom output directories, and using browser cookies.
- Provided troubleshooting guidance for common download issues and platform-specific tips.
- Included instructions for both the bundled script and advanced yt-dlp usage.
v1.0.0
- Initial release of the "download-video" skill.
- Download videos from 1000+ sites including YouTube, Bilibili, Twitter/X, TikTok, Vimeo, Instagram, and Twitch using yt-dlp.
- Supports video and audio extraction, playlist downloads, subtitle fetching, and custom output options.
- Provides troubleshooting tips for common issues (logins, quality, network).
- Triggers on relevant keywords or any supported video URL.
Metadata
Frequently Asked Questions
What is download-video?
Download videos from 1000+ websites (YouTube, Bilibili, Twitter/X, TikTok, Vimeo, Instagram, Twitch, etc.) using yt-dlp. Use this skill whenever a user share... It is an AI Agent Skill for Claude Code / OpenClaw, with 89 downloads so far.
How do I install download-video?
Run "/install feiskyer-download-video" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is download-video free?
Yes, download-video is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does download-video support?
download-video is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created download-video?
It is built and maintained by Pengfei Ni (@feiskyer); the current version is v1.0.1.
More Skills