domains / families / media / ingest-youtube

ingest-youtube

authentic

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

When to use

• User pastes a YouTube URL and asks for a transcript or summary
• User says `/ingest-youtube <url>` for a single video
• User asks to capture, sync, ingest, transcribe, or pull a talk/podcast/keynote into the vault
• Downloading the actual video file (use `yt-dlp` directly with `-f best`)
• Channel-wide ingestion or `--days` windows; this script ingests one video URL at a time
• Live streams (transcripts are not stable)
• Non-YouTube sources (Vimeo, Twitch, Twitter Spaces have their own connectors)
• One-off transcript reads where the user does not want a vault file (run `yt-dlp --write-auto-sub` directly and pipe to stdout)

When not to use

• Ingests one YouTube video URL per run; channel handles, playlists, and `--days` windows are out of scope.
• Depends on subtitles returned by `yt-dlp`; videos without subtitles produce a metadata stub, not a transcript.
• Does not download video files or perform built-in Whisper transcription in this version.
• Network availability, YouTube subtitle access, and local `yt-dlp` behavior determine whether ingest succeeds.

Skill page

Source