feitangyuan/onetake

onetake – a Claude Agent Skill for single‑take product videos

What it is – onetake is a Claude (or other LLM) skill that lets an AI generate short product‑launch or feature‑demo videos that are one continuous camera take. Instead of a slide‑show of separate cuts, each visual beat morphs into the next, and the same virtual camera follows the action throughout.

How it works

1. Prompt → film – You ask the agent (e.g., “make a 15 s launch video for my app”).
2. The skill builds an HTML representation of the product UI from supplied screenshots, so the camera can zoom into any element without screen‑recording.
3. A library of ~38 pre‑measured motion primitives (springs, entrances, collisions, fluid‑ground moves, camera pushes, etc.) is composed into a beat sheet that defines timing, length variation, and—crucially—what visual element “carries over” at each boundary.
4. The renderer (Node + Playwright) produces frames with physically‑based motion blur (multiple shutter samples averaged in linear light) and outputs 1080p 30 fps drafts or 4K 60 fps finals.
5. An automatic continuity oracle (probe.py) analyses every frame, detects the boundaries, and scores how well something survives from one beat to the next. Films below a carry‑score threshold are rejected before a human sees them.
6. Sound is added from a small library of foley and synthesized effects; narration can be generated with faster‑whisper + Kokoro TTS, all placed in a single acoustic space.

Key features

• Deterministic rendering – seeking to any timestamp always yields the same frame.
• Measured motion – every move is a pure time function with an empirically‑derived speed curve; no hand‑tuned easings.
• Real‑time UI reconstruction – HTML UI rebuilt from screenshots, allowing unlimited zoom without pixelation.
• Continuity verification – an oracle automatically rejects “slideshow‑like” outputs.
• Non‑commercial license – free for personal, educational, or research use (PolyForm Non‑commercial 1.0.0).

Typical use‑cases

• Quickly produce polished launch teasers that feel handcrafted.
• Generate feature demos that avoid screen‑recording, keeping the visual style consistent.
• Iterate on motion concepts: designers can experiment with different carry‑over ideas and get an instant video preview.

Installation

# For Claude‑compatible agents
git clone https://github.com/feitangyuan/onetake.git ~/.claude/skills/onetake
# For other agents that read a "skills" folder
git clone https://github.com/feitangyuan/onetake.git ~/.agents/skills/onetake

Dependencies (Python 3): playwright (Chromium), numpy, scipy, Pillow, matplotlib, opencv‑python (optional reference analysis), ffmpeg, node. Optional TTS/Narration: faster‑whisper, Kokoro TTS.

Demo films – The repository ships ten case studies (e.g., onetake launch, one‑dot, knockon, clearing). Each includes the final MP4 and a markdown breakdown describing the concept, beat sheet, and why earlier versions were rejected.

License – PolyForm Non‑commercial 1.0.0 (free for non‑commercial use only).