ingest-youtube — YouTube-to-vault connector

Pulls YouTube transcripts into a markdown vault as queryable typed-memory entries that downstream skills (knowledge graph extraction, voice-fingerprint training, content repurposing, action-item extraction) can act on.

Same pattern as ingest-slack, ingest-whatsapp, ingest-notion, ingest-linear, ingest-github, ingest-gmail. Adding YouTube means a new normalizer, not a new architecture.

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

Do NOT use for:

• 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)