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

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