Communitygithub.com

aiaaaa4/ai-landing-skills

AI Landing Fourth Tone agent skills and apps

What is ai-landing-skills?

This skill implements a confirmation-first workflow for video and audio downloads using yt-dlp. Instead of downloading immediately upon receiving a link, the AI first checks that yt-dlp and ffmpeg are available, inspects available formats, and presents practical choices such as highest quality, MP4 compatibility, smaller file size, or audio only. It also confirms the download path and filename, creating a project folder when subtitles or video translation may follow. This reduces errors like wrong resolution, incompatible containers, filename collisions, and unclear output locations. The skill supports YouTube, YouTube Shorts, Vimeo, TikTok, Instagram, X/Twitter, Facebook, Twitch, Bilibili, Dailymotion, SoundCloud, Bandcamp, Reddit, and all other sources supported by yt-dlp. Playlists are processed only when explicitly requested. The default recommendation is the highest available quality, not a reduced 720p. The skill also structures files into a project folder named after the localized video title and video ID, keeping video, audio, and subtitle files together for seamless follow-up translation or processing.

Works with~Claude Code✓Codex CLI~Cursor
npx skills add aiaaaa4/ai-landing-skills

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

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

  1. Check tools if not already confirmed:
command -v yt-dlp
command -v ffmpeg
  1. List available formats:
yt-dlp --no-playlist -F "VIDEO_URL"

Use --no-playlist unless the user explicitly asks for a playlist.

  1. Summarize the useful choices:
    • Best quality (default recommendation): highest available video plus best audio. Prefer H.264 video plus M4A/AAC in mp4 when 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.

Mention format IDs or selectors, resolution, FPS, HDR/SDR, video codec, audio codec, estimated size when visible, and container.

  1. Ask the user which quality or format to download. Do not run the download command until they confirm.

  2. 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 create PROJECT_DIR named <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_DIR to video translation as both its --outputs-dir and the parent of its hidden .work/ directory.
  3. 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.

Related Skills