Skip to content
advanced-video-downloader logo

Advanced Video Downloader

advanced-video-downloader

Download and transcribe videos from YouTube, Bilibili, TikTok and 1000+ platforms. Use when user requests video download, transcription (转录/字幕提取), or converting video to text/markdown. Supports quality selection, audio extraction, playlist downloads, cookie-based authentication, and AI-powered tr...

SKILL.md

Full skill instructions

Advanced Video Downloader

Overview

This skill provides comprehensive video downloading and transcription capabilities from 1000+ platforms including YouTube, Bilibili, TikTok, Twitter, Instagram, and more. It combines:

  • yt-dlp: Powerful video downloading tool
  • SiliconFlow API: Free AI-powered transcription to convert videos to Markdown

When to Use This Skill

Activate this skill when the user:

  • Explicitly requests to download a video ("download this video", "下载视频")
  • Provides video URLs from any platform
  • Mentions saving videos for offline viewing
  • Wants to extract audio from videos
  • Needs to download multiple videos or playlists
  • Asks about video quality options
  • Requests video transcription ("转录视频", "提取字幕", "视频转文字")
  • Wants to convert video/​audio to text or Markdown
  • Asks to download AND transcribe a video in one workflow

Core Capabilities

1. Single Video Download

Download individual videos from any supported platform with automatic quality selection.

Example usage:

User: "Download this YouTube video: https://youtube.com/​watch?v=abc123"
User: "下载这个B站视频: https://bilibili.com/​video/​BV1xxx"

2. Batch & Playlist Download

Download multiple videos or entire playlists at once.

Example usage:

User: "Download all videos from this playlist"
User: "Download these 3 videos: [URL1], [URL2], [URL3]"

3. Audio Extraction

Extract audio only from videos, saving as MP3 or M4A.

Example usage:

User: "Download only the audio from this video"
User: "Convert this video to MP3"

4. Quality Selection

Choose specific video quality (4K, 1080p, 720p, etc.).

Example usage:

User: "Download in 4K quality"
User: "Get the 720p version to save space"

5. Video/​Audio Transcription

Convert video or audio files to Markdown text using SiliconFlow's free AI transcription API.

Example usage:

User: "Transcribe this video to text" / "转录这个视频"
User: "Download and transcribe this YouTube video"
User: "将这个音频转成文字"
User: "Extract transcript from this MP4 file"

Supported formats:

  • Audio: MP3, WAV, M4A, FLAC, AAC, OGG, OPUS, WMA
  • Video: MP4, AVI, MOV, MKV, FLV, WMV, WEBM, M4V

Response Pattern

When a user requests video download:

Step 1: Identify the Platform and URL(s)

# Extract video URL(s) from user message
# Identify platform: YouTube, Bilibili, TikTok, etc.

Step 2: Check Tool Availability

# Check if yt-dlp is installed
yt-dlp --version

Step 3: Select Appropriate yt-dlp Command

Based on platform and requirements:

  • YouTube, Twitter, Instagram, TikTok: Basic command works
  • Bilibili: Basic command works for most videos
  • Quality selection: Use -f with height filter
  • Audio only: Use -x --audio-format mp3
  • Playlists: Use playlist-specific output template

Step 4: Execute Download

Use yt-dlp directly with appropriate options:

# Basic download (best quality MP4)
yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/​best[ext=mp4]/​best" --merge-output-format mp4 -o "%(title)s.%(ext)s" "VIDEO_URL"

# Specific quality (1080p)
yt-dlp -f "bestvideo[height<=1080]+bestaudio/​best[height<=1080]" --merge-output-format mp4 -o "%(title)s.%(ext)s" "VIDEO_URL"

# Audio only (MP3)
yt-dlp -x --audio-format mp3 -o "%(title)s.%(ext)s" "VIDEO_URL"

# With cookies file (for protected content)
yt-dlp --cookies cookies.txt -o "%(title)s.%(ext)s" "VIDEO_URL"

# Playlist download
yt-dlp -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" "PLAYLIST_URL"

Step 5: Report Results

After download completes, report:

  • ✅ Video title and duration
  • ✅ File size and format
  • ✅ Save location
  • ✅ Download speed and time taken
  • ⚠️ Any warnings or quality limitations

Example output:

✅ Downloaded: "Video Title Here"
   Duration: 15:30
   Quality: 1080p MP4
   Size: 234 MB
   Location: ./​Video Title Here.mp4
   Time: 45 seconds at 5.2 MB/​s

