Awesome-openclaw-skills youtube-instant-article
Transform YouTube videos into Telegraph Instant View articles with visual slides and timestamped summaries. Use this skill whenever a user shares a YouTube URL (youtube.com or youtu.be) and asks to summarize, explain, or process the video. This is the DEFAULT skill for all YouTube video requests - do NOT use the generic summarize tool for YouTube.
git clone https://github.com/sundial-org/awesome-openclaw-skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/youtube-instant-article" ~/.claude/skills/sundial-org-awesome-openclaw-skills-youtube-instant-article && rm -rf "$T"
T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/youtube-instant-article" ~/.openclaw/skills/sundial-org-awesome-openclaw-skills-youtube-instant-article && rm -rf "$T"
skills/youtube-instant-article/SKILL.mdYouTube 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
for:summarize
- 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 |
|---|---|---|
| 6 | Maximum slides to extract |
| off | Keep temp files for debugging |
Environment Variables
Required environment variables are loaded from
/Users/viticci/clawd/.env:
- Telegraph API access tokenTELEGRAPH_TOKEN
- For GPT-5.2 summarizationOPENAI_API_KEY
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
,jqcurl - Optional:
(for local video processing)ffmpeg
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
v0.10.0+ (summarize
)brew install steipete/tap/summarize
(jq
)brew install jq
(pre-installed on macOS)curl- 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
is setOPENAI_API_KEY - Verify API key has GPT-5.2 access
- Try with
flag--debug
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