yt-dlp Downloader Skill

A Cursor Agent Skill for downloading videos from YouTube, Bilibili, Twitter, and thousands of other sites using yt-dlp.

中文文档

Features

• Download videos from 1000+ websites
• Extract audio (MP3)
• Download subtitles
• Select video quality (720p/1080p/best)
• Auto-handle YouTube 403 errors with browser cookies
• Resume interrupted downloads

Prerequisites

Before using this skill, make sure you have the following installed:

# Install yt-dlp
pip install yt-dlp

# Install ffmpeg (required for audio extraction)
brew install ffmpeg  # macOS
# or: sudo apt install ffmpeg  # Linux

Installation

Option 1: Clone to Cursor skills directory

git clone https://github.com/MapleShaw/yt-dlp-downloader-skill.git ~/.cursor/skills/yt-dlp-downloader

Option 2: Manual installation

1. Create the skill directory:

   mkdir -p ~/.cursor/skills/yt-dlp-downloader/scripts
   

2. Download SKILL.md and scripts/download.sh from this repository

3. Place them in the created directory

Usage

Simply tell Cursor what you want to download:

Example Conversations

You: Download this video https://www.youtube.com/watch?v=xxx

Cursor:

yt-dlp -P "~/Downloads/yt-dlp" --cookies-from-browser chrome "https://www.youtube.com/watch?v=xxx"

Supported Sites

yt-dlp supports thousands of sites including:

• YouTube / YouTube Music
• Bilibili (B站)
• Twitter / X
• TikTok / Douyin (抖音)
• Vimeo
• Twitch
• And many more...

Troubleshooting

File Structure

yt-dlp-downloader/
├── SKILL.md              # Main skill instructions
└── scripts/
    └── download.sh       # Helper script

License

MIT

Credits

• yt-dlp - The powerful video downloader
• Cursor - AI-powered code editor