Skip to content
Back to search

onetake

"Make short product / skill motion videos (10–30 s, narrated feature demos up to ~60 s) the way high-end launch clips are made — kinetic type, real UI as the material, a hand that causes every reaction, beats that carry into each other instead of replacing each other, hard cuts only where they mean something — without HyperFrames or Remotion. A single HTML composition where every value is a pure function of time, built from a library of measured moves (springs, entrances, carries, contact, camera), rendered frame by frame with real shutter motion blur (1080p30 drafts, 4K60 final), with synthesised sound effects that share one room and an oracle that fails a slideshow before a human has to watch it. Use for 做个动效短片 / 产品宣传片 / 介绍视频 / 发布视频 / 15 秒 launch video / 给 skill 或 app 做个视频 / promo / teaser, for turning real pages or screen recordings into a cut, for product feature demos (产品功能演示 / 功能展示动效) where the UI is rebuilt in HTML from screenshots instead of screen-recorded (不录屏 / 复刻界面 / 截图还原 UI), for narrated cuts with voice-over and subtitles (配音 / 字幕 / 换配音) and for the same film in other languages (日语版 / 多语言 / 本地化), for adding motion vocabulary (动效库 / 转场 / 衔接), and for auditing why a motion video reads as a slideshow (像 PPT / 没节奏 / 一个一个展示 / 转场生硬)."

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/feitangyuan--onetake/badge.svg)](/listings/feitangyuan--onetake)

HTML

<a href="/listings/feitangyuan--onetake"><img src="/api/listings/feitangyuan--onetake/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Claude Code
git clone https://github.com/feitangyuan/onetake.git ~/.claude/skills/onetake
# Codex / other agents that read skills
git clone https://github.com/feitangyuan/onetake.git ~/.agents/skills/onetake

Then ask: *"Make a 15 s launch video for my app"*, *"a feature demo rebuilt from these screenshots, no screen recording"*, *"my motion video feels like a slideshow — fix it"*.

**Requires** python3 with `playwright` (chromium), `numpy`, `scipy`, `Pillow`, `matplotlib` (`opencv-python` for reference analysis), `ffmpeg`, `node`. Narration adds `faster-whisper` and Kokoro TTS. Music is royalty-free by default.