Transcription Response Pattern

When a user requests video/​audio transcription:

Step 1: Check Prerequisites

# Verify SiliconFlow API key is available
echo $SILICONFLOW_API_KEY
# Or user must provide via --api-key parameter

API Key Setup:

Step 2: Validate File

Ensure the file exists and is a supported format (audio or video).

Step 3: Execute Transcription

Use the bundled script scripts/​transcribe_siliconflow.py:

# Basic transcription
python scripts/​transcribe_siliconflow.py --file video.mp4 --api-key sk-xxx

# With custom output path
python scripts/​transcribe_siliconflow.py --file audio.mp3 --output transcript.md --api-key sk-xxx

# Using environment variable for API key
python scripts/​transcribe_siliconflow.py --file video.mp4

Step 4: Report Transcription Results

✅ Transcription complete!
   File: video.mp4
   Output: 2025-01-15-video.md
   Size: 12.5 KB

   Preview:
   --------------------------------------------------
   [First 200 characters of transcription...]
   --------------------------------------------------

Combined Workflow: Download + Transcribe

For requests like "Download and transcribe this video":

# Step 1: Download video
yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/​best" --merge-output-format mp4 -o "%(title)s.%(ext)s" "VIDEO_URL"

# Step 2: Transcribe the downloaded file
python scripts/​transcribe_siliconflow.py --file "Downloaded Video Title.mp4" --api-key sk-xxx

Platform-Specific Notes

YouTube

  • Fully supported by yt-dlp
  • No authentication needed for public videos
  • Supports all quality levels including 4K/​8K

Bilibili

  • Supported by yt-dlp
  • High-quality downloads may require login cookies
  • Use --cookies with cookies.txt for member-only content

Other Platforms

  • Most platforms work well with yt-dlp
  • Check references/​supported_platforms.md for full list

Handling Cookies for Protected Content

For platforms requiring authentication (Bilibili VIP, member-only content, etc.):

Method 1: Export Cookies File (Recommended)

# Use browser extension "Get cookies.txt LOCALLY"
# Export cookies.txt, then:
yt-dlp --cookies cookies.txt "VIDEO_URL"

Method 2: Manual Cookies File

# Create cookies.txt in Netscape format
# Use browser extension "Get cookies.txt LOCALLY"
# Then use with yt-dlp
yt-dlp --cookies cookies.txt "VIDEO_URL"

Troubleshooting

Issue: Video quality lower than expected

Solution:

  1. Check if platform requires login for HD
  2. Use --cookies cookies.txt for authenticated access
  3. Explicitly specify quality with -f parameter

Issue: Download very slow

Solution:

  1. Check internet connection
  2. Try different time of day (peak hours affect speed)
  3. Use --concurrent-fragments for faster downloads

Issue: "Video unavailable" or geo-restricted

Solution:

  1. Video may be region-locked
  2. Use proxy/​VPN if legally permitted
  3. Check if video is still available on platform

Issue: Transcription API key error

Solution:

  1. Verify API key starts with sk-
  2. Get free key from: https://cloud.siliconflow.cn/account/ak
  3. Set environment variable: SILICONFLOW_API_KEY=sk-xxx

Issue: Transcription returns empty text

Solution:

  1. Check if audio/​video has clear speech
  2. Verify file format is supported
  3. File may be too short or contain only music

Common Commands

Quality Presets

# 4K (2160p)
yt-dlp -f "bestvideo[height<=2160]+bestaudio/​best[height<=2160]" --merge-output-format mp4 "VIDEO_URL"

# 1080p (Full HD)
yt-dlp -f "bestvideo[height<=1080]+bestaudio/​best[height<=1080]" --merge-output-format mp4 "VIDEO_URL"

# 720p (HD)
yt-dlp -f "bestvideo[height<=720]+bestaudio/​best[height<=720]" --merge-output-format mp4 "VIDEO_URL"

# 480p (SD)
yt-dlp -f "bestvideo[height<=480]+bestaudio/​best[height<=480]" --merge-output-format mp4 "VIDEO_URL"

Audio Extraction

# Extract as MP3
yt-dlp -x --audio-format mp3 -o "%(title)s.%(ext)s" "VIDEO_URL"

