⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
yt-dlp-download-skill
yt-dlp-powered downloader for YouTube, Bilibili, X (Twitter), TikTok/Douyin, and more. Given a video URL, download video (720p/1080p/best), extract MP3/audio-only, fetch subtitles (specify languages), and optionally download playlists; auto-merges audio/video.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
yt-dlp Downloader (OpenClaw)
A standalone OpenClaw-compatible version of the yt-dlp downloader skill. It downloads videos from YouTube, Bilibili, Twitter/X, TikTok/Douyin, Vimeo, Twitch, and more via yt-dlp, with options for audio-only (MP3), subtitles, and quality selection.
Features
- Best-quality video download by default
- Audio extraction (MP3)
- Subtitles (all languages)
- Quality filters (e.g., 720p/1080p)
- Playlist support and format listing
Directory
yt-dlp-download-skill
├── SKILL.md # OpenClaw skill instructions + gating/installer metadata
├── skill.yaml # OpenClaw manifest (name/version/permissions/entryPoint)
└── scripts/
└── download.sh # Optional helper wrapper for advanced usage
Prerequisites
- yt-dlp (required)
- ffmpeg (recommended for audio extraction and format merging)
This skill declares installer metadata so the OpenClaw UI/CLI can assist with installing yt-dlp and (on macOS) ffmpeg. Installing dependencies downloads packages and changes the local environment; the agent must have installation authorization before proceeding.
Install (local)
Install the skill into your OpenClaw instance. This writes persistent skill files for future use; it does not create a background service or scheduled job.
- Install
openclaw skills install ./yt-dlp-download-skill
- Verify
openclaw skills list
Optional: Enable via config (JSON5)
~/.openclaw/openclaw.json:
{
skills: {
entries: {
"yt-dlp-download-skill": { enabled: true }
}
}
}
Usage
Ask your agent to download or extract media by providing a URL. Examples:
- Best quality
Download this video https://www.youtube.com/watch?v=xxx
- Audio-only (MP3)
Extract audio from https://www.bilibili.com/video/xxx
- With subtitles
Download with subtitles https://twitter.com/xxx/status/123
- Specific quality
Download 720p https://www.tiktok.com/@user/video/xxx
The agent announces network access and the destination, then invokes scripts/download.sh. Downloads use anonymous access, ignore local yt-dlp configuration, and default to a single video. Playlists require an explicit request.
Configuration
The skill accepts an optional download_path config key (default ~/Downloads/yt-dlp). You can override it via OpenClaw config or at request time by explicitly specifying a safe output directory.
Uninstall / Update
- Uninstall:
openclaw skills uninstall yt-dlp-download-skill - Update (local path): re-run
openclaw skills install ./yt-dlp-download-skill
Troubleshooting
- YouTube 403 or login required → report the failure; never automatically switch to browser authentication. See the session-data policy below.
ffmpegmissing when extracting audio → install ffmpeg (Homebrew on macOS or your distro package manager on Linux).- Format not found → list first with
bash scripts/download.sh --list -- URL, then choose a specific format.
Security Notes
- The helper validates HTTP(S) URLs and passes arguments directly to yt-dlp without
eval. It disables local yt-dlp configuration so saved options cannot silently enable authentication or execution hooks. - Browser cookies can contain sensitive account sessions. A separate authenticated download requires an explanation and explicit authorization for the target and browser/profile. Matching cookies are sent to the requested service; cookie stores must never be printed, exported, or uploaded. The helper does not support authentication options.
- Downloads contact the requested site and its media hosts and write to the announced output directory. Avoid sharing URLs containing private access tokens; the helper does not echo the full command, but yt-dlp may include URLs in diagnostics.
- The manifest declares
shell,filesystem, andnetworkcapabilities. These are broad capability categories, not path or host restrictions; actual restrictions depend on the execution sandbox. Keep access scoped to the download and do not grant blanket or elevated permissions. - No automatic dependency installation, scheduled jobs, startup changes, or self-modification is part of the download workflow.
Local verification
Run the offline regression tests with python3 -m unittest discover -s tests -v. They use a fake yt-dlp executable and temporary directories; no media or browser sessions are accessed.
// HOW IT'S BUILT
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
SKILL.md2.7 KBupstream ↗
--- name: yt-dlp-download-skill description: yt-dlp-powered downloader for YouTube, Bilibili, X (Twitter), TikTok/Douyin, and more. Given a video URL, download video (720p/1080p/best), extract MP3/audio-only, fetch subtitles (specify languages), and optionally download playlists; auto-merges audio/video. metadata: openclaw: emoji: "⬇️" os: ["darwin", "linux", "win32"] requires: bins: ["yt-dlp"] anyBins: ["ffmpeg"] install: - id: uv-yt-dlp kind: uv package: "yt-dlp" bins: ["yt-dlp"] label: "Install yt-dlp (uv/pipx)" - id: brew-ffmpeg kind: brew formula: "ffmpeg" bins: ["ffmpeg"] os: ["darwin"] label: "Install ffmpeg (brew)" --- # yt-dlp Video Downloader (OpenClaw) Use yt-dlp to download videos from thousands of sites. ## When to use - User shares a video URL and asks to download - User requests audio-only (MP3) extraction - User needs subtitles or specific quality ## Safety - Never execute arbitrary shell built from untrusted text; always validate URL scheme (http/https only) - Prefer the default download path under the user Downloads directory unless a safe path is explicitly provided ## Quick checks - Ensure `yt-dlp` exists on PATH; if missing, use installer metadata to guide installation - For MP3 extraction, `ffmpeg` is recommended; proceed with a warning if unavailable ## Common commands - Best available quality ```bash yt-dlp -P "~/Downloads/yt-dlp" "VIDEO_URL" ``` - YouTube with cookies (avoid 403) ```bash yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "YOUTUBE_URL" ``` - Extract audio (MP3) ```bash yt-dlp -P "~/Downloads/yt-dlp" -x --audio-format mp3 "VIDEO_URL" ``` - With subtitles (all languages) ```bash yt-dlp -P "~/Downloads/yt-dlp" --write-subs --sub-langs all "VIDEO_URL" ``` - Specific quality (720p / 1080p) ```bash yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo[height<=720]+bestaudio/best[height<=720]" "VIDEO_URL" ``` ```bash yt-dlp -P "~/Downloads/yt-dlp" -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" "VIDEO_URL" ``` - List formats, then pick one ```bash yt-dlp -F "VIDEO_URL" yt-dlp -P "~/Downloads/yt-dlp" -f FORMAT_ID "VIDEO_URL" ``` ## Workflow 1. Detect platform (YouTube often needs `--cookies-from-browser chrome`) 2. Ask for intent if unclear (video vs audio, subs, quality, output directory) 3. Build a safe command (http/https URL, sanitize output path) 4. Execute using the system exec tool 5. Report saved path and any errors; suggest `-F` on format errors ## Troubleshooting - 403 on YouTube → add `--cookies-from-browser chrome` - Missing ffmpeg for audio → warn and suggest installing ffmpeg - Interrupted downloads → yt-dlp auto-resumes on retryREADME.mdupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/fatelei-yt-dlp-download-skill.md