{
  "schemaVersion": "1.0",
  "item": {
    "slug": "yt-dlp-downloader-skill",
    "name": "Yt Dlp Downloader",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/apollo1234/yt-dlp-downloader-skill",
    "canonicalUrl": "https://clawhub.ai/apollo1234/yt-dlp-downloader-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/yt-dlp-downloader-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yt-dlp-downloader-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/yt-dlp-downloader-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/yt-dlp-downloader-skill",
    "agentPageUrl": "https://openagent3.xyz/skills/yt-dlp-downloader-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/yt-dlp-downloader-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/yt-dlp-downloader-skill/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "yt-dlp Video Downloader",
        "body": "Download videos from thousands of websites using yt-dlp."
      },
      {
        "title": "Prerequisites",
        "body": "Before downloading, verify dependencies are installed:\n\n# Check yt-dlp\nwhich yt-dlp || echo \"yt-dlp not installed. Install with: pip install yt-dlp\"\n\n# Check ffmpeg (required for audio extraction and format merging)\nwhich ffmpeg || echo \"ffmpeg not installed. Install with: brew install ffmpeg\"\n\nIf not installed, install them first:\n\npip install yt-dlp\nbrew install ffmpeg  # macOS"
      },
      {
        "title": "Basic Download (Best Quality)",
        "body": "yt-dlp -P \"~/Downloads/yt-dlp\" \"VIDEO_URL\""
      },
      {
        "title": "YouTube Download (Recommended - with cookies)",
        "body": "YouTube often blocks direct downloads with 403 errors. Always use browser cookies for YouTube:\n\nyt-dlp -P \"~/Downloads/yt-dlp\" --cookies-from-browser chrome \"YOUTUBE_URL\"\n\nSupported browsers: chrome, firefox, safari, edge, brave, opera"
      },
      {
        "title": "Download with Custom Output Path",
        "body": "yt-dlp -P \"/path/to/save\" -o \"%(title)s.%(ext)s\" \"VIDEO_URL\""
      },
      {
        "title": "1. Download Video (Default - Best Quality)",
        "body": "yt-dlp -P \"~/Downloads/yt-dlp\" \"VIDEO_URL\""
      },
      {
        "title": "2. Extract Audio Only (MP3)",
        "body": "yt-dlp -P \"~/Downloads/yt-dlp\" -x --audio-format mp3 \"VIDEO_URL\""
      },
      {
        "title": "3. Download with Subtitles",
        "body": "yt-dlp -P \"~/Downloads/yt-dlp\" --write-subs --sub-langs all \"VIDEO_URL\""
      },
      {
        "title": "4. Download Specific Quality",
        "body": "720p:\n\nyt-dlp -P \"~/Downloads/yt-dlp\" -f \"bestvideo[height<=720]+bestaudio/best[height<=720]\" \"VIDEO_URL\"\n\n1080p:\n\nyt-dlp -P \"~/Downloads/yt-dlp\" -f \"bestvideo[height<=1080]+bestaudio/best[height<=1080]\" \"VIDEO_URL\"\n\nBest available:\n\nyt-dlp -P \"~/Downloads/yt-dlp\" -f \"bestvideo+bestaudio/best\" \"VIDEO_URL\""
      },
      {
        "title": "5. List Available Formats (Before Download)",
        "body": "yt-dlp -F \"VIDEO_URL\"\n\nThen download specific format by ID:\n\nyt-dlp -P \"~/Downloads/yt-dlp\" -f FORMAT_ID \"VIDEO_URL\""
      },
      {
        "title": "6. Download Playlist",
        "body": "# Download entire playlist\nyt-dlp -P \"~/Downloads/yt-dlp\" -o \"%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s\" \"PLAYLIST_URL\"\n\n# Download specific range (e.g., items 1-5)\nyt-dlp -P \"~/Downloads/yt-dlp\" -I 1:5 \"PLAYLIST_URL\""
      },
      {
        "title": "7. Download with Thumbnail",
        "body": "yt-dlp -P \"~/Downloads/yt-dlp\" --write-thumbnail \"VIDEO_URL\""
      },
      {
        "title": "Workflow",
        "body": "When user provides a video URL:\n\nIdentify the platform:\n\nYouTube/YouTube Music → Always use --cookies-from-browser chrome\nOther sites → Try without cookies first\n\n\n\nAsk what they want (if not specified):\n\nJust download the video?\nExtract audio only?\nNeed subtitles?\nSpecific quality?\n\n\n\nConstruct the command based on requirements\n\n\nExecute the download using Shell tool with required_permissions: [\"all\", \"network\"]\n\n\nHandle errors:\n\n403 Forbidden → Retry with --cookies-from-browser\nConnection issues → yt-dlp auto-resumes, just retry\nFormat unavailable → Use -F to list formats, then select\n\n\n\nReport the result - file location and any errors"
      },
      {
        "title": "Example Interaction",
        "body": "User: \"帮我下载这个视频 https://www.youtube.com/watch?v=xxx\"\n\nResponse:\n\n# YouTube - use cookies to avoid 403 errors\nyt-dlp -P \"~/Downloads/yt-dlp\" --cookies-from-browser chrome \"https://www.youtube.com/watch?v=xxx\"\n\nUser: \"下载这个视频的音频 https://www.bilibili.com/video/xxx\"\n\nResponse:\n\n# Bilibili - extracting audio as MP3\nyt-dlp -P \"~/Downloads/yt-dlp\" -x --audio-format mp3 \"https://www.bilibili.com/video/xxx\"\n\nUser: \"下载这个 Twitter 视频 https://twitter.com/xxx/status/123\"\n\nResponse:\n\n# Twitter/X - direct download usually works\nyt-dlp -P \"~/Downloads/yt-dlp\" \"https://twitter.com/xxx/status/123\""
      },
      {
        "title": "Supported Sites",
        "body": "yt-dlp supports thousands of sites including:\n\nYouTube, YouTube Music\nBilibili (B站)\nTwitter/X\nTikTok, Douyin (抖音)\nVimeo\nTwitch\nAnd many more...\n\nFull list: https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md"
      },
      {
        "title": "Common Errors and Solutions",
        "body": "ErrorCauseSolutionHTTP 403 ForbiddenYouTube blocks unauthenticated requestsUse --cookies-from-browser chromeVideo unavailableGeo-restricted or privateUse cookies or VPNDownload interruptedNetwork issuesRetry - yt-dlp auto-resumesFormat not availableRequested format doesn't existUse -F to list formats"
      },
      {
        "title": "Error: \"yt-dlp: command not found\"",
        "body": "pip install yt-dlp"
      },
      {
        "title": "Error: \"ffmpeg not found\" (for audio extraction)",
        "body": "brew install ffmpeg  # macOS"
      },
      {
        "title": "Error: HTTP 403 Forbidden (YouTube)",
        "body": "This is the most common YouTube error. Always use cookies for YouTube:\n\n# Recommended approach for YouTube\nyt-dlp -P \"~/Downloads/yt-dlp\" --cookies-from-browser chrome \"YOUTUBE_URL\"\n\nSupported browsers: chrome, firefox, safari, edge, brave, opera"
      },
      {
        "title": "Error: Video unavailable or geo-restricted",
        "body": "# Try with cookies from browser\nyt-dlp --cookies-from-browser chrome \"VIDEO_URL\"\n\n# Or use a specific format\nyt-dlp -F \"VIDEO_URL\"  # List formats first\nyt-dlp -f FORMAT_ID \"VIDEO_URL\""
      },
      {
        "title": "Error: Download keeps failing",
        "body": "# Update yt-dlp to latest version\npip install -U yt-dlp\n\n# Force IPv4 (sometimes helps with connection issues)\nyt-dlp -4 \"VIDEO_URL\""
      },
      {
        "title": "Best Practices",
        "body": "YouTube downloads: Always use --cookies-from-browser chrome\nLarge files: yt-dlp auto-resumes, just retry if interrupted\nKeep yt-dlp updated: pip install -U yt-dlp\nCheck formats first: Use -F before downloading if unsure"
      }
    ],
    "body": "yt-dlp Video Downloader\n\nDownload videos from thousands of websites using yt-dlp.\n\nPrerequisites\n\nBefore downloading, verify dependencies are installed:\n\n# Check yt-dlp\nwhich yt-dlp || echo \"yt-dlp not installed. Install with: pip install yt-dlp\"\n\n# Check ffmpeg (required for audio extraction and format merging)\nwhich ffmpeg || echo \"ffmpeg not installed. Install with: brew install ffmpeg\"\n\n\nIf not installed, install them first:\n\npip install yt-dlp\nbrew install ffmpeg  # macOS\n\nQuick Start\nBasic Download (Best Quality)\nyt-dlp -P \"~/Downloads/yt-dlp\" \"VIDEO_URL\"\n\nYouTube Download (Recommended - with cookies)\n\nYouTube often blocks direct downloads with 403 errors. Always use browser cookies for YouTube:\n\nyt-dlp -P \"~/Downloads/yt-dlp\" --cookies-from-browser chrome \"YOUTUBE_URL\"\n\n\nSupported browsers: chrome, firefox, safari, edge, brave, opera\n\nDownload with Custom Output Path\nyt-dlp -P \"/path/to/save\" -o \"%(title)s.%(ext)s\" \"VIDEO_URL\"\n\nCommon Tasks\n1. Download Video (Default - Best Quality)\nyt-dlp -P \"~/Downloads/yt-dlp\" \"VIDEO_URL\"\n\n2. Extract Audio Only (MP3)\nyt-dlp -P \"~/Downloads/yt-dlp\" -x --audio-format mp3 \"VIDEO_URL\"\n\n3. Download with Subtitles\nyt-dlp -P \"~/Downloads/yt-dlp\" --write-subs --sub-langs all \"VIDEO_URL\"\n\n4. Download Specific Quality\n\n720p:\n\nyt-dlp -P \"~/Downloads/yt-dlp\" -f \"bestvideo[height<=720]+bestaudio/best[height<=720]\" \"VIDEO_URL\"\n\n\n1080p:\n\nyt-dlp -P \"~/Downloads/yt-dlp\" -f \"bestvideo[height<=1080]+bestaudio/best[height<=1080]\" \"VIDEO_URL\"\n\n\nBest available:\n\nyt-dlp -P \"~/Downloads/yt-dlp\" -f \"bestvideo+bestaudio/best\" \"VIDEO_URL\"\n\n5. List Available Formats (Before Download)\nyt-dlp -F \"VIDEO_URL\"\n\n\nThen download specific format by ID:\n\nyt-dlp -P \"~/Downloads/yt-dlp\" -f FORMAT_ID \"VIDEO_URL\"\n\n6. Download Playlist\n# Download entire playlist\nyt-dlp -P \"~/Downloads/yt-dlp\" -o \"%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s\" \"PLAYLIST_URL\"\n\n# Download specific range (e.g., items 1-5)\nyt-dlp -P \"~/Downloads/yt-dlp\" -I 1:5 \"PLAYLIST_URL\"\n\n7. Download with Thumbnail\nyt-dlp -P \"~/Downloads/yt-dlp\" --write-thumbnail \"VIDEO_URL\"\n\nWorkflow\n\nWhen user provides a video URL:\n\nIdentify the platform:\n\nYouTube/YouTube Music → Always use --cookies-from-browser chrome\nOther sites → Try without cookies first\n\nAsk what they want (if not specified):\n\nJust download the video?\nExtract audio only?\nNeed subtitles?\nSpecific quality?\n\nConstruct the command based on requirements\n\nExecute the download using Shell tool with required_permissions: [\"all\", \"network\"]\n\nHandle errors:\n\n403 Forbidden → Retry with --cookies-from-browser\nConnection issues → yt-dlp auto-resumes, just retry\nFormat unavailable → Use -F to list formats, then select\n\nReport the result - file location and any errors\n\nExample Interaction\n\nUser: \"帮我下载这个视频 https://www.youtube.com/watch?v=xxx\"\n\nResponse:\n\n# YouTube - use cookies to avoid 403 errors\nyt-dlp -P \"~/Downloads/yt-dlp\" --cookies-from-browser chrome \"https://www.youtube.com/watch?v=xxx\"\n\n\nUser: \"下载这个视频的音频 https://www.bilibili.com/video/xxx\"\n\nResponse:\n\n# Bilibili - extracting audio as MP3\nyt-dlp -P \"~/Downloads/yt-dlp\" -x --audio-format mp3 \"https://www.bilibili.com/video/xxx\"\n\n\nUser: \"下载这个 Twitter 视频 https://twitter.com/xxx/status/123\"\n\nResponse:\n\n# Twitter/X - direct download usually works\nyt-dlp -P \"~/Downloads/yt-dlp\" \"https://twitter.com/xxx/status/123\"\n\nSupported Sites\n\nyt-dlp supports thousands of sites including:\n\nYouTube, YouTube Music\nBilibili (B站)\nTwitter/X\nTikTok, Douyin (抖音)\nVimeo\nTwitch\nAnd many more...\n\nFull list: https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md\n\nTroubleshooting\nCommon Errors and Solutions\nError\tCause\tSolution\nHTTP 403 Forbidden\tYouTube blocks unauthenticated requests\tUse --cookies-from-browser chrome\nVideo unavailable\tGeo-restricted or private\tUse cookies or VPN\nDownload interrupted\tNetwork issues\tRetry - yt-dlp auto-resumes\nFormat not available\tRequested format doesn't exist\tUse -F to list formats\nError: \"yt-dlp: command not found\"\npip install yt-dlp\n\nError: \"ffmpeg not found\" (for audio extraction)\nbrew install ffmpeg  # macOS\n\nError: HTTP 403 Forbidden (YouTube)\n\nThis is the most common YouTube error. Always use cookies for YouTube:\n\n# Recommended approach for YouTube\nyt-dlp -P \"~/Downloads/yt-dlp\" --cookies-from-browser chrome \"YOUTUBE_URL\"\n\n\nSupported browsers: chrome, firefox, safari, edge, brave, opera\n\nError: Video unavailable or geo-restricted\n# Try with cookies from browser\nyt-dlp --cookies-from-browser chrome \"VIDEO_URL\"\n\n# Or use a specific format\nyt-dlp -F \"VIDEO_URL\"  # List formats first\nyt-dlp -f FORMAT_ID \"VIDEO_URL\"\n\nError: Download keeps failing\n# Update yt-dlp to latest version\npip install -U yt-dlp\n\n# Force IPv4 (sometimes helps with connection issues)\nyt-dlp -4 \"VIDEO_URL\"\n\nBest Practices\nYouTube downloads: Always use --cookies-from-browser chrome\nLarge files: yt-dlp auto-resumes, just retry if interrupted\nKeep yt-dlp updated: pip install -U yt-dlp\nCheck formats first: Use -F before downloading if unsure"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/apollo1234/yt-dlp-downloader-skill",
    "publisherUrl": "https://clawhub.ai/apollo1234/yt-dlp-downloader-skill",
    "owner": "apollo1234",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/yt-dlp-downloader-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/yt-dlp-downloader-skill",
    "agentUrl": "https://openagent3.xyz/skills/yt-dlp-downloader-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/yt-dlp-downloader-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/yt-dlp-downloader-skill/agent.md"
  }
}