# Extract as M4A (better quality)
yt-dlp -x --audio-format m4a -o "%(title)s.%(ext)s" "VIDEO_URL"

Batch Downloads

# Download multiple URLs from file
yt-dlp -a urls.txt

# Download playlist with custom naming
yt-dlp -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" "PLAYLIST_URL"

# Download channel's videos
yt-dlp -o "%(uploader)s/%(title)s.%(ext)s" "CHANNEL_URL"

Bundled Resources

Configuration

.env.example

Template for environment variables. Copy to .env and add your SiliconFlow API key.

Scripts

scripts/​transcribe_siliconflow.py

AI-powered transcription script using SiliconFlow's free API.

Usage:

python scripts/​transcribe_siliconflow.py --file <audio/​video> [--api-key <key>] [--output <path>]

Parameters:

  • --file, -f: Input audio/​video file (required)
  • --api-key, -k: SiliconFlow API key (or use SILICONFLOW_API_KEY env var)
  • --output, -o: Output markdown file path (default: YYYY-MM-DD-filename.md)
  • --model, -m: Model to use (default: FunAudioLLM/​SenseVoiceSmall)

References

references/​supported_platforms.md

Comprehensive list of 1000+ supported platforms with platform-specific notes and requirements.

references/​quality_formats.md

Detailed explanation of video formats, codecs, and quality selection strategies.

Tips for Best Results

  1. Always specify quality if user has preference - saves bandwidth and storage
  2. Batch downloads save time - use playlist URLs when possible
  3. Audio extraction is faster - recommend for podcast/​music content
  4. Check file size before downloading - warn user for very large files (>1GB)
  5. Transcription works best with clear audio - consider extracting audio first for better results

Sources

More Productivity & Planning skills

brainstorming logo
Productivity & Planning

brainstorming

Structured design dialogue that validates ideas before implementation begins.

295.4K 385.7K
View
ui-ux-pro-max logo
Productivity & Planning

ui-ux-pro-max

Comprehensive design intelligence for web and mobile UI/UX across 10 technology stacks.

133.1K 383.9K
View
writing-plans logo
Productivity & Planning

writing-plans

Comprehensive implementation plans for multi-step tasks, breaking down specs into bite-sized, testable steps.

295.4K 268K
View
using-superpowers logo
Productivity & Planning

using-superpowers

Introduction to the obra skills system with mandatory skill invocation rules and best practices.

295.4K 259.8K
View
executing-plans logo
Productivity & Planning

executing-plans

Execute a written implementation plan with critical review and task checkpoints.

295.4K 229.1K
View
dispatching-parallel-agents logo
Productivity & Planning

dispatching-parallel-agents

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K
View
using-git-worktrees logo
Productivity & Planning

using-git-worktrees

Isolated git worktrees with smart directory selection and safety verification.

295.4K 205.2K
View
webapp-testing logo
Productivity & Planning

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

179.7K 170.6K
View
content-strategy logo
Productivity & Planning

content-strategy

Plan searchable and shareable content that drives traffic, builds authority, and generates leads.

53.3K 150.9K
View
repo-intake-and-plan logo
Productivity & Planning

repo-intake-and-plan

README-first repository scanner that extracts commands and classifies reproduction candidates without executing them.

497 139.6K
View
marketing-ideas logo
Productivity & Planning

marketing-ideas

Brainstorm and prioritize marketing strategies tailored to your SaaS stage, budget, and goals.

53.3K 137.2K
View
site-architecture logo
Productivity & Planning

site-architecture

Plan and optimize your website's page hierarchy, navigation, URL structure, and internal linking.

53.3K 112.8K
View

Productivity AI tools

Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View
SaveDay logo
Productivity

SaveDay

Capture, organize, and utilize your knowledge effortlessly.

Free
View
Any Summary logo
Productivity

Any Summary

Instant Summaries of Audio & Video Interviews with AnySummary

Freemium
View
M
Productivity

Map This

Transform PDFs into engaging mind maps.

Freemium
View
ChatPDF logo
Productivity

ChatPDF

Chat with any PDF instantly

Free
View
I
Productivity

intellisay

Create an optimal daily plan using your voice

Paid
View
A
Productivity

Aurora AI

A productivity platform to centralize organizational knowledge and workflows with contextual AI assistance.

Paid
View
AskYourPDF logo
Productivity

AskYourPDF

AskYourPDF Pricing Plans: Tailored to Your Needs

Free
View