youtube-instant-article

# YouTube Instant Article Transform YouTube videos into Telegraph Instant View articles with visual slides and timestamped summaries. ## When to Use **ALWAYS use this skill when:** - User shares a YouTube URL (any youtube.com or youtu.be link) - "Summarize this video" - "What's this video about?" - "Turn this into an article" - "Give me the gist of this video" **Only use generic `summarize` for:** - Non-YouTube URLs (articles, websites, PDFs) - Explicit "just give me the transcript" requests ## Quick Start ```bash source /Users/viticci/clawd/.env && {baseDir}/scripts/generate.sh "$ARGUMENTS" ``` ## Options | Flag | Default | Description | |------|---------|-------------| | `--slides-max N` | 6 | Maximum slides to extract | | `--debug` | off | Keep temp files for debugging | ## Environment Variables Required environment variables are loaded from `/Users/viticci/clawd/.env`: - `TELEGRAPH_TOKEN` - Telegraph API access token - `OPENAI_API_KEY` - For GPT-5.2 summarization ## Output Telegraph Instant View article with: - 📺 Video link at top - 🖼️ Slides interleaved with timestamped sections - ⏱️ Key moments with timestamps - 💬 Notable quotes as blockquotes - ✨ Proper title from YouTube ## Architecture ``` YouTube URL │ ├─► summarize --extract (get video title) │ ├─► summarize --slides (extract key frames) │ ├─► summarize --timestamps (GPT-5.2 summary) │ ├─► catbox.moe (upload images) │ └─► Telegraph API (create article) ``` ## Key Features ### Image Hosting: catbox.moe - No API key required - No expiration - Reliable CDN - Direct URL embedding ### LLM: OpenAI GPT-5.2 - Fast (~4-5 seconds) - High quality summaries - Automatic timestamp extraction ### Layout: Interleaved Images - Images distributed across timestamp sections - Not grouped at top - Each major section gets a relevant slide ## ⚠️ Important Notes ### Instant View Timing Telegram needs **1-2 minutes** to generate Instant View for new pages. If the ⚡ button doesn't appear immediately, wait and try again. ### Script Requirements - Uses **zsh** (not bash) for associative array support - Requires: `summarize`, `jq`, `curl` - Optional: `ffmpeg` (for local video processing) ### Always Use the Script **NEVER manually create Telegraph content.** Always use `generate.sh`: - Ensures proper h4 headers (required for Instant View) - Distributes images correctly - Extracts video title automatically ## Dependencies - `summarize` v0.10.0+ (`brew install steipete/tap/summarize`) - `jq` (`brew install jq`) - `curl` (pre-installed on macOS) - OpenAI API key with GPT-5.2 access ## Processing Time | Video Length | Approx. Time | |--------------|--------------| | < 15 min | 20-30s | | 15-30 min | 30-45s | | 30+ min | 45-60s+ | ## Troubleshooting ### "Failed to get summary" - Check `OPENAI_API_KEY` is set - Verify API key has GPT-5.2 access - Try with `--debug` flag ### No Instant View button - Wait 1-2 minutes for Telegram to process - Verify article has content (not empty) - Check images loaded (visit Telegraph URL directly) ### Images not showing - catbox.moe might be temporarily down - Check upload succeeded in debug output - Verify URLs are HTTPS