takomi 2.5.1 → 2.5.4

package/assets/.agent/skills/embedded-captions/references/motion-vocabulary.md

@@ -1,148 +1,148 @@
-# Motion Vocabulary — named word-entry moves
-
-10 motion primitives the skill uses. Each has a specific timing + easing + situational fit. Agent picks by **content tone**, not default to one.
-
-**Easing philosophy:** `cubic-bezier(.2,.7,.2,1)` is the "considered confident" default. `linear` is almost always wrong. Back-easing (elastic) is for playful content only — never documentary.
-
-**Exit rules:** Default exit is the same tween reversed at 60% duration. Never exit with a different motion than entry unless doing a rhetorical pivot. Never fade out during speech — only during the gap between phrases.
-
----
-
-## The 10 moves
-
-### 1. typewriter
-
-Char-by-char reveal, 25–35ms/char, linear easing. Documentary / data-heavy / tense / interrogative.
-
-```js
-// GSAP
-words.forEach((w, i) => {
-  const chars = w.textContent.split("");
-  w.textContent = "";
-  chars.forEach((c, j) => {
-    const span = document.createElement("span");
-    span.textContent = c;
-    span.style.opacity = 0;
-    w.appendChild(span);
-    tl.to(span, { opacity: 1, duration: 0 }, wordStart + j * 0.028);
-  });
-});
-```
-
-### 2. word-fade-up (DEFAULT)
-
-Per-word, 80ms stagger, `opacity 0→1 + translateY 8→0`, `cubic-bezier(.2,.7,.2,1)` (ease-out). Default for conversational content.
-
-```js
-tl.fromTo(
-  word,
-  { opacity: 0, y: 8 },
-  { opacity: 1, y: 0, duration: 0.45, ease: "power2.out" },
-  wordStart,
-);
-```
-
-### 3. word-pop
-
-Per-word, 60ms stagger, `scale 0.85→1 + opacity 0→1`, elastic-light `cubic-bezier(.34,1.56,.64,1)`. Energetic / YouTube-vlog / high-tempo. **Never for documentary.**
-
-### 4. swipe-reveal
-
-Whole phrase at once, 400ms, `clip-path inset 0 100% 0 0 → 0 0 0 0`, expo `cubic-bezier(.77,0,.175,1)`. Keynote / tech product / announcement.
-
-```css
-.cap {
-  clip-path: inset(0 100% 0 0);
-}
-/* animate to inset(0 0 0 0) */
-```
-
-### 5. drop-and-settle
-
-Per-word, 120ms stagger, `y: -30→0` with back-bounce `cubic-bezier(.68,-.55,.27,1.55)`. Playful but controlled. **Not for documentary.**
-
-### 6. etch
-
-Whole word at once, 600ms, opacity ramp `0→1` with slight blur→sharp transition. Ease-in-out. Poetic / lyrical / "quote on wall" direction.
-
-### 7. crosshair
-
-Per-word, 200ms total: two 1px lines converge on word center (linear 150ms), then word snaps in (expo-out 50ms). Thriller / investigative doc.
-
-### 8. breathing-hold
-
-**Static but alive.** No entry animation. Once visible, micro-scale loop `1.00↔1.008` over 2s, sine ease. Used on climax lines held 1.5s+.
-
-### 9. cascade
-
-Each word from alternating direction: L, R, L, R. `translateX: ±40→0`, ease-out 300ms. **Rhythm-break move** — use sparingly, once per 30s max.
-
-### 10. burn-in
-
-**Zero animation.** Sudden 1-frame opacity 1. No fade, no transform. Interview-doc style. Use for every 6–8th phrase in a documentary direction for variety (Standard mode; see direction-catalog §1).
-
----
-
-## Tone → timing lookup table
-
-| Tone           | Stagger                   | Hold        | Entry move                         |
-| -------------- | ------------------------- | ----------- | ---------------------------------- |
-| documentary    | 150ms                     | 600ms       | burn-in (70%) + word-fade-up (30%) |
-| conversational | 80ms                      | 400ms       | word-fade-up                       |
-| energetic      | 50ms                      | 300ms       | word-pop                           |
-| poetic         | 250ms                     | 1200ms      | etch                               |
-| broadcast      | 0 (burn-in)               | BBC timings | burn-in                            |
-| investigative  | 25ms/char                 | 500ms       | typewriter                         |
-| keynote        | 0 per-word (phrase swipe) | 600ms       | swipe-reveal                       |
-
-Agent picks tone → this table → GSAP parameters. Data, not guesswork.
-
----
-
-## Per-word vs per-phrase animation axis
-
-Orthogonal to the 10 moves above.
-
-- **Per-word animation** (default): each word enters at its `w.start` timestamp. Tight sync with speech.
-- **Per-phrase animation**: whole group enters/exits at `g.in`/`g.out`. Words appear together. Used for:
-  - swipe-reveal moves
-  - burn-in (no animation, but the "reveal" is a group event)
-  - title cards / chapter breaks
-
-Rule: per-word for content that tracks speech; per-phrase for moments that step outside the speech flow.
-
----
-
-## Stagger breakdown by context
-
-Fine-tune stagger within a tone:
-
-- **Documentary dialog**: 150ms (measured)
-- **Documentary punchline**: 250ms (weighted)
-- **Vlog opener**: 50ms (fast hook)
-- **Vlog narration**: 70ms (conversational but snappy)
-- **Poem / lyric**: 250–400ms per word, with 500–1000ms gaps between phrases
-- **Keynote hero**: per-phrase only (stagger = N/A)
-- **Interview name card**: 0 stagger (static)
-
----
-
-## Anti-patterns (banned, from anti-patterns.md)
-
-- Animating `letter-spacing` → reflow
-- Animating `filter:blur` → reflow + can wash out text
-- `Math.random()` / `Date.now()` in timeline → non-deterministic render
-- Entries under 100ms total → frantic, unreadable
-- Same motion for every group for 30s+ → eye adapts, stops registering
-
----
-
-## When to break the vocabulary
-
-The 10 moves are a comfortable coverage, not a ceiling. For Standard mode, invent new moves when the scene demands it:
-
-- Kyle Cooper's scratched typewriter for noir
-- K-pop lyric's directional word-from-side
-- Film-title flash-cut burn-in with chromatic aberration
-
-When inventing: stay deterministic, stay transform+opacity only, state the motion in terms of the 4 axes (entry, hold, exit, stagger).
+# Motion Vocabulary — named word-entry moves
+
+10 motion primitives the skill uses. Each has a specific timing + easing + situational fit. Agent picks by **content tone**, not default to one.
+
+**Easing philosophy:** `cubic-bezier(.2,.7,.2,1)` is the "considered confident" default. `linear` is almost always wrong. Back-easing (elastic) is for playful content only — never documentary.
+
+**Exit rules:** Default exit is the same tween reversed at 60% duration. Never exit with a different motion than entry unless doing a rhetorical pivot. Never fade out during speech — only during the gap between phrases.
+
+---
+
+## The 10 moves
+
+### 1. typewriter
+
+Char-by-char reveal, 25–35ms/char, linear easing. Documentary / data-heavy / tense / interrogative.
+
+```js
+// GSAP
+words.forEach((w, i) => {
+  const chars = w.textContent.split("");
+  w.textContent = "";
+  chars.forEach((c, j) => {
+    const span = document.createElement("span");
+    span.textContent = c;
+    span.style.opacity = 0;
+    w.appendChild(span);
+    tl.to(span, { opacity: 1, duration: 0 }, wordStart + j * 0.028);
+  });
+});
+```
+
+### 2. word-fade-up (DEFAULT)
+
+Per-word, 80ms stagger, `opacity 0→1 + translateY 8→0`, `cubic-bezier(.2,.7,.2,1)` (ease-out). Default for conversational content.
+
+```js
+tl.fromTo(
+  word,
+  { opacity: 0, y: 8 },
+  { opacity: 1, y: 0, duration: 0.45, ease: "power2.out" },
+  wordStart,
+);
+```
+
+### 3. word-pop
+
+Per-word, 60ms stagger, `scale 0.85→1 + opacity 0→1`, elastic-light `cubic-bezier(.34,1.56,.64,1)`. Energetic / YouTube-vlog / high-tempo. **Never for documentary.**
+
+### 4. swipe-reveal
+
+Whole phrase at once, 400ms, `clip-path inset 0 100% 0 0 → 0 0 0 0`, expo `cubic-bezier(.77,0,.175,1)`. Keynote / tech product / announcement.
+
+```css
+.cap {
+  clip-path: inset(0 100% 0 0);
+}
+/* animate to inset(0 0 0 0) */
+```
+
+### 5. drop-and-settle
+
+Per-word, 120ms stagger, `y: -30→0` with back-bounce `cubic-bezier(.68,-.55,.27,1.55)`. Playful but controlled. **Not for documentary.**
+
+### 6. etch
+
+Whole word at once, 600ms, opacity ramp `0→1` with slight blur→sharp transition. Ease-in-out. Poetic / lyrical / "quote on wall" direction.
+
+### 7. crosshair
+
+Per-word, 200ms total: two 1px lines converge on word center (linear 150ms), then word snaps in (expo-out 50ms). Thriller / investigative doc.
+
+### 8. breathing-hold
+
+**Static but alive.** No entry animation. Once visible, micro-scale loop `1.00↔1.008` over 2s, sine ease. Used on climax lines held 1.5s+.
+
+### 9. cascade
+
+Each word from alternating direction: L, R, L, R. `translateX: ±40→0`, ease-out 300ms. **Rhythm-break move** — use sparingly, once per 30s max.
+
+### 10. burn-in
+
+**Zero animation.** Sudden 1-frame opacity 1. No fade, no transform. Interview-doc style. Use for every 6–8th phrase in a documentary direction for variety (Standard mode; see direction-catalog §1).
+
+---
+
+## Tone → timing lookup table
+
+| Tone           | Stagger                   | Hold        | Entry move                         |
+| -------------- | ------------------------- | ----------- | ---------------------------------- |
+| documentary    | 150ms                     | 600ms       | burn-in (70%) + word-fade-up (30%) |
+| conversational | 80ms                      | 400ms       | word-fade-up                       |
+| energetic      | 50ms                      | 300ms       | word-pop                           |
+| poetic         | 250ms                     | 1200ms      | etch                               |
+| broadcast      | 0 (burn-in)               | BBC timings | burn-in                            |
+| investigative  | 25ms/char                 | 500ms       | typewriter                         |
+| keynote        | 0 per-word (phrase swipe) | 600ms       | swipe-reveal                       |
+
+Agent picks tone → this table → GSAP parameters. Data, not guesswork.
+
+---
+
+## Per-word vs per-phrase animation axis
+
+Orthogonal to the 10 moves above.
+
+- **Per-word animation** (default): each word enters at its `w.start` timestamp. Tight sync with speech.
+- **Per-phrase animation**: whole group enters/exits at `g.in`/`g.out`. Words appear together. Used for:
+  - swipe-reveal moves
+  - burn-in (no animation, but the "reveal" is a group event)
+  - title cards / chapter breaks
+
+Rule: per-word for content that tracks speech; per-phrase for moments that step outside the speech flow.
+
+---
+
+## Stagger breakdown by context
+
+Fine-tune stagger within a tone:
+
+- **Documentary dialog**: 150ms (measured)
+- **Documentary punchline**: 250ms (weighted)
+- **Vlog opener**: 50ms (fast hook)
+- **Vlog narration**: 70ms (conversational but snappy)
+- **Poem / lyric**: 250–400ms per word, with 500–1000ms gaps between phrases
+- **Keynote hero**: per-phrase only (stagger = N/A)
+- **Interview name card**: 0 stagger (static)
+
+---
+
+## Anti-patterns (banned, from anti-patterns.md)
+
+- Animating `letter-spacing` → reflow
+- Animating `filter:blur` → reflow + can wash out text
+- `Math.random()` / `Date.now()` in timeline → non-deterministic render
+- Entries under 100ms total → frantic, unreadable
+- Same motion for every group for 30s+ → eye adapts, stops registering
+
+---
+
+## When to break the vocabulary
+
+The 10 moves are a comfortable coverage, not a ceiling. For Standard mode, invent new moves when the scene demands it:
+
+- Kyle Cooper's scratched typewriter for noir
+- K-pop lyric's directional word-from-side
+- Film-title flash-cut burn-in with chromatic aberration
+
+When inventing: stay deterministic, stay transform+opacity only, state the motion in terms of the 4 axes (entry, hold, exit, stagger).

