One-Click Accelerated Video Download
Author / Workflow Design: AI Landing Fourth Tone. This author information is for display and source identification only and does not add additional licensing restrictions.
This is a confirmation-first workflow for video and audio downloads. The user only needs to give the link to the AI, and the AI will first check the yt-dlp and ffmpeg environment, list available formats, explain practical choices, and then confirm the quality, save directory, and filename. The AI will only execute the download after user confirmation.
Core value: Avoid downloading immediately upon receiving a link, reducing problems such as wrong resolution, wrong container, filename confusion, HDR/codec incompatibility, and unclear output locations. By default, it works with YouTube, YouTube Shorts, Vimeo, TikTok, Instagram, X/Twitter, Facebook, Twitch, Bilibili, Dailymotion, SoundCloud, Bandcamp, Reddit, and other sources supported by yt-dlp; the full scope is defined by the yt-dlp supported sites list. Playlists are only processed when explicitly requested by the user.
Quick start: Send the video link to the AI and specify whether you want "highest quality," "MP4 compatibility," "smaller file," "audio only," or let the AI recommend. The default recommendation is the highest available quality, not aggressively reduced to 720p to save space. If the download will be followed by subtitle translation, the AI will create a small project folder at your specified location, named with the localized video title and video ID. Video, audio, and subtitles are all placed here. yt-dlp handles parsing and downloading; ffmpeg handles merging separate video and audio streams, converting containers, extracting audio, and processing subtitles, thumbnails, and metadata when needed.
Example interaction:
User: Download this YouTube video for me, as clear as possible.
AI: I'll list the available formats first, then give you a few choices: highest quality, MP4 compatibility, smaller file, audio only. I'll confirm the quality, save path, and filename before downloading.
The section below starting "English Execution Contract" contains the formal rules for the AI executor to read; the Chinese explanation above is only for SkillHub, ClawHub, skills.sh, and user understanding and does not override the execution contract.
English Execution Contract
Use this skill for reviewed video/audio downloads with yt-dlp. Do not download immediately after the user provides a link. First inspect available formats, summarize practical choices, and ask the user to choose. Before downloading, also confirm the download path and filename. Download only after the user confirms all required choices or explicitly delegates them.
Workflow
- Check tools if not already confirmed:
command -v yt-dlp
command -v ffmpeg
- List available formats:
yt-dlp --no-playlist -F "VIDEO_URL"
Use --no-playlist unless the user explicitly asks for a playlist.
- Summarize the useful choices:
- Best quality (default recommendation): highest available video plus best audio. Prefer H.264 video plus M4A/AAC in
mp4when that preserves the highest available resolution; otherwise explain the container tradeoff. - MP4 compatibility: H.264 video plus M4A/AAC audio, usually
mp4. - Smaller file: 1080p, 720p, or another clear cap.
- Audio only: best audio or M4A compatibility.
- Best quality (default recommendation): highest available video plus best audio. Prefer H.264 video plus M4A/AAC in
Mention format IDs or selectors, resolution, FPS, HDR/SDR, video codec, audio codec, estimated size when visible, and container.
-
Ask the user which quality or format to download. Do not run the download command until they confirm.
-
Confirm the parent download location and create a media project folder.
- Treat every download that may continue to subtitle translation as one media project, not a loose collection of files.
- Use the confirmed location as
PARENT_DIR, then createPROJECT_DIRnamed<localized video title> [<video id>]beneath it. Localize the title to the user's requested language when asked. - Save the video, an explicitly downloaded audio-only file, ASS/SRT outputs, and hidden working artifacts under
PROJECT_DIR. Do not leave related files in the parent directory. - Pass the same
PROJECT_DIRto video translation as both its--outputs-dirand the parent of its hidden.work/directory.
-
Confirm the filename.
- Propose a default filename from the video metadata, normally:
%(upload_date>%Y-%m-%d)s - %(title).200B [%(id)s].%(ext)s
- Ask whether the user wants to update the filename.
- If yes, ask them to send the filename directly. Preserve or add the final extension based on the chosen container.
- Keep
[%(id)s]in the default name to avoid collisions and preserve the source video ID, but remove it if the user requests a cleaner name. - Use the confirmed filename or template as
OUTPUT_NAME. When a localized project title is used, keep the same localized basename for video, audio, and subtitles.
Commands
Use explicit reviewed IDs when possible:
yt-dlp --no-playlist --windows-filenames \
-f "VIDEO_ID+AUDIO_ID" \
--merge-output-format mkv \
-P "OUTPUT_DIR" \
-o "OUTPUT_NAME" \
"VIDEO_URL"
Use best quality after the user delegates selection:
yt-dlp --no-playlist --windows-filenames \
-f "bv*+ba/b" \
--merge-output-format mkv \
-P "OUTPUT_DIR" \
-o "OUTPUT_NAME" \
"VIDEO_URL"
Use MP4 compatibility after confirmation:
yt-dlp --no-playlist --windows-filenames \
-f "bv*[ext=mp4][vcodec^=avc1]+ba[ext=m4a]/b[ext=mp4]/b" \
--merge-output-format mp4 \
-P "OUTPUT_DIR" \
-o "OUTPUT_NAME" \
"VIDEO_URL"
Use audio only after confirmation:
yt-dlp --no-playlist --windows-filenames \
-f "ba" \
-P "OUTPUT_DIR" \
-o "OUTPUT_NAME" \
"VIDEO_URL"
Final Response
After downloading, report the saved path, file size, selected format IDs or selector, confirmed output directory, confirmed filename, and any important caveats such as HDR, MKV playback, subtitles, or audio language.
Remind the user to download only content they have permission to save or use when relevant.