Skip to content

Claude Code skill that makes launch videos, ads and music videos from one line: idea, script, visuals, voice, music, edit and review, then a review room where your notes make the next take

Character life: blinks, eyes that lead, limbs that settle

Tal Siachce2d5229a30c
diff --git a/SKILL.md b/SKILL.md
index d27973c..41a4522 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -182,7 +182,7 @@ After the yes on the pitch and before the build, the storyboard artist draws eve
- Tile them with `scripts/storyboard-sheet.sh <frames folder> storyboard.png` and show the sheet. In stages, wait for a yes or edits. On a run, read it yourself the way a stranger would, fix what does not read, and post the sheet with the storyboard artist's line.
### 3b. Character department (any film with a character who moves)
-Before any scene is animated, build the character properly and get the user's approval on motion, not stills: a real skeleton (fixed bone lengths, joint limits, 2-bone IK for arms and legs, foot planting), drawn head views and hand shapes (never procedurally bent faces or fingers), a pose library of the poses the film needs, and short motion tests (walk cycle, sit/stand, reach and grip, the film's key actions). Animators then use only approved poses and motions. Lesson from a song clip: stills approved, film failed, because animators improvised limbs on a loose figure and joints twisted in motion. Keep code characters stylized.
+Before any scene is animated, build the character properly and get the user's approval on motion, not stills: a real skeleton (fixed bone lengths, joint limits, 2-bone IK for arms and legs, foot planting), drawn head views and hand shapes (never procedurally bent faces or fingers), a pose library of the poses the film needs, and short motion tests (walk cycle, sit/stand, reach and grip, the film's key actions). Animators then use only approved poses and motions. Lesson from a song clip: stills approved, film failed, because animators improvised limbs on a loose figure and joints twisted in motion. Keep code characters stylized. For blinks, eyes that lead, and limbs that settle without wobble, read `references/character-life.md` (helpers in `scripts/life.js`).
### 4. Build
Set up a project folder from the style's engine (the style file says how; a brand film with no style file starts from `bash scripts/new-canvas-project.sh <dir>`), then build shot by shot. Have the music and its beat map before building, so the cut follows it (the music part of step 6). Every frame must be a pure function of time `t` (seeded randomness only), so frames can render in parallel and out of order.
@@ -252,4 +252,4 @@ Put the MP4 somewhere obvious (Desktop or Downloads), named plainly (`<name>.mp4
- `references/reviewer-brief.md` + `scripts/review-pack.sh` : the fresh reviewer's pack and brief, and what to do when the owner's taste and the reviewer disagree
- `scripts/render-parallel.sh` : render a long film in pieces, three browsers at a time by default
- `scripts/unbundle.py` : unpacker for the frame bundles used when capturing a real product's canvas in the browser (`references/real-product.md`)
-- `scripts/` : `serve.mjs`, `frames.mjs`, `export.mjs` (`SUB=N` motion blur), `springs.js` (closed-form springs), `gate.mjs` (determinism, contract, dead air, pops), `audit-faces.mjs`, `mux-audio.sh`, `contact-sheet.sh`, `new-canvas-project.sh`
+- `scripts/` : `serve.mjs`, `frames.mjs`, `export.mjs` (`SUB=N` motion blur), `springs.js` (closed-form springs), `life.js` (blinks, eyes that lead, limbs that settle), `gate.mjs` (determinism, contract, dead air, pops), `audit-faces.mjs`, `mux-audio.sh`, `contact-sheet.sh`, `new-canvas-project.sh`
diff --git a/THIRD_PARTY.md b/THIRD_PARTY.md
index edf9454..e6e2bff 100644
--- a/THIRD_PARTY.md
+++ b/THIRD_PARTY.md
@@ -16,6 +16,7 @@ The files adapted from anidoodle stay under the Apache License 2.0. Everything e
| What | Where | Upstream | Licence |
|---|---|---|---|
| Closed-form springs, launch-video motion moves, the axes of the review score and the subframe motion-blur filter (Raphael Aubry) | `scripts/springs.js` (own implementation), `references/motion-kit.md`, `references/timing.md`, the rubric in `SKILL.md` and `references/quality-checklist.md`, one filter line in `scripts/export.mjs` | github.com/howseen-ai/claude-motion-design | MIT |
+| Character life: blinks placed on head turns with their timings, pose chains that never stop dead, follow-through as a delayed copy of the parent (rossark0) | `references/character-life.md`, `scripts/life.js` (own implementation) | github.com/rossark0/rossark-motion-skill | MIT |
| Asking of every shot whether it is a page or a picture, and measuring a film's text with a script (Tejas Makwana) | `references/page-or-picture.md`, `scripts/text-audit.mjs` (own script; its corner test uses the same thresholds) | github.com/Tejashmakwana/motionmaxxing | Apache-2.0 |
| Banning the default look by name, a number in place of every adjective, and the easing, spring and stagger numbers (Florence, "Opus 5.5 Motion Lab") | `references/directed-look.md`, sections 1 and 3 (own words) | x.com/flxrnc/status/2105311836190978392 | A published guide; ideas only, none of its text or prompts |
diff --git a/references/character-life.md b/references/character-life.md
new file mode 100644
index 0000000..bbf4dbe
--- /dev/null
+++ b/references/character-life.md
@@ -0,0 +1,10 @@
+# Character life (code-drawn characters)
+
+Read this when a drawn character moves on screen. It is what made the same figure, with the same poses and timing, read as more alive in three blind tests (wide shot, close-up, medium shot). The helpers are in `scripts/life.js`.
+
+1. **Blink on the head turns, never on a timer.** Close fast, open slower (`blinkLid`: 110 ms, 40 ms, 190 ms). One blink as each head turn starts, and one in a long hold. In the close-up test this was the difference the viewer named.
+2. **The eyes get there first.** Read the head's keys about 0.1 s ahead for the gaze (`eyesLead`).
+3. **Limbs settle, they do not wobble.** Chain a character's poses with `flow` (it keeps moving through a pose and never overshoots), and let child parts trail their parent with `settle` (forearm after upper arm, back hair after the head). Springs stay right for objects and interface; on a body they bounce like rubber. In the wide-shot test, the arm coming down was what the viewer called more real.
+4. **Hands stay on what they hold.** Draw a held object from the hand's position every frame, never on its own path.
+
+Breathing and slow sway were in the tests too, and nobody noticed them; add them only if a long hold looks frozen. Left and right never move as mirror images.
diff --git a/scripts/life.js b/scripts/life.js
new file mode 100644
index 0000000..5d7f8a6
--- /dev/null
+++ b/scripts/life.js
@@ -0,0 +1,56 @@
+(function () {
+// Life for code-drawn characters: every value is a pure function of t (seconds), so frames render in any order.
+// Tested blind on 23 Oct 2026: wide shot, close-up and medium shot; the version with these won all three.
+// Idea credit: rossark0's rossark-motion-skill (MIT). This implementation is our own.
+//
+// <script src="life.js"></script> then const { flow, blinkLid, eyesLead, settle } = window.Life;
+// const pitch = flow(KEYS.pitch, t); // a pose chain that never stops dead or overshoots
+// const lid = blinkLid(t, [1.52, 4.52, 7.05]); // 0 open .. 1 shut; put blinks where the head turns
+// const gaze = eyesLead(KEYS.look, t); // eyes arrive about 0.1 s before the head
+// const fore = armBend + settle(KEYS.upperArm, t); // a child limb trails its parent, no wobble
+
+const easeIO = x => (x < 0.5 ? 4 * x * x * x : 1 - Math.pow(-2 * x + 2, 3) / 2);
+
+// Monotone cubic through [[time, value], ...]: keeps moving through a pose, never overshoots.
+function flow(keys, t) {
+ const n = keys.length;
+ if (t <= keys[0][0]) return keys[0][1];
+ if (t >= keys[n - 1][0]) return keys[n - 1][1];
+ const x = keys.map(k => k[0]), y = keys.map(k => k[1]), d = [], m = [];
+ for (let i = 0; i < n - 1; i++) d.push((y[i + 1] - y[i]) / (x[i + 1] - x[i]));
+ m[0] = d[0]; m[n - 1] = d[n - 2];
+ for (let i = 1; i < n - 1; i++) m[i] = d[i - 1] * d[i] <= 0 ? 0 : (d[i - 1] + d[i]) / 2;
+ for (let i = 0; i < n - 1; i++) {
+ if (d[i] === 0) { m[i] = 0; m[i + 1] = 0; continue; }
+ const a = m[i] / d[i], b = m[i + 1] / d[i], s = a * a + b * b;
+ if (s > 9) { const k = 3 / Math.sqrt(s); m[i] = k * a * d[i]; m[i + 1] = k * b * d[i]; }
+ }
+ let i = 0; while (t > x[i + 1]) i++;
+ const h = x[i + 1] - x[i], u = (t - x[i]) / h, u2 = u * u, u3 = u2 * u;
+ return (2 * u3 - 3 * u2 + 1) * y[i] + (u3 - 2 * u2 + u) * h * m[i] + (-2 * u3 + 3 * u2) * y[i + 1] + (u3 - u2) * h * m[i + 1];
+}
+
+// Lid closure for blinks starting at the given times: close 110 ms, hold 40 ms, open 190 ms.
+// Render at 60 fps or keep blinks at least this long: shorter ones flicker at 30 fps.
+function blinkLid(t, times) {
+ let lid = 0;
+ for (const b of times) {
+ const u = t - b;
+ if (u >= 0 && u < 0.11) lid = Math.max(lid, easeIO(u / 0.11));
+ else if (u >= 0.11 && u < 0.15) lid = 1;
+ else if (u >= 0.15 && u < 0.34) lid = Math.max(lid, Math.pow(1 - (u - 0.15) / 0.19, 3));
+ }
+ return lid;
+}
+
+// The same keys as the head, read a little ahead, so the eyes get there first.
+const eyesLead = (keys, t, lead = 0.1) => flow(keys, t + lead);
+
+// Follow-through as a delayed copy of the parent: add this to the child's own angle.
+// It trails the parent and catches up without the wobble a spring would add.
+const settle = (parentKeys, t, delay = 0.09, strength = 0.45) => strength * (flow(parentKeys, t - delay) - flow(parentKeys, t));
+
+const api = { flow, blinkLid, eyesLead, settle };
+if (typeof window !== 'undefined') window.Life = api;
+if (typeof module !== 'undefined') module.exports = api;
+})();