← Back to Skills Marketplace
65
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install download-video
Description
Use when the user wants to download a YouTube or Bilibili video by URL or title, saving to local Videos folder
README (SKILL.md)
Download Video (YouTube / Bilibili)
Overview
Use yt-dlp to download videos from YouTube or Bilibili. Downloads go to the user's Videos folder (~/Videos).
Prerequisites
yt-dlp must be installed:
yt-dlp --version
# Install if missing
pip install yt-dlp # cross-platform
winget install yt-dlp # Windows
brew install yt-dlp # macOS
sudo apt install yt-dlp # Debian/Ubuntu
ffmpeg is recommended for merging video+audio streams.
Download by URL
yt-dlp -o "\x3Cvideos-dir>/%(title)s.%(ext)s" "\x3Curl>"
Replace \x3Cvideos-dir> with the user's Videos folder path, and \x3Curl> with the video URL.
Supported URLs:
- YouTube:
https://www.youtube.com/watch?v=...orhttps://youtu.be/... - Bilibili:
https://www.bilibili.com/video/BV...
Download by Title (search)
# YouTube
yt-dlp -o "\x3Cvideos-dir>/%(title)s.%(ext)s" "ytsearch1:\x3Ctitle>"
# Bilibili
yt-dlp -o "\x3Cvideos-dir>/%(title)s.%(ext)s" "bilisearch1:\x3Ctitle>"
Quick Reference
| Goal | Flag |
|---|---|
| Best quality (default) | -f bestvideo+bestaudio/best |
| Audio only (mp3) | -x --audio-format mp3 |
| Specific resolution | -f "bestvideo[height\x3C=720]+bestaudio" |
| Subtitles | --write-subs --sub-langs zh-Hans,en |
| Playlist (all videos) | just pass the playlist URL |
| Limit speed | --rate-limit 2M |
Common Mistakes
- "ffmpeg not found" — merge of best video+audio fails. Install ffmpeg or use
-f best(single stream). - Bilibili login-required content — add cookies with
--cookies-from-browser chrome. - Videos folder missing — create it first.
Workflow
- URL given → download directly
- Title given → use
ytsearch1:orbilisearch1:prefix - yt-dlp missing → install, then retry
- Error → read error message, check Common Mistakes above
Usage Guidance
Install only if you want the agent to run yt-dlp commands on your machine. Approve any package installation first, confirm large playlist downloads, and avoid --cookies-from-browser unless you understand that it uses your browser login session; a dedicated browser profile or limited cookies file is safer.
Capability Assessment
Purpose & Capability
The skill is coherent with its stated purpose of downloading YouTube or Bilibili videos to the local Videos folder, but it also documents playlist downloads that can create many local files.
Instruction Scope
The instructions are direct command examples and workflow guidance; there is no evidence of hidden prompt control, goal hijacking, or unrelated autonomous behavior.
Install Mechanism
There is no install spec and no declared required binaries, but SKILL.md tells the user or agent to install yt-dlp through package managers if missing. This is purpose-aligned but should require user approval.
Credentials
Saving downloads to ~/Videos is scoped, but the suggested --cookies-from-browser chrome option uses local browser session cookies for login-required Bilibili content without clearly bounding profile, cookie scope, destination, or credential handling.
Persistence & Privilege
No background persistence is shown, but package installation commands, including sudo apt install, would make persistent changes to the local environment and may require elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install download-video - After installation, invoke the skill by name or use
/download-video - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Download YouTube and Bilibili videos by URL or title to the local Videos folder.
- Downloads videos using yt-dlp, supporting both YouTube and Bilibili.
- Supports direct URL download and automatic search by video title.
- Includes quick-reference commands for video/audio format, resolution, subtitles, playlist, and speed limit.
- Troubleshooting section covers common issues like missing ffmpeg, login requirements, and folder setup.
Metadata
Frequently Asked Questions
What is Download Video?
Use when the user wants to download a YouTube or Bilibili video by URL or title, saving to local Videos folder. It is an AI Agent Skill for Claude Code / OpenClaw, with 65 downloads so far.
How do I install Download Video?
Run "/install 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 ZZLupus (@zzlupus); the current version is v1.0.0.
More Skills