package/assets/.agent/skills/embedded-captions/references/rail.md

@@ -1,68 +1,68 @@
-# Rail track — standard lower-third subtitle
-
-The **default** caption track and the workhorse: a clean, readable subtitle that sits **in
-front** of everything (never occluded by the matte) in the lower third. It carries **most**
-of the transcript. It is deliberately **plain** — the cinematic craft (planes, occlusion,
-Vogue-masthead, accumulation) lives in the _embed_ track only ([composition-craft.md](composition-craft.md)).
-
-For talking-head / explainer / voiceover, the typical output is **the whole transcript on the rail**
-with only the climax(es) promoted to embed. Rail is not a fallback — it's the baseline.
-
-> **Implementation note.** A dedicated rail renderer is the next build step. The rail is a
-> plain `fg` caption track and maps cleanly onto hyperframes' native caption pipeline
-> (`hyperframes-media` captions) — prefer reusing that over hand-rolling. Until wired, render
-> the rail as a simple `data-caption-layer="fg"` composition (no matte overlay for these caps).
-
-## Position & safe area
-
-- **Lower third, horizontally centered.** Landscape (16:9): baseline ~80–120px above the
-  bottom edge. Portrait (9:16): lower-middle, ~ 600–700px from the bottom (clear of platform UI).
-- **Title-safe margins:** keep text within ~90% width / inside any letterbox-pillarbox bars
-  (see the letterbox probe). Never flush to the frame edge.
-- **One caption group on screen at a time.** No accumulation, no cascade — that's embed-track behaviour.
-- It rides above the subject; the matte does **not** occlude it (rail = in front).
-
-## Lines, length, timing
-
-- **≤ 2 lines.** Broadcast target ~ 32–42 chars/line; break at a clause/phrase boundary, never
-  mid-word, never leave a dangling 1-word line.
-- **Word-synced.** Each group's window envelops its words (`group.in ≤ first word.start`,
-  `group.out ≥ last word.end`); each group ≥ 0.5s on screen; ~1.5s min gap discipline so it
-  doesn't strobe. Word timings within 80ms of transcript (same gate as everywhere).
-- **Grouping** = short readable phrases (see [caption-grouping.md](caption-grouping.md)) — not the
-  embed track's "phrase = composition" rule; here it's just legible subtitle chunking.
-
-## Look (restrained on purpose)
-
-- **Size: ~`calc(0.045 * var(--h))`** (≈48px @1080, ≈58px @1290) — readable, _not_ hero. The rail is a subtitle; it is deliberately much smaller than the embed body/climax. Express as a `var(--h)` fraction (never hardcode px) so it scales across resolutions. The embed climax is sized to the frame independently (see composition-craft § POP) — **never** size the climax as a multiple of this rail.
-- One clean sans (Inter / Helvetica Now / Neue Haas), weight 500–600; white (or near-white).
-- **Legibility without grading the video:** a tight text treatment local to the glyphs only —
-  a soft dark drop-shadow, or a subtle rounded gradient pill / 30–40% scrim **sized to the text
-  box** (not a full-frame bar, never a frame-wide grade). On luminance > 180 backgrounds, keep
-  the scrim; never rely on bare light text.
-- Motion is minimal: 150–250ms fade-up in / fade-down out. No glitch, no scale-pop, no per-word
-  choreography on the rail — that energy is reserved for embed.
-
-## The `emphasis` flag (active-word highlight)
-
-The only intensity the rail carries. When a word is graded `emphasis` (the 1–2 punch words in a
-phrase), give it an **inline** lift on the rail — accent colour and/or +weight, optionally a
-karaoke-style active-word pop (≤1.1× scale) as it's spoken. Keep it inline; it does **not**
-leave the rail. Anything that wants to leave the rail is an `embed`, not an emphasis.
-
-## What the rail never does
-
-- Never goes behind the subject (that's embed).
-- Never accumulates into a multi-line poem (that's embed).
-- Never crosses the face / uses occlusion as an effect.
-- Never grades or textures the underlying video.
-- Doesn't drop content to "fit fewer blocks" — split into more groups instead. The only drops
-  are filler (um/uh, exact stutters, self-corrections); dense conversational `narrator` glue
-  ("you know", "sort of") may be trimmed for readability, content/structure words stay.
-
-## Hand-off to embed
-
-Rail + embed coexist in one render: the rail runs the whole clip; an embedded peak appears over
-it at its moment (the rail can briefly clear or dim under the embed if they'd collide). Decide
-which phrases promote via the role read in SKILL.md § Caption model; author the promoted ones
-with [composition-craft.md](composition-craft.md).
+# Rail track — standard lower-third subtitle
+
+The **default** caption track and the workhorse: a clean, readable subtitle that sits **in
+front** of everything (never occluded by the matte) in the lower third. It carries **most**
+of the transcript. It is deliberately **plain** — the cinematic craft (planes, occlusion,
+Vogue-masthead, accumulation) lives in the _embed_ track only ([composition-craft.md](composition-craft.md)).
+
+For talking-head / explainer / voiceover, the typical output is **the whole transcript on the rail**
+with only the climax(es) promoted to embed. Rail is not a fallback — it's the baseline.
+
+> **Implementation note.** A dedicated rail renderer is the next build step. The rail is a
+> plain `fg` caption track and maps cleanly onto hyperframes' native caption pipeline
+> (`hyperframes-media` captions) — prefer reusing that over hand-rolling. Until wired, render
+> the rail as a simple `data-caption-layer="fg"` composition (no matte overlay for these caps).
+
+## Position & safe area
+
+- **Lower third, horizontally centered.** Landscape (16:9): baseline ~80–120px above the
+  bottom edge. Portrait (9:16): lower-middle, ~ 600–700px from the bottom (clear of platform UI).
+- **Title-safe margins:** keep text within ~90% width / inside any letterbox-pillarbox bars
+  (see the letterbox probe). Never flush to the frame edge.
+- **One caption group on screen at a time.** No accumulation, no cascade — that's embed-track behaviour.
+- It rides above the subject; the matte does **not** occlude it (rail = in front).
+
+## Lines, length, timing
+
+- **≤ 2 lines.** Broadcast target ~ 32–42 chars/line; break at a clause/phrase boundary, never
+  mid-word, never leave a dangling 1-word line.
+- **Word-synced.** Each group's window envelops its words (`group.in ≤ first word.start`,
+  `group.out ≥ last word.end`); each group ≥ 0.5s on screen; ~1.5s min gap discipline so it
+  doesn't strobe. Word timings within 80ms of transcript (same gate as everywhere).
+- **Grouping** = short readable phrases (see [caption-grouping.md](caption-grouping.md)) — not the
+  embed track's "phrase = composition" rule; here it's just legible subtitle chunking.
+
+## Look (restrained on purpose)
+
+- **Size: ~`calc(0.045 * var(--h))`** (≈48px @1080, ≈58px @1290) — readable, _not_ hero. The rail is a subtitle; it is deliberately much smaller than the embed body/climax. Express as a `var(--h)` fraction (never hardcode px) so it scales across resolutions. The embed climax is sized to the frame independently (see composition-craft § POP) — **never** size the climax as a multiple of this rail.
+- One clean sans (Inter / Helvetica Now / Neue Haas), weight 500–600; white (or near-white).
+- **Legibility without grading the video:** a tight text treatment local to the glyphs only —
+  a soft dark drop-shadow, or a subtle rounded gradient pill / 30–40% scrim **sized to the text
+  box** (not a full-frame bar, never a frame-wide grade). On luminance > 180 backgrounds, keep
+  the scrim; never rely on bare light text.
+- Motion is minimal: 150–250ms fade-up in / fade-down out. No glitch, no scale-pop, no per-word
+  choreography on the rail — that energy is reserved for embed.
+
+## The `emphasis` flag (active-word highlight)
+
+The only intensity the rail carries. When a word is graded `emphasis` (the 1–2 punch words in a
+phrase), give it an **inline** lift on the rail — accent colour and/or +weight, optionally a
+karaoke-style active-word pop (≤1.1× scale) as it's spoken. Keep it inline; it does **not**
+leave the rail. Anything that wants to leave the rail is an `embed`, not an emphasis.
+
+## What the rail never does
+
+- Never goes behind the subject (that's embed).
+- Never accumulates into a multi-line poem (that's embed).
+- Never crosses the face / uses occlusion as an effect.
+- Never grades or textures the underlying video.
+- Doesn't drop content to "fit fewer blocks" — split into more groups instead. The only drops
+  are filler (um/uh, exact stutters, self-corrections); dense conversational `narrator` glue
+  ("you know", "sort of") may be trimmed for readability, content/structure words stay.
+
+## Hand-off to embed
+
+Rail + embed coexist in one render: the rail runs the whole clip; an embedded peak appears over
+it at its moment (the rail can briefly clear or dim under the embed if they'd collide). Decide
+which phrases promote via the role read in SKILL.md § Caption model; author the promoted ones
+with [composition-craft.md](composition-craft.md).

package/assets/.agent/skills/embedded-captions/references/reference-bar.md

@@ -1,47 +1,47 @@
-# The reference bar — what world-class looks like
-
-Self-review without an external bar always passes. Before shipping, hold the render
-against these references — not "is anything broken" (the gates did that) but "would a
-designer at these houses sign it".
-
-## Per register
-
-**premium-warm / editorial (cream, editorial)** — the bar is a _Vogue cover_ and the
-A24 title card: type interacts with the subject (masthead behind the head), one or two
-sizes feel chosen not defaulted, the frame would work printed as a poster. Check: does
-the climax frame, screenshotted alone, look like a designed cover — or like a subtitle
-that grew?
-
-**tech-premium (keynote, ink)** — the bar is an _Apple keynote slide_ over footage:
-opaque, weighty, dead-center confidence; negative space is doing the work; nothing
-decorating. Check: would this frame look at home in a WWDC sizzle?
-
-**formal (documentary)** — the bar is _Errol Morris / PBS Frontline_: the type has the
-restraint of a court document; stillness reads as authority. Check: does ANY motion call
-attention to itself? If yes, cut it.
-
-**loud** — the bar is a _k-pop lyric video / Nike spot_: type fights the subject and
-wins on purpose, color is saturated and scene-true, the beat hits WITH the word. Check:
-does the hero frame make you want to replay it?
-
-## The five positive checks (run on the preview sheet, after the failure checks)
-
-1. **Poster test** — screenshot the climax frame alone. Would you post it as a still?
-   If it needs the motion to excuse the composition, the composition isn't done.
-2. **Timid test** — is any body caption apologizing (tiny, corner-parked, far from the
-   silhouette)? Small is a choice; timid is a default. Hug the subject or commit to the
-   margin as a designed column.
-3. **One-glance hierarchy** — at thumbnail size (shrink the sheet), can you still tell
-   opener / body / hero apart? If the tiers blur together, the contrast ratios are off.
-4. **Scene handshake** — name three ways the type acknowledges THIS footage (accent
-   sampled from the scene, occlusion crossing, shadow direction, depth blur, palette
-   temperature). Fewer than two = it's a sticker, not an embed.
-5. **Dead-air audit** — scrub the no-caption stretches. Are they _composed rests_
-   (subject carries the frame) or _gaps_ (the design just stopped)? Rests are earned by
-   rhythm; gaps are bugs in pacing.
-
-## How to use with fresh-eyes review
-
-Give the sub-agent the preview sheet + the 5 failure checks (SKILL.md § Visual QA) +
-these 5 positive checks, and ask for verdicts on both lists. A render ships when it
-passes the failure checks AND at least 4/5 positive checks with specific evidence.
+# The reference bar — what world-class looks like
+
+Self-review without an external bar always passes. Before shipping, hold the render
+against these references — not "is anything broken" (the gates did that) but "would a
+designer at these houses sign it".
+
+## Per register
+
+**premium-warm / editorial (cream, editorial)** — the bar is a _Vogue cover_ and the
+A24 title card: type interacts with the subject (masthead behind the head), one or two
+sizes feel chosen not defaulted, the frame would work printed as a poster. Check: does
+the climax frame, screenshotted alone, look like a designed cover — or like a subtitle
+that grew?
+
+**tech-premium (keynote, ink)** — the bar is an _Apple keynote slide_ over footage:
+opaque, weighty, dead-center confidence; negative space is doing the work; nothing
+decorating. Check: would this frame look at home in a WWDC sizzle?
+
+**formal (documentary)** — the bar is _Errol Morris / PBS Frontline_: the type has the
+restraint of a court document; stillness reads as authority. Check: does ANY motion call
+attention to itself? If yes, cut it.
+
+**loud** — the bar is a _k-pop lyric video / Nike spot_: type fights the subject and
+wins on purpose, color is saturated and scene-true, the beat hits WITH the word. Check:
+does the hero frame make you want to replay it?
+
+## The five positive checks (run on the preview sheet, after the failure checks)
+
+1. **Poster test** — screenshot the climax frame alone. Would you post it as a still?
+   If it needs the motion to excuse the composition, the composition isn't done.
+2. **Timid test** — is any body caption apologizing (tiny, corner-parked, far from the
+   silhouette)? Small is a choice; timid is a default. Hug the subject or commit to the
+   margin as a designed column.
+3. **One-glance hierarchy** — at thumbnail size (shrink the sheet), can you still tell
+   opener / body / hero apart? If the tiers blur together, the contrast ratios are off.
+4. **Scene handshake** — name three ways the type acknowledges THIS footage (accent
+   sampled from the scene, occlusion crossing, shadow direction, depth blur, palette
+   temperature). Fewer than two = it's a sticker, not an embed.
+5. **Dead-air audit** — scrub the no-caption stretches. Are they _composed rests_
+   (subject carries the frame) or _gaps_ (the design just stopped)? Rests are earned by
+   rhythm; gaps are bugs in pacing.
+
+## How to use with fresh-eyes review
+
+Give the sub-agent the preview sheet + the 5 failure checks (SKILL.md § Visual QA) +
+these 5 positive checks, and ask for verdicts on both lists. A render ships when it
+passes the failure checks AND at least 4/5 positive checks with specific evidence.