Get the FREE Ultimate OpenClaw Setup Guide →

youtube-downloader

Scanned
npx machina-cli add skill davepoon/buildwithclaude/video-downloader --openclaw
Files (1)
SKILL.md
2.6 KB

YouTube Video Downloader

Download YouTube videos with full control over quality and format settings.

Quick Start

The simplest way to download a video:

python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"

This downloads the video in best available quality as MP4 to /mnt/user-data/outputs/.

Options

Quality Settings

Use -q or --quality to specify video quality:

  • best (default): Highest quality available
  • 1080p: Full HD
  • 720p: HD
  • 480p: Standard definition
  • 360p: Lower quality
  • worst: Lowest quality available

Example:

python scripts/download_video.py "URL" -q 720p

Format Options

Use -f or --format to specify output format (video downloads only):

  • mp4 (default): Most compatible
  • webm: Modern format
  • mkv: Matroska container

Example:

python scripts/download_video.py "URL" -f webm

Audio Only

Use -a or --audio-only to download only audio as MP3:

python scripts/download_video.py "URL" -a

Custom Output Directory

Use -o or --output to specify a different output directory:

python scripts/download_video.py "URL" -o /path/to/directory

Complete Examples

  1. Download video in 1080p as MP4:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p
  1. Download audio only as MP3:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a
  1. Download in 720p as WebM to custom directory:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path

How It Works

The skill uses yt-dlp, a robust YouTube downloader that:

  • Automatically installs itself if not present
  • Fetches video information before downloading
  • Selects the best available streams matching your criteria
  • Merges video and audio streams when needed
  • Supports a wide range of YouTube video formats

Important Notes

  • Downloads are saved to /mnt/user-data/outputs/ by default
  • Video filename is automatically generated from the video title
  • The script handles installation of yt-dlp automatically
  • Only single videos are downloaded (playlists are skipped by default)
  • Higher quality videos may take longer to download and use more disk space

Source

git clone https://github.com/davepoon/buildwithclaude/blob/main/plugins/all-skills/skills/video-downloader/SKILL.mdView on GitHub

Overview

Download YouTube videos with full control over quality and format settings. It supports best, 1080p, 720p, 480p, 360p, and formats MP4, WebM, MKV, plus audio-only MP3. Downloads default to /mnt/user-data/outputs/ and playlists are skipped by default.

How This Skill Works

The tool uses yt-dlp to fetch video information, select the best streams matching your criteria, and merge video and audio when needed. It automatically installs yt-dlp if missing and handles downloads from a single video URL.

When to Use It

  • You want to save a YouTube video for offline viewing at a specific quality
  • You need an audio-only MP3 version for music or podcasts
  • You require a specific container format (MP4, WebM, or MKV) for compatibility
  • You’re targeting a specific quality like 1080p or 720p
  • You want to download to a custom directory or avoid playlists

Quick Start

  1. Step 1: Run the script with a YouTube URL to download the video into the default outputs directory
  2. Step 2: Use -q to select a specific quality or -f to choose a format
  3. Step 3: Use -a for audio-only MP3 or -o to set a custom output directory

Best Practices

  • Validate the YouTube URL before running the command
  • Choose the exact quality with -q and the desired container with -f before downloading
  • If you only need audio, use -a to save MP3s and conserve space
  • Ensure the output directory exists and you have write permissions
  • Be mindful of download sizes and network usage for high-quality video

Example Use Cases

  • Download 1080p MP4: use quality 1080p with MP4 container for a high-quality video
  • Download audio-only MP3: use -a to save only the audio stream as MP3
  • Download 720p WebM to a custom directory: -q 720p -f webm -o /custom/path
  • Download best available MP4 by default without extra flags
  • Skip playlists and download a single video only

Frequently Asked Questions

Add this skill to your agents

Related Skills

theme-factory

davepoon/buildwithclaude

Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.

docx

davepoon/buildwithclaude

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

pdf

davepoon/buildwithclaude

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

xlsx

davepoon/buildwithclaude

Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas

obsidian-bases

davepoon/buildwithclaude

Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, filters, or formulas in Obsidian.

artifacts-builder

davepoon/buildwithclaude

Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.

Sponsor this space

Reach thousands of developers