sumtubelisted

# sumtube Summarise any video (YouTube URL, local file, or non-YouTube URL) into structured markdown notes. --- ## Setup Preflight Before invoking the skill, verify the environment is ready: ```bash python scripts/setup.py --check ``` Exit codes: | Code | Meaning | |---|---| | 0 | All required dependencies present — ready to run | | 1 | Neither `SUMTUBE_API_KEY` nor `ANTHROPIC_API_KEY` is set — skill cannot proceed; stop and report the missing key (use `SUMTUBE_API_KEY` under Claude Code) | | 2 | `yt-dlp` not installed — warn the user; caption-only YouTube URLs will still work | | 3 | `ffmpeg` not installed — warn the user; Whisper transcription will not be available | `GROQ_API_KEY` is **not** validated at preflight. It is checked lazily only when Whisper transcription is needed (caption-less video or local file). If Whisper is triggered and the key is absent, the skill raises `MissingAPIKeyError` and halts. --- ## When to Use Use sumtube whenever the input is a video reference (URL or file path) and a structured markdown summary is the desired output. Input routing: | Input type | Transcript path | Whisper fallback | |---|---|---| | YouTube URL | Caption download attempt first | Yes — if captions unavailable and `GROQ_API_KEY` set | | Non-YouTube URL | yt-dlp download → caption attempt | Yes — if captions unavailable and `GROQ_API_KEY` set | | Local file path | No caption path | Always uses Whisper — requires `GROQ_API_KEY` | --- ## How to Invoke Follow thes