# Send YouTube Media Downloader to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "youtube-media-downloader",
    "name": "YouTube Media Downloader",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/XanderRey/youtube-media-downloader",
    "canonicalUrl": "https://clawhub.ai/XanderRey/youtube-media-downloader",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/youtube-media-downloader",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=youtube-media-downloader",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/download-patterns.md",
      "scripts/batch_download.sh",
      "scripts/download_media.sh"
    ],
    "downloadMode": "redirect",
    "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/youtube-media-downloader"
    },
    "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."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/youtube-media-downloader",
    "downloadUrl": "https://openagent3.xyz/downloads/youtube-media-downloader",
    "agentUrl": "https://openagent3.xyz/skills/youtube-media-downloader/agent",
    "manifestUrl": "https://openagent3.xyz/skills/youtube-media-downloader/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/youtube-media-downloader/agent.md"
  }
}
```
## Documentation

### YouTube Media Downloader

Download high-quality audio and video files from YouTube for offline use, music conversion, and content archiving.

### Overview

This skill provides comprehensive YouTube downloading capabilities with quality control, batch processing, and format options. Perfect for music extraction, video archiving, educational content, and playlist processing.

### Single Video/Audio

# Download as MP3 (default)
scripts/download_media.sh "https://www.youtube.com/watch?v=VIDEO_ID"

# Download as MP4 video
scripts/download_media.sh -v "https://www.youtube.com/watch?v=VIDEO_ID"

# Custom filename and directory
scripts/download_media.sh -o ~/Downloads "https://www.youtube.com/watch?v=VIDEO_ID" "my_song"

### Playlist/Batch Download

# Entire playlist as MP3
scripts/batch_download.sh "https://www.youtube.com/playlist?list=PLAYLIST_ID"

# Playlist items 5-10 as 720p video
scripts/batch_download.sh -v -q 720p -s 5 -e 10 "PLAYLIST_URL"

# From file list of URLs
scripts/batch_download.sh -f urls.txt

### Audio Extraction

Format: High-quality MP3
Quality: Best available audio automatically selected
Use cases: Music, podcasts, lectures, interviews
Command: Default behavior (no flags needed)

### Video Download

Format: MP4 (maximum compatibility)
Quality options: best, 720p, 480p, 360p, worst
Use cases: Offline viewing, archiving, educational content
Command: Use -v/--video flag

### Batch Processing

Playlists: Full playlist support with range selection
URL files: Process text files with multiple URLs
Organization: Auto-numbered for playlists
Control: Start/end positions, max downloads

### Audio (MP3)

Best quality: Automatic selection from source
File size: ~3-10MB per song
Compatibility: Universal MP3 support

### Video Quality Options

best: Highest available (1080p+, large files)
720p: HD quality, balanced size (~50-200MB)
480p: SD quality, mobile-friendly (~20-80MB)
360p: Low quality, minimal size (~10-30MB)

### Organization Options

# Specific output directory
-o ~/Downloads/Music

# Date-based folders
-o ~/Downloads/$(date +%Y-%m-%d)

### Playlist Range Control

# Specific range (items 10-20)
-s 10 -e 20

# From specific item to end
-s 25

# Limit total downloads
-m 50

### File Input Processing

Create urls.txt with one URL per line:

https://www.youtube.com/watch?v=video1
https://www.youtube.com/watch?v=video2

Then: batch_download.sh -f urls.txt

### download_media.sh

Purpose: Single video/audio downloads
Key flags:

-a/--audio: MP3 extraction (default)
-v/--video: MP4 video download
-q/--quality: Quality selection
-o/--output: Output directory

### batch_download.sh

Purpose: Playlist and bulk downloads
Key flags:

-s/--start, -e/--end: Range selection
-m/--max-downloads: Limit downloads
-f/--file: Process URL file
All single download flags supported

### Best Practices & Patterns

For detailed usage patterns, quality guidelines, and troubleshooting, see download-patterns.md.

### Technical Notes

Auto-installation: Scripts install yt-dlp and ffmpeg automatically if needed
Portable setup: Downloads portable binaries, no system admin required
Resume support: Interrupted downloads can be resumed
Error handling: Batch processing continues despite individual failures
Format preference: Always attempts MP4 for video, MP3 for audio
Naming: Auto-generated from video titles unless specified

### Legal & Ethical Use

Personal use: Download content for your own offline viewing
Respect copyrights: Don't redistribute copyrighted material
Terms compliance: Follow YouTube's terms of service
Fair use: Consider fair use guidelines for educational content
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: XanderRey
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/youtube-media-downloader)
- [Send to Agent page](https://openagent3.xyz/skills/youtube-media-downloader/agent)
- [JSON manifest](https://openagent3.xyz/skills/youtube-media-downloader/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/youtube-media-downloader/agent.md)
- [Download page](https://openagent3.xyz/downloads/youtube-media-downloader)