video-digest

A Claude Code skill that turns any public video URL into a transcript-backed digest — summary, key points, action items, and follow-up questions personalized to the user.

Supports YouTube, TikTok, Instagram, X (Twitter), Facebook, and direct video/audio file links, via the Supadata transcription API.

How it works

1. Fetch the transcript — scripts/get_transcript.py hits the Supadata API, handling auth, async job polling for long videos, and error mapping (missing key, restricted video, no transcript available).
2. Write the digest — the agent reads the transcript and produces a structured summary, key points, and action items grounded strictly in what the video actually says.
3. Ask personalized questions — three follow-up questions that connect the video's content to the user's own projects and context, drawn from memory/conversation where available.

Full behavior spec lives in SKILL.md.

Setup

export SUPADATA_API_KEY=your_key   # https://dash.supadata.ai/organizations/api-key
python scripts/get_transcript.py "<VIDEO_URL>" --out transcript.txt

Optional flags: --lang en, --mode auto|native|generate.

Usage with Claude Code

Drop this repo's contents into ~/.claude/skills/video-digest/ (or your project's .claude/skills/) and Claude Code will invoke it automatically whenever you share a video link and ask for a summary, transcript, or key takeaways.