TubeScribe

---

name: TubeScribe description: "YouTube video summarizer with speaker detection, formatted documents, and audio output. Works out of the box with macOS built-in TTS. Optional recommended tools (pandoc, ffmpeg, mlx-audio) enhance quality. Requires internet for YouTube access. No paid APIs or subscriptions. Use when user sends a YouTube URL or asks to summarize/transcribe a YouTube video." metadata: { "openclaw": { "emoji": "🎬", "requires": { "bins": ["summarize"] } } }

---

TubeScribe 🎬

Turn any YouTube video into a polished document + audio summary.

Drop a YouTube link → get a beautiful transcript with speaker labels, key quotes, timestamps that link back to the video, and an audio summary you can listen to on the go.

💸 Free & No Paid APIs

No subscriptions or API keys — works out of the box

Local processing — transcription, speaker detection, and TTS run on your machine

Network access — fetching from YouTube (captions, metadata, comments) requires internet

No data uploaded — nothing is sent to external services; all processing stays on your machine

Safe sub-agent — spawned sub-agent has strict instructions: no software installation, no network calls beyond YouTube

✨ Features

📄 Transcript with summary and key quotes — Export as DOCX, HTML, or Markdown

🎯 Smart Speaker Detection — Automatically identifies participants

🔊 Audio Summaries — Listen to key points (MP3/WAV)

📝 Clickable Timestamps — Every quote links directly to that moment in the video

💬 YouTube Comments — Viewer sentiment analysis and best comments

📋 Queue Support — Send multiple links, they get processed in order

🚀 Non-Blocking Workflow — Conversation continues while video processes in background

🎬 Works With Any Video

Interviews & podcasts (multi-speaker detection)

Lectures & tutorials (single speaker)

Music videos (lyrics extraction)

News & documentaries

Any YouTube content with captions

Quick Start

When user sends a YouTube URL: 1. Spawn sub-agent with the full pipeline task immediately 2. Reply: "🎬 TubeScribe is processing — I'll let you know when it's ready!" 3. Continue conversation (don't wait!) 4. Sub-agent notification will announce completion with title and details

DO NOT BLOCK — spawn and move on instantly.

First-Time Setup

Run setup to check dependencies and configure defaults:

python skills/tubescribe/scripts/setup.py

This checks: summarize CLI, pandoc, ffmpeg, Kokoro TTS

Full Workflow (Single Sub-Agent)

Spawn ONE sub-agent that does the entire pipeline:

sessions_spawn(
    task=f"""
TubeScribe: Process {youtube_url}
⚠️ CRITICAL: Do NOT install any software.
No pip, brew, curl, venv, or binary downloads.
If a tool is missing, STOP and report what's needed.
Run the COMPLETE pipeline — do not stop until all steps are done.
Step 1: Extract

bash python3 skills/tubescribe/scripts/tubescribe.py "{youtube_url}"

Note the Source and Output paths printed by the script. Use those exact paths in subsequent steps.
Step 2: Read source JSON
Read the Source path from Step 1 output and note:
metadata.title (for filename)
metadata.video_id
metadata.channel, upload_date, duration_string
Step 3: Create formatted markdown
Write to the Output path from Step 1:
1. #