⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

yt-dlp-download-skill

fatelei@fatelei⭐ 1 stars· last commit 20d ago· 0 open issues

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.

—/10

// RATINGS

⭐GitHub Stars
⭐ 1 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

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.

  1. Install
openclaw skills install ./yt-dlp-download-skill
  1. 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.
  • ffmpeg missing 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, and network capabilities. 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 retry
    
  • README.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

// REPO STATS

1 stars
0 open issues
Last commit: 20d ago