| | | |---|---| | `SKILL.md` | the protocol and the hard rules each rejected cut taught | | `lib/motion.js` · `lib/ui_kit.js` | the move library; the UI-rebuild kit | | `scripts/` | render (motion blur, 4K60), verify (the oracle), probe, stills, reference analysis, footage, narration, sound | | `gallery/` | one live demo and one six-frame sheet per move | | `references/` | rhythm, carry, composition, camera, sound, product demos — the method with its numbers |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 269 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: onetake
  3. license: PolyForm Noncommercial 1.0.0 (free for noncommercial use; see LICENSE)
  4. metadata:
  5. author: Patrick (github.com/feitangyuan)
  6. lineage: otk-7f3e1c
  7. description: "Make short product / skill motion videos (10–30 s, narrated feature demos up to ~60 s) the way high-end launch clips are made — kinetic type, real UI as the material, a hand that causes every reaction, beats that carry into each other instead of replacing each other, hard cuts only where they mean something — without HyperFrames or Remotion. A single HTML composition where every value is a pure function of time, built from a library of measured moves (springs, entrances, carries, contact, camera), rendered frame by frame with real shutter motion blur (1080p30 drafts, 4K60 final), with synthesised sound effects that share one room and an oracle that fails a slideshow before a human has to watch it. Use for 做个动效短片 / 产品宣传片 / 介绍视频 / 发布视频 / 15 秒 launch video / 给 skill 或 app 做个视频 / promo / teaser, for turning real pages or screen recordings into a cut, for product feature demos (产品功能演示 / 功能展示动效) where the UI is rebuilt in HTML from screenshots instead of screen-recorded (不录屏 / 复刻界面 / 截图还原 UI), for narrated cuts with voice-over and subtitles (配音 / 字幕 / 换配音) and for the same film in other languages (日语版 / 多语言 / 本地化), for adding motion vocabulary (动效库 / 转场 / 衔接), and for auditing why a motion video reads as a slideshow (像 PPT / 没节奏 / 一个一个展示 / 转场生硬)."
  8. ---
  9. # onetake
  10. Short motion films about a product, built from the product. Not a video editor, not a slideshow
  11. generator: a **composition** (one HTML file, `window.__seek(t)`), a **move library** (`lib/motion.js`),
  12. **footage** recorded from the real thing, a **sound palette** that shares one room, and an **oracle**
  13. that says whether the cut has a rhythm and whether it carries, before a human has to watch it.
  14. Six films taught it. **motion-web** took three cuts: one and two were rejected as 「PPT 式一个一个展示」
  15. for a uniform cadence — the rhythm half. **Pocket Weather Club** had the rhythm and was *still* PPT: its v1
  16. passed every rhythm check and was rejected, because each beat replaced the one before. v3 was accepted when
  17. every beat grew out of the last — the character lands on the headline, the page grows out of its card, a
  18. stage opens from the character. That is the carry half. **One dot** added the operator: with a still camera it was
  19. 「就缺灵动的跟踪运镜」; with a camera that chases what each beat frames — lagging, leaning, settling — it was
  20. 「运镜、镜头和物理都没问题」. **knockon** carried by cause: a light tabletop machine where every beat is the collision
  21. that starts the next. **clearing** carried by scale: one take from a year to a free half hour and back, a camera that
  22. chases the anchor on screen so it lands the same at 1× and 300×. **overlap** was the meaning lesson: its first cut was
  23. 「美术挺棒但没看出来啥意思」, and adding labelled cursors made it worse; it read only once the idea was built into the
  24. artwork — an & hidden in two noise plates that appears at the instant the passes come into register. Everything here
  25. exists so the next film starts where those films ended.
  26. ## When this skill, and when not
  27. - A launch / teaser / intro clip for an app, a page, a skill, a feature — **yes**.
  28. - A narrated feature demo (30–60 s) that shows the product being used, possibly in several languages — **yes**:
  29. rebuild the UI instead of recording it (§4, `references/product-demo.md`).
  30. - The user has a reference clip they want the *feel* of — **yes**, start at §1.
  31. - Long-form, talking-head, editing existing footage with transitions — **no**.
  32. - The user names HyperFrames or Remotion explicitly — use what they name. Otherwise this pipeline.
  33. ## The protocol — in this order, no skipping
  34. ### 1 · Deconstruct the reference before touching anything (硬规则)
  35. ```bash
  36. python3 scripts/analyze_ref.py ref.mp4 --out ana/ # energy map, cuts, stillness, contact sheets, motion line
  37. ```
  38. Read the energy map and the sheets and write down the numbers the film has to match. The energy map says *when*
  39. the film moves; the `motion:` line says *how* —
  40. median t80 (snaps or S-curves) and smear (rendered with motion blur or not). What decided the motion-web film:
  41. the reference was **34 % dead-still**, had **7 hard cuts** in two bursts, and kept every element **small with a
  42. lot of white space**. None of that is obvious from watching once, and a film built without measuring it came
  43. out on a uniform cadence — twice. `references/reference-deconstruction.md`.
  44. ### 2 · Concept — three central ideas before any beat sheet (硬规则)
  45. A concept is one sentence about the *picture*, not the product: the single idea the film is made of. Write three
  46. that differ in that idea — not three stories told with the same cards:
  47. - **one element transforms through everything** — a dot is the caret, splits into the skill list, hollows into a
  48. loading ring, unrolls into a spring curve, lands as the dot on the i of the wordmark;
  49. - **one camera move through scale** — start inside the caret, pull out to the input, dive through the send button
  50. into the work, come out through the finished film (`cases/clearing-15s`: a year → one day → a half hour → back);
  51. - **a before/after split** — the same beats as a slideshow on the left and carried on the right, until the right
  52. side breaks into the left;
  53. - **a chain reaction** — every beat is the collision that starts the next (`cases/knockon-15s`);
  54. - or a physical metaphor, one continuous surface, a typographic system…
  55. For each: the hook frame, what carries every boundary, what it rules out (no cards? no cuts?), and **its look** —
  56. a preset from `looks/` (`python3 scripts/look.py sheet` → `gallery/sheets/looks.png`: paper, dusk, tabletop,
  57. ultramarine, riso, ember, each measured from an accepted film), the product's own colours
  58. (`look.py from-shot shots/*.png --out look.json`), or one made for this film. Show the three and let the user pick.
  59. The template's story — kinetic words → typed prompt → ticking checklist → result → staccato
  60. hits → black wordmark — is one concept, never the default: an operation demo built on it passed every oracle leg
  61. (carry 1.00) and was sent back as 「和 motion web 很像…没有创造力」.
  62. ### 3 · Storyboard as rhythm *and* carry
  63. Write the chosen concept as a **beat sheet**: `t · beat · what moves · what is still · what carries into the next
  64. beat`.
  65. **Rhythm.** Vary shot length by ≥ 4× (0.25 s words next to 2.5 s holds). At least one stretch of near-silence in
  66. picture and sound. One story — the concept's — not a catalogue. Small elements, big ground.
  67. **Carry.** At every section boundary, name the thing that survives it and moves: the hand, the subject, a
  68. container that becomes the next scene (`morphRect`), a stage that opens from the subject (`iris`), a camera that
  69. pushes into a card until it is the scene (`zoomThrough`), a cast that folds into the lockup (`gather` → `seal`).
  70. If nothing survives, it is a slide change, whatever the rhythm. Bare cuts belong to bursts of hits and the end
  71. card, when the concept has them. `references/rhythm.md`.
  72. ### 4 · Footage from the real thing — or the UI rebuilt from screenshots
  73. ```bash
  74. python3 scripts/record_footage.py footage.json --out footage/
  75. ```
  76. Real pages, driven in real time by Playwright (wall-clock-paced sweeps, wheel steps, clicks),
  77. recorded at the size you will show them, with a magenta marker injected the instant the input starts
  78. so the action frame is findable afterwards. Frames come out at 30 fps as JPEG; the pointer path is
  79. saved so the composition can draw the hand back in — **the viewer must see the cause, not just the
  80. effect**. Config format in the script's docstring.
  81. **Or rebuild it.** When the film walks through an app's features (and above all when it has a voice or other
  82. languages), the user screenshots or records only reference takes, and the UI is rebuilt in HTML in the reference's
  83. own pixel frame. Every string lives in a table, every state is written by a pure `set(state)`, and the replica sits
  84. on the plane where the camera can close in at any zoom. Highlights are measured from its DOM (`lib/ui_kit.js`).
  85. Narration comes from `scripts/vo_tools.py`: audition, lines, word times, subtitles. A second language is `?lang=`
  86. on the same comp, its VO mapped onto the authored timeline by `UIK.timeWarp` knots on words that mean the same
  87. thing, checked pixel-identical for the source language with `scripts/frame_diff.py`. The content stays the product's
  88. real output. Method, numbers and what bit: `references/product-demo.md`. It is a technique, not a look: palette,
  89. stage, camera grammar and transitions are chosen fresh in §2 every time.
  90. ### 5 · Compose — one file, pure functions of time, moves from the library
  91. ```bash
  92. mkdir -p cases/my-film && cp templates/comp.html lib/motion.js cases/my-film/ # the template loads motion.js → window.OM
  93. python3 scripts/probe.py my-film/comp.html # as soon as it plays end to end: what carries each boundary, each move's curve
  94. ```
  95. Pick moves by looking at `gallery/sheets/<move>.png` — six frames over the speed curve of what moves. The library
  96. has 39: entrances, carries, contact and live sims, camera and its projection helpers, and a fluid set (a light field, ripples, silk, a belt, SwiftUI springs); each is a function of time returning numbers for a DOM
  97. transform or a canvas call. Never re-derive a spring or an ease with fixed constants. The template is the
  98. motion-web film (kinetic words, typed prompt, ticking checklist, fly-throughs, live sims, a hold, staccato hits,
  99. one continuous hand path every sim reads from) — copy its beats only when that is the concept picked in §2;
  100. otherwise keep its contract and helpers and write the concept's own beats. Everything is `f(t)`; sims are pre-simulated once at 240 Hz and
  101. sampled. Preview `?play`, pin `?t=6.4&hud`. `references/motion-library.md`, `references/composition.md`.
  102. **The look ships with the comp.** `python3 scripts/look.py apply ember cases/my-film/comp.html` (or a `look.json`)
  103. writes `look.js` beside it: the eight colours as CSS variables and `LOOK.color`, three OFL faces subset to the glyphs
  104. the comp sets and inlined, so the `file://` render gets real type. Load it before the comp's script, write against
  105. `var(--ink)` / `var(--display)` or `LOOK.font('display', 96)`, and chain `window.__ready` on `LOOK.ready`. Re-run it
  106. after copy changes; it names any character a face lacks (`--cjk <font>` for Chinese / Japanese / Korean).
  107. **Camera: keyed, but operated.** `OM.camera(t, keys)` puts the camera where each beat needs it; the feel of an
  108. operator comes from how the keys are placed: key the subject ~0.1 s ahead on `sineInOut` to follow it, key the landing
  109. point before a snap on `expoInOut` to whip to it, add a hand (a slow two-sine float, zero in the holds) and `OM.shake`
  110. on every landing. Draw a faint `OM.lattice` farther back, or on an empty ground the move doesn't read. With a camera,
  111. `__track` returns screen boxes (`OM.projectBox`), `__motion` hands render.py the travel, and `__meta.inFrame` names
  112. what must never leave the frame. The method, with code: `references/composition.md` → *A camera*.
  113. ### 6 · Render — 1080p30 drafts, 4K60 only after acceptance
  114. ```bash
  115. python3 scripts/stills.py comp.html --times 0.7,2.4,3.8,6.2,9.9,12.7 --out stills.png # look before you render
  116. python3 scripts/render.py comp.html --out draft.mp4 --sfx sfx.wav # 1920×1080 · 30 fps · 180° shutter
  117. python3 scripts/render.py comp.html --out film.mp4 --final --sfx sfx.wav # 3840×2160 · 60 fps, once the cut is accepted
  118. ```
  119. The shutter is real motion blur: each moving frame is several seeks across the open shutter, averaged in linear
  120. light; holds are detected and skip it. A capture is a Chrome screenshot (~150 ms; the page itself draws in under 1 ms),
  121. so render.py runs `--workers` browsers in parallel processes (default cores − 2, max 8). A page that defines
  122. `window.__motion(t0, t1)` — the farthest anything travels on screen, camera included — gets as many captures per frame
  123. as keep copies 6 px apart (4–48); a fixed 8 stepped the one-dot film's 633 px/frame opening into bands. Budget: the
  124. one-dot camera cut took 103 s for 2,480 captures on 8 workers (one browser: ~0.2 s a capture, ~8.5 minutes) — tell
  125. the user the estimate before starting a long render. A WebGL comp renders with `--gpu` (Chromium on ANGLE/Metal);
  126. without it headless Chrome draws on SwiftShader at ~4× the cost (`references/3d.md`).
  127. ### 7 · Sound — a palette in a room, never one beep per event
  128. ```bash
  129. python3 scripts/sfx_palette.py --demo demo.wav # quick pass: the synthetic palette (see templates/sfx_score.example.py)
  130. python3 dump_events.py && python3 score.py # the films since one-dot: the comp's __events() → recorded + synthesised mix
  131. ```
  132. Two ways, one rule. The **palette** is five synthesised materials (air, wood, glass, sub, bubble) in one reverb, peaks
  133. at −8 dBFS so music can sit on top — enough for a draft. Every accepted film since one-dot uses a **score.py**: recorded
  134. sources (Kenney's CC0 packs, UIowa MIS, Voxengo IRs — not shipped here; download them yourself) layered with synthesis, timed and panned
  135. from `window.__events()`, convolution reverb, the music ducked under the hits, mastered to −16 LUFS with the ceiling
  136. low enough (−3.5 to −4 dBTP) that the AAC render stays under verify's −3 dBFS. Fewer events than beats either way: the
  137. first motion-web pass put a raw sine pop on every event and was rejected as 低劣 within a minute. Before shipping any
  138. recorded source inside a product, check its licence (Mixkit's does not allow redistributing the files). `references/sound.md`.
  139. **Music is royalty-free by default.** Look for a track licensed for reuse (NCS, Pixabay Music, the YouTube Audio
  140. Library, Free Music Archive under a CC licence that allows it) and keep its source and licence next to the score. A
  141. commercial or copyrighted track goes in only when the user supplies it and says so; never pull one in on your own.
  142. ### 8 · Verify before showing
  143. ```bash
  144. python3 scripts/verify_promo.py draft.mp4 --comp comp.html --ref ref.mp4 --shots 0,1.6,3.0,4.8,7.0,9.6,12.1,13.25,14.3
  145. ```
  146. Rhythm legs fail uniform shot lengths, no dead-still stretch, clipped or never-quiet audio. **burst** fails only
  147. when `--ref` has one and the film doesn't; without a reference it is a warning — a concept without hits isn't wrong.
  148. **continuity** fails beats that replace each other (carry score < 0.5) — the only leg that failed both rejected
  149. Pocket Weather cuts (v1 0.00, v2 0.40) while the accepted films passed (v3 0.75; motion-web 0.56, a warning).
  150. **curves** fails fast moves (> 80 px/frame) in a film without shutter blur. **framing** fails any frame where an id
  151. in `__meta.inFrame` is off frame (or, marked `'whole'`, cut) — the one-dot film's first camera render lost its dot
  152. behind a snap and nothing else noticed. With `--ref`, the reference's energy map and motion line print alongside.
  153. ## Hard rules (each one cost a cut)
  154. - **Never default to the template's story.** Three concepts that differ in their central idea; the user picks
  155. (§2). A new film in the template's beats reads as the template, however good the craft.
  156. - **Never carry the last film's look into the next.** Palette, stage, camera grammar, transitions: the tools
  157. (replica, narration, time warp) are reusable, the look is not. Name those choices in the concept round. A preset
  158. from `looks/` is fine when it is picked there by name; a silent default is not.
  159. - **A second language never forks the composition.** `?lang=`, a time warp, and the source cut checked
  160. pixel-identical. A copied comp doubles every later fix.
  161. - **Never cut on a metronome.** Equal shot lengths read as slides no matter how good each shot is.
  162. - **Never replace a beat — carry it.** Something on screen survives every section boundary and visibly moves or
  163. scales into the next beat. Mutually exclusive scenes (`display:none` swaps) are slides even with perfect rhythm.
  164. The exceptions are a burst of hard-cut hits and the end card.
  165. - **Never show a page as a thumbnail expecting its motion to read.** Either full-frame with the hand, or
  166. a *component* of it live in a card. Small cards of whole pages showed nothing.
  167. - **Never let the frame be always in motion.** Rests are what make the bursts land; the reference is
  168. still a third of the time.
  169. - **Small elements, big ground.** The genre's frame is 70 % white. Full-bleed footage is the exception
  170. (one calm hold), not the rule.
  171. - **The cause must be visible.** The hand drawn from the recorded path, or the concept's own subject — a dot that
  172. splits, a ball that lands. A page reacting to nothing reads as a screensaver.
  173. - **Moves from the library, curves chosen by t80.** One hand-rolled smootherstep everywhere makes every move the
  174. same soft S-curve; snaps (`ease.expoOut`, t80 .23) and springs are what lands.
  175. - **Fast moves need the shutter.** Over 80 px/frame without motion blur strobes into copies. render.py's default
  176. shutter is the fix; CSS blur is not.
  177. - **A camera that chases, and never loses the subject.** A still camera left the one-dot film 「就缺灵动的跟踪运镜」;
  178. a camera that chases what each beat frames was accepted. Declare `__meta.inFrame`; for a snap, key where it lands
  179. before it moves.
  180. - **Drafts at 1080p30.** No 4K60 render before the cut is accepted.
  181. - **No particles / confetti / speck bursts.** They read as a template. Let the type itself land with
  182. squash and wobble if a beat needs a flourish.
  183. - **One material set for sound, one room.** Every event getting its own synth tone is the audio version
  184. of the slideshow.
  185. - **Everything deterministic.** `__seek(t)` twice must give the same frame — the shutter depends on it; sims are
  186. precomputed from a fixed seed; no `Math.random()` on the render path (`OM.rng(seed)`).
  187. ## Files
  188. | path | what |
  189. |---|---|
  190. | `lib/motion.js` | the move library → `window.OM`: curves, springs, entrances, carries, contact, sims, camera, fluid |
  191. | `looks/looks.json` | six starting looks (eight colour tokens, three faces each) measured from accepted films; `looks/fonts/` the OFL faces and their licences |
  192. | `scripts/look.py` | `list` / `sheet` / `check` the looks, `from-shot` a look from product screenshots, `apply` → `look.js` with the faces subset and inlined |
  193. | `lib/ui_kit.js` | → `window.UIK`: a rebuilt UI on the plane (`stage`, `domLocal`, `rectCache`, `flow`), the content-hugging `glowRing`, legibility (`screenPx`, `zoomFor`), languages (`tr`, `loadFont`), `timeWarp` between a narration and the authored timeline, `subAt` |
  194. | `gallery/gallery.html` | one live demo per move (`?demo=ribbon&play`); `gallery/sheets/<move>.png` six frames + speed graph; `gallery/sheets/looks.png` the looks |
  195. | `scripts/analyze_ref.py` | reference → energy map, cuts, stillness, contact sheets, motion line (t80, smear), JSON |
  196. | `scripts/record_footage.py` | config → real-time recordings with action marker → 30 fps frames + paths |
  197. | `scripts/probe.py` | comp → what is on screen per frame → continuity per boundary, curves per move |
  198. | `scripts/render.py` | comp → mp4: 1080p30 draft by default, `--final` 4K60, shutter motion blur sized by `__motion`, parallel `--workers`, `--gpu` for WebGL, `.render.json` |
  199. | `scripts/stills.py` | comp → contact sheet of chosen times |
  200. | `scripts/vo_tools.py` | narration: `tts` (Kokoro, English and Japanese via a kana reading, auditions), `words` (faster-whisper), `plan` (line starts), `subs` (chunked, timed) |
  201. | `scripts/frame_diff.py` | two comps (or one with `?lang=`) at chosen times → identical or not, with diff images |
  202. | `scripts/sfx_palette.py` | the sound materials, the room, `Score` helper, `--demo` |
  203. | `scripts/verify_promo.py` | the acceptance oracle: rhythm legs, plus continuity, curves and framing with `--comp` |
  204. | `scripts/gallery.py` | gallery demos → sheets |
  205. | `scripts/test_motion.js` | `node scripts/test_motion.js` — the library's numbers |
  206. | `templates/comp.html` | composition skeleton (the motion-web film) on the library |
  207. | `templates/footage.example.json` | footage config used for the motion-web film |
  208. | `templates/sfx_score.example.py` | the motion-web sound score |
  209. | `references/reference-deconstruction.md` | how to read a reference in numbers |
  210. | `references/rhythm.md` | rhythm (motion-web's three cuts) and carry (Pocket Weather's three) |
  211. | `references/motion-library.md` | every move, applying it to DOM or canvas, the curve table, which carry for which boundary |
  212. | `references/composition.md` | the `f(t)` architecture, primitives, hand path, probe, render and shutter |
  213. | `references/sound.md` | palette, room, levels, what sounded cheap |
  214. | `references/product-demo.md` | feature demos without a recording: the replica, legibility, highlights from the DOM, narration, languages and the time warp, brand end clips, what bit |
  215. | `references/3d.md` | 3D films: Blender (MCP) model → GLB → three.js in the comp, the IIFE bundle for `file://`, `--gpu` (render with it: SwiftShader costs ~4×), instanced LODs, the chain as f(t) without physics, a 3D camera, text in the world that has to be read |
  216. | `cases/motion-web-15s/README.md` | case 1: the rhythm film — beat sheet and numbers |
  217. | `cases/one-dot-15s/README.md` | case 3: one dot is the whole film — the concept step, an operator's camera, recorded + synthesised sound |
  218. | `cases/knockon-15s/README.md` | case 4: the light chain-reaction film — causal carry, height from shadows, sound placed from the comp's `__events()` |
  219. | `cases/clearing-15s/README.md` | case 5: the one-take dive through scale — levels drawn in their own units, a screen-space camera for 1×–300×, sound driven by the zoom's speed |
  220. | `cases/pith-21s/README.md` | case 6: the reverse dive — 440× → 0.52× out of one phosphor pixel, the product's own dark→light theme flip as the film's one transition, a mascot close-up used as the rhythm break, and a claim built from seven objects already on screen |
  221. | `cases/ebb-15s/` | case 7: one take through five places, carried by a field of light — keyed camera with a hand, shake and depth, odometer digits, a flood that drains in rings onto the next scene, silk cards on belts at three depths |
  222. | `cases/domino-25s/README.md` | case 9: 12,346 phones, one pixel each — a measured Blender model instanced in three.js, trigger times on the music's grid, an FPV ride and stepped pull-back on the beat, a dense-chain foley swarm |
  223. | `cases/infra-25s/README.md` | case 10: every image starts as heat — a 2D film in a reference's own motion language, thermal false colour and per-pixel cooling as SVG filters on real photos (no canvas), the picture on a measured music grid, and a mix fixed by measuring it (a 141 ms flam, then foley and track sharing one low band) |
  224. | `cases/clawd-desktop-19s/README.md` | case 11: the mascot is the pointer — a macOS desktop as a glass tabletop in three.js, Liquid Glass windows by transmission, every UI action caused by the character's body (click, type, drag, the window's "no"), a camera that rides the Dock and rises for Mission Control, the track's own drop-out as the breath before the drop |
  225. | `cases/<film>/` | every film made with this skill: the film and a README (beat sheet, numbers, what was rejected and why). Also: overlap, unbroken, skill-demo, and onetake's own launch film. The films' source code is not included |
  226. Requires: python3 with `playwright` (chromium), `numpy`, `scipy`, `Pillow`, `matplotlib`, `fonttools` + `brotli` (looks); `opencv-python` for the
  227. motion line; `ffmpeg` / `ffprobe`; `node` for the library tests. Narration: `faster-whisper` (python3), and Kokoro
  228. (`kokoro-onnx`, `soundfile`, plus `misaki[ja]` and `unidic-lite` for Japanese) in `~/.cache/kokoro/venv`.
README.md · README · 248 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="assets/logo/onetake-icon.svg" alt="onetake icon" width="120">
  3. </p>
  4. <h1 align="center">
  5. <picture>
  6. <source media="(prefers-color-scheme: dark)" srcset="assets/logo/onetake-wordmark-on-cream.svg">
  7. <img src="assets/logo/onetake-wordmark.svg" alt="onetake" height="90">
  8. </picture>
  9. </h1>
  10. > **Motion films that never cut to the next slide.** A Claude Agent Skill that makes product launch films, teasers and feature demos where every beat grows out of the one before — one continuous take, not a stack of scenes.
  11. > **一镜到底的连贯动效。** 做产品发布片、预告片、功能演示:每一个画面都从上一个画面里长出来,是一整条连续的镜头,而不是一张张轮流出场的"PPT"。
  12. [![License: PolyForm Noncommercial](https://img.shields.io/badge/License-PolyForm%20Noncommercial%201.0.0-lightgrey.svg)](LICENSE)
  13. [![Type](https://img.shields.io/badge/Type-Agent%20Skill-333.svg)](SKILL.md)
  14. [![Cases](https://img.shields.io/badge/Cases-11%20films-orange.svg)](cases/)
  15. [![Continuity](https://img.shields.io/badge/Continuity-measured%20per%20boundary-brightgreen.svg)](scripts/verify_promo.py)
  16. **▶ Free for noncommercial use. Making films for clients or a business? [onetake Pro](https://onetakemotion.com) adds a commercial licence and every film's source — $79, one time.**\
  17. **▶ 免费版仅限非商业用途。接客户的活或公司使用,请用 [onetake Pro](https://onetakemotion.com):商业授权,加每部片子的完整源码,一次性 $79。**\
  18. **▶ New films every week → [@paojiaofty](https://x.com/paojiaofty) on X**
  19. ![onetake launch](assets/hero.gif)
  20. <sub>From onetake's own launch film. A prompt bar opens into the ad it asked for; the next prompt collapses into a line that shoots across the desk and opens into a festival screen. No cut. [Full film with sound →](cases/onetake-launch-30s/onetake-launch.mp4)</sub>
  21. ---
  22. [English](#english) | [中文说明](#chinese)
  23. ---
  24. <a name="english"></a>
  25. ## English
  26. ### The problem: motion that falls apart
  27. Most motion videos an AI makes today — and most template tools — come out **loose**. Title card, fade, UI shot, fade,
  28. feature card, fade, logo. Each shot can look fine and the whole still reads like a slideshow, because nothing
  29. connects one beat to the next: scenes *replace* each other.
  30. ### What onetake does differently: every beat is carried
  31. onetake treats the boundary between two beats as the thing to design. At every boundary, **something on screen
  32. survives and visibly becomes the next beat**:
  33. - the prompt bar **opens into** the app window; the window **reflows into** the phone;
  34. - a bar **collapses into a line**, the line **shoots across** the desk and **becomes the first grid line** of the next film;
  35. - a card **grows into** the page; a stage **opens from** the character; the camera **pushes through** a card until it *is* the next scene;
  36. - at the end, the cast **folds into** the lockup — in the launch film, the block cursor **writes the name** in one stroke.
  37. And **one camera holds it all together**. It never cuts: it follows the subject a beat ahead, whips to where the next
  38. thing will land, floats like a hand-held operator and shakes when something hits — then holds dead still, because rests
  39. are what make the moves land.
  40. ### Continuity is measured, not hoped for
  41. Every film is checked by an oracle before a human watches it. `probe.py` records what is on screen in every frame, finds
  42. each boundary, and asks what carried across it. A film whose beats replace each other fails.
  43. | film | verdict | continuity (carry score) |
  44. |---|---|---|
  45. | an earlier launch film, v1 — perfect rhythm, still a slideshow | rejected | **0.00** |
  46. | the same film, v2 | rejected | **0.40** |
  47. | the same film, v3 — every beat grows out of the last | accepted | **0.75** |
  48. | onetake launch film | accepted | **0.83** |
  49. The same oracle fails uniform cadence (shots all the same length), no stillness, clipped audio, fast moves without
  50. motion blur, and a subject that leaves the frame.
  51. ### What makes it look finished
  52. - **Real UI, rebuilt.** The product's interface is rebuilt in HTML from screenshots and sits on the camera's plane, so the camera can fly into it at any zoom. No screen recording.
  53. - **Measured moves.** ~38 moves (springs, entrances, carries, contact, sims, camera, fluid grounds), each a pure function of time with its speed curve measured — never a hand-rolled ease.
  54. - **Real motion blur.** Every moving frame is several captures across an open 180° shutter, averaged in linear light. Fast moves smear instead of strobing.
  55. - **Sound in one room.** Foley and synthesis placed from the film's own events, in one reverb, ducking the music under the hits.
  56. - **Deterministic.** Seek to any time, get the same frame. Drafts at 1080p30, finals at 4K60.
  57. ### 🌟 Films made with it
  58. Every case ships the finished film and a breakdown (concept, beat sheet, numbers, what was rejected and why). The
  59. films' source code is not included.
  60. <table>
  61. <tr><th colspan="3" align="left">Concept ad</th></tr>
  62. <tr>
  63. <td width="33%" align="center"><b>domino</b><br/><img src="assets/cases/domino.gif" width="100%"/><br/>
  64. <sub>One phone is one pixel: 12,346 phones fall and a picture resolves, 1 → 100×100, one take in 3D</sub><br/>
  65. <a href="cases/domino-25s/domino.mp4">▶ Film</a> | <a href="cases/domino-25s/README.md">📖 Breakdown</a></td>
  66. <td width="33%" align="center"><b>overlap</b><br/><img src="assets/cases/overlap.gif" width="100%"/><br/>
  67. <sub>Two print passes slide into register — and an & appears that was hidden in both</sub><br/>
  68. <a href="cases/overlap-15s/overlap.mp4">▶ Film</a> | <a href="cases/overlap-15s/README.md">📖 Breakdown</a></td>
  69. <td width="33%" align="center"><b>infra</b><br/><img src="assets/cases/infra.gif" width="100%"/><br/>
  70. <sub>Every image starts as heat: a thermal field resolves block by block and cools into the photo</sub><br/>
  71. <a href="cases/infra-25s/infra.mp4">▶ Film</a> | <a href="cases/infra-25s/README.md">📖 Breakdown</a></td>
  72. </tr>
  73. <tr><th colspan="3" align="left">Launch film</th></tr>
  74. <tr>
  75. <td width="33%" align="center"><b>onetake launch</b><br/><img src="assets/cases/onetake-launch.gif" width="100%"/><br/>
  76. <sub>Three prompts, three films, one take — each prompt visibly becomes its film</sub><br/>
  77. <a href="cases/onetake-launch-30s/onetake-launch.mp4">▶ Film</a> | <a href="cases/onetake-launch-30s/README.md">📖 Breakdown</a></td>
  78. <td width="33%" align="center"><b>one-dot</b><br/><img src="assets/cases/one-dot.gif" width="100%"/><br/>
  79. <sub>One dot is the whole film: caret → menu → loading ring → spring curve → the dot on the i</sub><br/>
  80. <a href="cases/one-dot-15s/one-dot.mp4">▶ Film</a> | <a href="cases/one-dot-15s/README.md">📖 Breakdown</a></td>
  81. <td width="33%" align="center"><b>pith</b><br/><img src="assets/cases/pith.gif" width="100%"/><br/>
  82. <sub>The window grows out of one phosphor pixel: 440× → 0.52× in one move</sub><br/>
  83. <a href="cases/pith-21s/pith.mp4">▶ Film</a> | <a href="cases/pith-21s/README.md">📖 Breakdown</a></td>
  84. </tr>
  85. <tr><th colspan="3" align="left">App promo</th></tr>
  86. <tr>
  87. <td width="33%" align="center"><b>knockon</b><br/><img src="assets/cases/knockon.gif" width="100%"/><br/>
  88. <sub>A chain reaction: every beat is the collision that starts the next</sub><br/>
  89. <a href="cases/knockon-15s/knockon.mp4">▶ Film</a> | <a href="cases/knockon-15s/README.md">📖 Breakdown</a></td>
  90. <td width="33%" align="center"><b>clearing</b><br/><img src="assets/cases/clearing.gif" width="100%"/><br/>
  91. <sub>One zoom from a year to a free half hour — 1× to 300× and back, never a cut</sub><br/>
  92. <a href="cases/clearing-15s/clearing.mp4">▶ Film</a> | <a href="cases/clearing-15s/README.md">📖 Breakdown</a></td>
  93. <td width="33%" align="center"><b>ebb</b><br/><img src="assets/cases/ebb.gif" width="100%"/><br/>
  94. <sub>A field of light carries the take through five places; each flood drains onto the next</sub><br/>
  95. <a href="cases/ebb-15s/ebb.mp4">▶ Film</a> | <a href="cases/ebb-15s/README.md">📖 Breakdown</a></td>
  96. </tr>
  97. <tr><th colspan="3" align="left">Feature demo</th></tr>
  98. <tr>
  99. <td width="33%" align="center"><b>skill-demo</b><br/><img src="assets/cases/skill-demo.gif" width="100%"/><br/>
  100. <sub>An operation demo from nothing: the chosen menu row flies into the input as a chip, and on from there</sub><br/>
  101. <a href="cases/skill-demo-15s/skill-demo.mp4">▶ Film</a> | <a href="cases/skill-demo-15s/README.md">📖 Breakdown</a></td>
  102. <td width="33%" align="center"><b>motion-web</b><br/><img src="assets/cases/motion-web.gif" width="100%"/><br/>
  103. <sub>Where the rhythm rules came from: small UI, big ground, rests, then a burst</sub><br/>
  104. <a href="cases/motion-web-15s/motion-web.mp4">▶ Film</a> | <a href="cases/motion-web-15s/README.md">📖 Breakdown</a></td>
  105. <td width="33%" align="center"><b>clawd</b><br/><img src="assets/cases/clawd.gif" width="100%"/><br/>
  106. <sub>The mascot is the pointer: Clawd clicks, types and drags across a glass macOS desktop with its body, in 3D</sub><br/>
  107. <a href="cases/clawd-desktop-19s/clawd.mp4">▶ Film</a> | <a href="cases/clawd-desktop-19s/README.md">📖 Breakdown</a></td>
  108. </tr>
  109. </table>
  110. > one-dot and skill-demo were made when the skill was still called *ohmymotion*; the films show that name.
  111. ### How a film is made
  112. 1. **Deconstruct the reference in numbers:** how much of it is still, where it cuts, how its moves ease.
  113. 2. **Three concepts, pick one.** Each is one sentence about the *picture* — "one dot becomes everything", "one zoom through scale" — not three stories told with the same cards.
  114. 3. **A beat sheet for rhythm *and* carry.** Shot lengths vary by ≥ 4×, and every boundary names what survives it.
  115. 4. **Compose** one HTML file on the move library. **Render** with motion blur. **Score** the sound from the film's events.
  116. 5. **Verify**, then show a human.
  117. ### 📦 Installation
  118. ```bash
  119. # Claude Code
  120. git clone https://github.com/feitangyuan/onetake.git ~/.claude/skills/onetake
  121. # Codex / other agents that read skills
  122. git clone https://github.com/feitangyuan/onetake.git ~/.agents/skills/onetake
  123. ```
  124. Then ask: *"Make a 15 s launch video for my app"*, *"a feature demo rebuilt from these screenshots, no screen
  125. recording"*, *"my motion video feels like a slideshow — fix it"*.
  126. **Requires** python3 with `playwright` (chromium), `numpy`, `scipy`, `Pillow`, `matplotlib` (`opencv-python` for
  127. reference analysis), `ffmpeg`, `node`. Narration adds `faster-whisper` and Kokoro TTS. Music is royalty-free by default.
  128. | | |
  129. |---|---|
  130. | `SKILL.md` | the protocol and the hard rules each rejected cut taught |
  131. | `lib/motion.js` · `lib/ui_kit.js` | the move library; the UI-rebuild kit |
  132. | `scripts/` | render (motion blur, 4K60), verify (the oracle), probe, stills, reference analysis, footage, narration, sound |
  133. | `gallery/` | one live demo and one six-frame sheet per move |
  134. | `references/` | rhythm, carry, composition, camera, sound, product demos — the method with its numbers |
  135. ### License
  136. [PolyForm Noncommercial 1.0.0](LICENSE): free for personal, educational, research and other noncommercial use.
  137. **Commercial use is not permitted.** Need commercial use? [onetake Pro](https://onetakemotion.com) adds a commercial licence plus every film's source.
  138. ---
  139. <a name="chinese"></a>
  140. ## 中文说明
  141. ### 问题:动效是散的
  142. 现在大多数 AI 做出来的动效视频,还有大多数模板工具做出来的,都是**散的**。
  143. 标题卡、淡出、界面镜头、淡出、功能卡片、淡出、Logo。每一镜单看也许都不错,合起来还是像在翻 PPT。
  144. 原因是画面和画面之间没有任何联系,后一个场景只是把前一个**替换**掉了。
  145. ### onetake 不一样:每个画面都被"接住"
  146. onetake 把两个画面之间的交接处当成设计的重点。每一个交接处,**都有一个东西活下来,并且看得见地变成下一个画面**:
  147. - 输入框**展开成** App 窗口,窗口再**重排成**手机界面;
  148. - 输入框**压成一条线**,这条线**划过桌面**,**变成**下一条片子的第一根网格线;
  149. - 卡片**长成**整个页面;舞台从角色身上**打开**;镜头**穿过**一张卡片,穿过去就是下一个场景;
  150. - 结尾,所有元素**收拢成**标志。在 onetake 自己的发布片里,是光标一笔**写出**名字。
  151. **把这一切串起来的是同一个镜头。** 它从不剪断:提前半拍跟着主体走,抢在下一个东西落地前甩过去,像手持一样轻微浮动,东西撞上来时跟着一震;
  152. 该停的时候又能完全静止,因为有停顿,动作才落得下来。
  153. ### 连贯是量出来的,不是靠感觉
  154. 每条片子给人看之前,先过一遍自动验收。`probe.py` 记录每一帧画面上有什么,找出每一个交接处,再判断有没有东西从这边带到那边。
  155. 画面互相替换的片子,直接判不合格。
  156. | 片子 | 结果 | 连贯度(carry score) |
  157. |---|---|---|
  158. | 更早的一条发布片 v1:节奏完美,仍然像 PPT | 被否 | **0.00** |
  159. | the same film, v2 | 被否 | **0.40** |
  160. | 同一条片子 v3:每个画面从上一个里长出来 | 通过 | **0.75** |
  161. | onetake 发布片 | 通过 | **0.83** |
  162. 同一套验收还会判掉这些问题:镜头长度全都一样、没有静止段落、音频爆音、快动作没有运动模糊、主体出画。
  163. ### 为什么看起来像成品
  164. - **复刻的真实界面**:按截图用 HTML 重建产品界面,放在镜头所在的平面上,推到多近都清楚,不需要录屏。
  165. - **实测过的动作**:约 38 个动作(弹簧、入场、衔接、碰撞、物理模拟、镜头、流体光场),每个都是时间的纯函数,速度曲线都实测过,不用随手写的缓动。
  166. - **真实运动模糊**:每个运动帧都是快门张开期间的多次采样,在线性光下平均。快动作会拖出残影,而不是一格一格地闪。
  167. - **同一个空间里的声音**:音效按片子里的事件摆放,放在同一个混响里,打点的地方音乐自动让位。
  168. - **结果确定**:跳到任意时间,得到的都是同一帧。草稿 1080p30,成片 4K60。
  169. ### 案例
  170. 上面的表格里有 12 条用它做的片子,每条都附成片和拆解文档(概念、节拍表、数据、被否掉的版本和原因)。**不包含片子的源代码。**
  171. 其中 one-dot 和 skill-demo 做的时候 skill 还叫 *ohmymotion*,画面里是旧名字。
  172. ### 一条片子怎么做出来
  173. 1. **先把参考片拆成数字**:静止占多少、在哪里剪、动作怎么缓动。
  174. 2. **出三个概念,选一个**:每个概念是一句关于画面的话,比如"一个点变成一切""一个镜头穿过所有尺度",而不是同一套卡片换三种讲法。
  175. 3. **写节拍表,节奏和衔接都要写**:镜头长短相差 4 倍以上,每个交接处都写明是什么东西活下来。
  176. 4. **合成、渲染、配音**:在动作库上写一个 HTML 文件,带运动模糊渲染,按片子里的事件配声音。
  177. 5. **过验收,再给人看。**
  178. ### 安装
  179. ```bash
  180. # Claude Code
  181. git clone https://github.com/feitangyuan/onetake.git ~/.claude/skills/onetake
  182. # Codex 等读取 skills 的 Agent
  183. git clone https://github.com/feitangyuan/onetake.git ~/.agents/skills/onetake
  184. ```
  185. 然后直接说:「给我的 App 做个 15 秒发布视频」「按这几张截图复刻界面做功能演示,不录屏」「我的动效视频像 PPT,帮我改」。
  186. **依赖**:python3(`playwright` + chromium、`numpy`、`scipy`、`Pillow`、`matplotlib`,分析参考片需要 `opencv-python`)、`ffmpeg`、`node`。
  187. 配音需要 `faster-whisper` 和 Kokoro TTS。音乐默认用免版权曲库。
  188. ### 许可证
  189. [PolyForm Noncommercial 1.0.0](LICENSE):个人、学习、研究等**非商业用途免费使用,不允许商用**。需要商用请看 [onetake Pro](https://onetakemotion.com):商业授权,加每部片子的完整源码。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.