diff --git a/docs/video-pipeline.md b/docs/video-pipeline.md
index 6d0a320..99d1f2f 100644
--- a/docs/video-pipeline.md
+++ b/docs/video-pipeline.md
@@ -3,7 +3,7 @@
 This is the production lane for films about the work: showcase previews, the
 LinkedIn and X films, launch reels and GIFs. It is not website motion. The skill
 builds pages; this document records how the repository produces and publishes video
-with free, locally run tools, and what each tool's licence actually says.
+with locally run tools, and where a tool requires a paid licence.
 
 Rules that hold for every stage:
 
@@ -18,10 +18,10 @@ Rules that hold for every stage:
 
 | Stage | Tool | Licence | How this repository uses it |
 |---|---|---|---|
-| Capture a browser run | Playwright recording | Apache-2.0 | `tools/page-proof/record-gallery.mjs` scrolls each example and records it deterministically |
+| Capture a browser run | Playwright recording | Apache-2.0 | `tools/page-proof/record-gallery.mjs` records timed scroll passes; this real-time capture is not frame-deterministic |
 | Capture a screen or camera | OBS Studio | GPL-2.0 | Manual capture for talking-head or live demo footage |
 | Compose titles and cuts | FFmpeg filters | LGPL, GPL with GPL components | `tools/render-linkedin-promo.mjs` composes the LinkedIn film from captures |
-| Compose a video in React | Remotion | Free for individuals, for-profit organisations with up to three employees and non-profits; other companies need a company licence | Optional route for templated films. `compile-choreography.mjs` can emit a paused, fixed-time GSAP timeline that a frame-by-frame renderer such as Remotion or HyperFrames seeks per frame; the repository itself has no Remotion dependency |
+| Compose a video in React | Remotion | [Free for individuals, for-profit organisations with up to three employees and non-profits; other companies need a company licence](https://github.com/remotion-dev/remotion/blob/main/LICENSE.md) | Optional route for templated films. `compile-choreography.mjs` can emit a paused, fixed-time GSAP timeline that a frame-by-frame renderer such as Remotion or HyperFrames seeks per frame; the repository itself has no Remotion dependency |
 | Voiceover | Qwen3-TTS, run locally | Apache-2.0 | Optional; needs a GPU for comfortable speed. Earlier films used the owner's own avatar-service account |
 | Cut silences | Auto-Editor | Unlicense | `auto-editor input.mp4 --margin 0.2sec` before a manual pass |
 | Clean and mix audio | Audacity | GPL | Noise reduction, levels, music ducking |
@@ -31,17 +31,25 @@ Rules that hold for every stage:
 
 ## Delivery presets
 
+These commands need an FFmpeg build with `libx264`; burned-in captions also need
+the `subtitles` filter (`libass`). The landscape preset fits and pads to 1920×1080;
+the square preset deliberately crops. Review that crop before publishing.
+
 ```sh
-# 1080p landscape, platform-safe
-ffmpeg -i edit.mov -c:v libx264 -crf 20 -preset slow -pix_fmt yuv420p \
+# 1080p landscape, preserve the composition with padding
+ffmpeg -i edit.mov \
+  -vf "scale=1920:1080:force_original_aspect_ratio=decrease:force_divisible_by=2,pad=1920:1080:(ow-iw)/2:(oh-ih)/2,setsar=1" \
+  -c:v libx264 -crf 20 -preset slow -pix_fmt yuv420p \
   -movflags +faststart -c:a aac -b:a 160k out-1080.mp4
 
 # square for feeds
 ffmpeg -i edit.mov -vf "scale=1080:1080:force_original_aspect_ratio=increase,crop=1080:1080" \
   -c:v libx264 -crf 20 -pix_fmt yuv420p -movflags +faststart -c:a aac out-square.mp4
 
-# burned-in captions
-ffmpeg -i out-1080.mp4 -vf subtitles=captions.srt -c:a copy out-1080-captions.mp4
+# burned-in captions, retain the delivery encoding and streaming header
+ffmpeg -i out-1080.mp4 -vf subtitles=captions.srt \
+  -c:v libx264 -crf 20 -preset slow -pix_fmt yuv420p -movflags +faststart \
+  -c:a copy out-1080-captions.mp4
 
 # poster
 ffmpeg -i out-1080.mp4 -ss 00:00:03 -frames:v 1 -q:v 2 poster.jpg
diff --git a/skills/cinematic-scroll/references/bake-pipeline.md b/skills/cinematic-scroll/references/bake-pipeline.md
index 003d370..04b2292 100644
--- a/skills/cinematic-scroll/references/bake-pipeline.md
+++ b/skills/cinematic-scroll/references/bake-pipeline.md
@@ -11,7 +11,7 @@ plays them under the same rules as any other media mechanism.
 | Need | Mechanism | Dependency | Static state |
 |---|---|---|---|
 | Scroll drives the sequence on desktop | Scrubbed video, as in [product reveal](product-reveal.md) | None; a `<video>` with a poster | Permanent poster |
-| Frame-exact seeking, or touch devices that block programmatic seeks | Image sequence drawn on a canvas | None; preloaded frames | Permanent poster |
+| Exact frame selection within a measured decode-memory budget | Image sequence drawn on a canvas | None; bounded frame cache | Permanent poster |
 | The sequence is atmosphere, not explanation | A short clip that plays once when visible | None | Poster |
 
 Scrubbing needs a fine pointer and motion allowed. Coarse pointers and reduced
@@ -29,29 +29,34 @@ copy in the document, never inside the frames.
 
 ## Interpolate only when it helps
 
-RIFE (`ECCV2022-RIFE`, MIT, Python) doubles the frame rate of a sparse render with
-`--exp=1`. Check hard edges and thin lines for ghosting before keeping the result,
+RIFE ([ECCV2022-RIFE](https://github.com/hzwer/ECCV2022-RIFE), MIT, Python) doubles
+the frame rate of a sparse video with `--exp=1`. Check hard edges and thin lines for ghosting before keeping the result,
 and keep the original frames. Interpolation cannot repair a camera path that was
 too fast to read; shorten the move instead.
 
 ## Encode with FFmpeg
 
-Scrubbing seeks to arbitrary times, so every frame must be independently
-decodable. The clip grows, which is why the sequence stays short.
+Scrubbing benefits from frequent keyframes; it does not require every frame to be
+a keyframe. Start with a short GOP (15 frames at 30 fps below), then compare seek
+latency and bytes on target devices. Use `-g 1` only when its larger download buys
+a measured improvement. Use the source frame rate in place of 30.
+The commands require `libx264`, plus `libvpx-vp9` and `libwebp` for the optional
+WebM and WebP outputs; check the installed build with `ffmpeg -encoders`.
 
 ```sh
-# scrub clip: every frame is a keyframe, no audio, streaming header first
-ffmpeg -framerate 30 -i frame_%04d.png -c:v libx264 -g 1 -crf 20 \
+# scrub clip: keyframe at most every half-second, no audio, streaming header first
+ffmpeg -framerate 30 -i frame_%04d.png -c:v libx264 -g 15 -crf 20 \
   -pix_fmt yuv420p -movflags +faststart -an scrub.mp4
 
 # alternative codec for browsers that prefer it
-ffmpeg -framerate 30 -i frame_%04d.png -c:v libvpx-vp9 -g 1 -b:v 0 -crf 32 -an scrub.webm
+ffmpeg -framerate 30 -i frame_%04d.png -c:v libvpx-vp9 -g 15 -b:v 0 -crf 32 -an scrub.webm
 
 # poster from a readable frame
 ffmpeg -i scrub.mp4 -ss 00:00:02.000 -frames:v 1 -q:v 2 poster.jpg
 
 # canvas sequence at a bounded width
-ffmpeg -i frame_%04d.png -vf scale=960:-2 -quality 80 seq_%04d.webp
+ffmpeg -framerate 30 -i frame_%04d.png -vf "scale='min(960,iw)':-2" \
+  -c:v libwebp -quality 80 seq_%04d.webp
 ```
 
 FFmpeg is LGPL, or GPL when built with GPL components. Run it as a tool during
@@ -65,18 +70,28 @@ production; do not bundle it into the site.
   states the clip size in the handoff.
 - Decoded memory for canvas sequences: frames multiplied by width, height and four
   bytes. Sixty frames at 960 by 540 decode to about 124 MB, which is already heavy
-  on phones. Fewer frames or a video is usually the right answer.
+  on phones, before decoder and GPU overhead. Decode near the current frame into a
+  bounded cache and release evicted bitmaps. Fewer frames or a video is usually the
+  right answer.
 - Network: load the scrub clip after the poster and copy are visible, and only when
-  the mechanism will actually run.
+  the mechanism will actually run. Verify byte-range responses (`206` with
+  `Content-Range`) and seeking on the deployed URL, not just a local file.
 
 ## Integrate under the recipe rules
 
 - The poster is in the document before any script runs and stays behind the stage.
-- Wait for metadata and one decoded frame before the first seek; seek on
-  `requestVideoFrameCallback` or a frame callback, never inside the scroll handler.
+- Wait for metadata and one decoded frame (`loadeddata`/`canplay`, `readyState >= 2`)
+  before seeking. Coalesce scroll, resize and restored-position updates into one
+  `requestAnimationFrame`; keep only the latest requested time while a seek is in
+  flight and apply it on `seeked`. Clamp to the last frame, below `duration`.
+  [`requestVideoFrameCallback`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement/requestVideoFrameCallback)
+  observes decoded frames; it must not be the only driver of seeks in a paused
+  video, because no new frame arrives until a seek starts.
 - Scroll progress maps to time or frame index with one owner, reversible, and holds
   still while nearby copy must be read.
 - Failure of the clip, the frames or the decoder leaves the poster and all copy.
+- Cancel owned callbacks, remove listeners and release media/cache resources when
+  the mechanism becomes ineligible or unmounts.
 
 ## Proof
 
diff --git a/skills/cinematic-scroll/references/recipe-catalog.md b/skills/cinematic-scroll/references/recipe-catalog.md
index 71382c1..35f8164 100644
--- a/skills/cinematic-scroll/references/recipe-catalog.md
+++ b/skills/cinematic-scroll/references/recipe-catalog.md
@@ -43,7 +43,7 @@ Keep the host brand, native scrolling, and readable static content.
 | Lottie, Rive, animated mascot or icon set inside a story | Editorial story + designer-authored motion in the [stack shelf](stack-shelf.md) | Pause on a readable frame under reduced motion; poster fallback; no decoration-only loops |
 | Smooth scroll, momentum, Lenis | The one smoothing layer allowed by the [stack shelf](stack-shelf.md) | Native scroll on touch and under reduced motion |
 | Physics, gravity, collisions, bouncing objects | Interaction design + the physics rows of the [stack shelf](stack-shelf.md) | Settled composition without JS or motion; pause off screen |
-| Promo film, launch video, voiceover, captions | Not this skill; the repository documents that lane in `docs/video-pipeline.md` | Website motion only here |
+| Promo film, launch video, voiceover, captions | Not this skill; see the repository's [video pipeline](https://github.com/MustBeSimo/web-design-studio/blob/main/docs/video-pipeline.md), which is not installed with the skill | Website motion only here |
 
 When the brief or the host project names a library, engine, editor or production
 tool, read the [stack shelf](stack-shelf.md) for its job, integration rule, licence
diff --git a/skills/cinematic-scroll/references/splat-scene.md b/skills/cinematic-scroll/references/splat-scene.md
index 6ca96c6..34ebf25 100644
--- a/skills/cinematic-scroll/references/splat-scene.md
+++ b/skills/cinematic-scroll/references/splat-scene.md
@@ -1,14 +1,18 @@
 # Splat scene
 
 Use Gaussian splats when the subject is a real, captured place or object and the
-brief supplies a capture or can produce one. A splat scene is photoreal from the
-viewpoints that were captured and falls apart away from them, so the camera path is
-the design. Everything in the [real-time 3D](real-time-3d.md) scene contract applies.
+brief supplies a capture or can produce one. Inspect its attributes first: ordinary
+XYZ/RGB point clouds and mesh PLY files are not Gaussian-splat captures. Keep them
+on a suitable point/mesh renderer unless a conversion is explicitly part of the work.
+A splat scene is photoreal from the viewpoints that were captured and falls apart
+away from them, so the camera path is the design. Everything in the
+[real-time 3D](real-time-3d.md) scene contract applies.
 
 ## Renderer
 
-Spark (`@sparkjsdev/spark`, MIT, maintained by World Labs) renders splats as a
-Three.js object, so the existing renderer, camera and lifecycle stay in charge:
+Spark ([`@sparkjsdev/spark`](https://sparkjs.dev/docs/splat-mesh/), MIT, maintained
+by World Labs) renders splats as a Three.js object, so the existing renderer,
+camera and lifecycle stay in charge:
 
 ```js
 import { SplatMesh } from "@sparkjsdev/spark";
@@ -17,6 +21,10 @@ const room = new SplatMesh({ url: "/captures/room.spz" });
 scene.add(room);
 ```
 
+This is attachment only: await `room.initialized` inside the scene's error-handled
+loader, and enter `ready` only after a rendered frame. Adding the object does not
+prove the capture loaded; retain the poster on rejection or timeout.
+
 Supported inputs include PLY, compressed PLY, SPZ, SPLAT, KSPLAT and SOG. It targets
 WebGL2 and its documentation pairs it with recent Three.js releases; pin Spark and
 Three.js together and preflight the actual capture in a minimal page before building
diff --git a/skills/cinematic-scroll/references/stack-shelf.md b/skills/cinematic-scroll/references/stack-shelf.md
index b74082a..236a938 100644
--- a/skills/cinematic-scroll/references/stack-shelf.md
+++ b/skills/cinematic-scroll/references/stack-shelf.md
@@ -24,11 +24,11 @@ One clock per page. Pick the one the host already has.
 
 | Library | Job in a cinematic page | Integration rule | Licence and status | Static or failure state |
 |---|---|---|---|---|
-| GSAP with ScrollTrigger (`gsap`) | Default timeline and scroll clock in these recipes; `gsap.matchMedia()` carries the reduced-motion and pointer gates; `useGSAP` in React | Register plugins once; `invalidateOnRefresh`; revert the matchMedia context on teardown | Free for all use since 2025 under the GSAP Standard License, which is not an open-source licence; depend on the package, never copy its source | Final composition in normal flow |
+| GSAP with ScrollTrigger (`gsap`) | Timeline and scroll clock when the host uses it; `gsap.matchMedia()` carries the reduced-motion and pointer gates; `useGSAP` in React | Register plugins once; `invalidateOnRefresh`; revert the matchMedia context on teardown | [GSAP Standard License](https://gsap.com/community/standard-license/): no charge for ordinary commercial sites, with restrictions on competing visual animation builders; not open source. Use the dependency, do not vendor its source into this skill | Final composition in normal flow |
 | Motion (`motion`, formerly Framer Motion) | `scroll()` and `useScroll` for progress, springs for micro-interactions | Do not run Motion scroll and ScrollTrigger on the same property; springs stay bounded and respect `useReducedMotion` | MIT, active | Same |
-| Anime.js 4 (`animejs`) | `animate`, `createTimeline` and the `onScroll` observer for hosts without GSAP | Same one-clock rule; `onScroll({ sync: true })` for scrubbing | MIT, active, 4.5 released August 2026 | Same |
-| Lenis (`lenis`) | Smooth scrolling | The only smoothing layer; forward its scroll event to the scroll clock; disable under reduced motion and when it fights native touch scrolling | MIT, active | Native scroll |
-| Theatre.js (`@theatre/core`, `@theatre/studio`) | Visual keyframe editing while authoring a sequence | Authoring aid only: export the keyframes into the page's single clock and keep the studio out of production | Apache-2.0; last release 0.7.2 in May 2024 and the repository has been quiet since August 2024 | Not shipped |
+| Anime.js 4 (`animejs`) | `animate`, `createTimeline` and the `onScroll` observer for hosts using Anime.js | Same one-clock rule; `onScroll({ sync: true })` for scrubbing | MIT; [4.5.0 published June 2026](https://registry.npmjs.org/animejs) | Same |
+| [Lenis](https://github.com/darkroomengineering/lenis) (`lenis`) | Smooth scrolling | Use one RAF driver: `autoRaf` or the host ticker, never both; `lenis.raf()` takes milliseconds (GSAP ticker time is seconds). Forward scroll to the page clock; disable smoothing under reduced motion and on native touch | MIT, active | Native scroll |
+| Theatre.js (`@theatre/core`, `@theatre/studio`) | Visual keyframe authoring and runtime playback | [Load exported state with core](https://www.theatrejs.com/docs/latest/getting-started/with-html-svg); map page progress to `sheet.sequence.position`. Keep studio out of production; no independent playback clock for a scrubbed sequence | [Core: Apache-2.0](https://github.com/theatre-js/theatre/blob/main/packages/core/package.json); [studio: AGPL-3.0-only](https://github.com/theatre-js/theatre/blob/main/packages/studio/package.json). Published 0.7.2 in May 2024; check compatibility before adopting | Static composition; core may ship, studio does not |
 
 ## Vector, 2D and designer-authored motion
 
@@ -51,7 +51,7 @@ The [real-time 3D](real-time-3d.md) scene contract applies to every row.
 | Babylon.js (`@babylonjs/core`) | Alternative engine | Keep it when the host uses it; apply the same scene contract; never two renderers on one page | Apache-2.0, active | Permanent poster |
 | Spark (`@sparkjsdev/spark`) | Gaussian splats as a Three.js object | See [splat scene](splat-scene.md) | MIT, active, by World Labs | Poster from the capture |
 | Custom Shader Material (`three-custom-shader-material`) | Inject GLSL into lit Three materials | One deliberate colour-space and tone-mapping pipeline; bound displacement | MIT; last release October 2025 | Base material without the injection |
-| lygia | Shader snippet library | Flag the licence before use on a commercial site | Prosperity Public License 3.0: free for noncommercial use, a thirty-day commercial trial, then a commercial licence | Not applicable |
+| lygia | Shader snippet library | Flag the licence before use on a commercial site | [Prosperity Public License 3.0](https://github.com/patriciogonzalezvivo/lygia/blob/main/LICENSE.md): free for noncommercial use, a thirty-day commercial trial, then a commercial licence | Not applicable |
 | WebGPU and TSL | Separate experimental implementation | Own materials and an automatic WebGL2 fallback, as in the [motion toolkit](motion-toolkit.md) | Part of Three.js | WebGL2 path, then poster |
 | cables.gl | Node-based visual authoring; exports a JavaScript patch | Treat the export as a renderer: poster, failure state, one owned loop, measured bundle size | Editor repository MIT; small community | Poster |
 
@@ -59,7 +59,7 @@ The [real-time 3D](real-time-3d.md) scene contract applies to every row.
 
 | Library | Job | Integration rule | Licence and status | Static or failure state |
 |---|---|---|---|---|
-| Rapier (`@dimforge/rapier3d-compat`, `@dimforge/rapier2d-compat`) | Real-time 2D and 3D physics in WebAssembly | Step inside the page clock; pause off screen; reduced motion shows the settled state | Apache-2.0, active; the old `rapier.js` repository is archived and the bindings now live in the `dimforge/rapier` repository | Settled composition |
+| Rapier (`@dimforge/rapier3d-compat`, `@dimforge/rapier2d-compat`) | Real-time 2D and 3D physics in WebAssembly | [Fixed simulation steps](https://rapier.rs/docs/user_guides/javascript/integration_parameters/) with bounded catch-up in the owned render loop; pause off screen and reset elapsed time on resume. Bake/cache states for reversible scroll; reverse scrolling cannot undo a live simulation | Apache-2.0, active; the old `rapier.js` repository is archived and the bindings now live in the `dimforge/rapier` repository | Settled composition |
 | Matter.js (`matter-js`) | 2D physics for playful layouts | Same rules | MIT, active | Settled composition |
 | Taichi, SPlisHSPlasH | Offline fluid, foam and particle simulation in Python and C++ | Not browser libraries: bake their output with the [bake pipeline](bake-pipeline.md) | Apache-2.0 and MIT | Poster or scrubbed sequence |
 
@@ -67,20 +67,20 @@ The [real-time 3D](real-time-3d.md) scene contract applies to every row.
 
 | Tool | Job | Where it fits | Licence and status |
 |---|---|---|---|
-| Blender, gltf-transform, Draco, KTX2 | Model preparation and compression | Dependency preflight in [real-time 3D](real-time-3d.md) | GPL tool; MIT libraries |
+| Blender, glTF Transform, Draco, KTX2 | Model preparation and compression | Dependency preflight in [real-time 3D](real-time-3d.md) | Blender: GPL; glTF Transform: MIT; [Draco: Apache-2.0](https://github.com/google/draco/blob/main/LICENSE). KTX2 is a format; [KTX-Software is primarily Apache-2.0 with additional component licences](https://github.com/KhronosGroup/KTX-Software/blob/main/LICENSE.md) |
 | FFmpeg | Encoding frames and clips for scrubbing, posters, previews | [Bake pipeline](bake-pipeline.md) | LGPL, GPL when built with GPL components; run it as a tool, never bundle it |
 | RIFE | Frame interpolation for sparse renders | [Bake pipeline](bake-pipeline.md) | MIT, Python |
 | OpenToonz | Hand-drawn frames | [Bake pipeline](bake-pipeline.md) | BSD-style licence; desktop application |
-| Remotion | Programmatic video from React | The repository's `docs/video-pipeline.md`, outside this skill: it makes films about a site, not the site | Free for individuals, for-profit organisations with up to three employees and non-profits; other companies need a company licence |
+| Remotion | Programmatic video from React | The repository's [video pipeline](https://github.com/MustBeSimo/web-design-studio/blob/main/docs/video-pipeline.md), outside this installed skill | [Free for individuals, for-profit organisations with up to three employees and non-profits; other companies need a company licence](https://github.com/remotion-dev/remotion/blob/main/LICENSE.md) |
 | OBS Studio, Audacity, Auto-Editor, Subtitle Edit, Qwen3-TTS | Capture, audio, silence cuts, captions, voice | Same video pipeline document | GPL, GPL, Unlicense, MIT, Apache-2.0 |
 
 ## Words that point here
 
 | The brief says | Read |
 |---|---|
-| Splat, scan, point cloud, photoreal room, captured object | [Splat scene](splat-scene.md) |
+| Splat, scan, point cloud, photoreal room, captured object | [Splat scene](splat-scene.md) after checking the capture format; a plain point cloud needs a point renderer or conversion |
 | Fluid, smoke, cloth, particles rendered offline, hand-drawn frames, image sequence from a simulation | [Bake pipeline](bake-pipeline.md) |
 | Lottie, Rive, After Effects export, mascot, animated icon set | Vector and designer-authored motion above |
 | Smooth scroll, scroll jacking, momentum | Lenis row, then the one-clock rule |
 | Physics, bouncing, gravity, collisions | Physics above |
-| Promo film, reel, launch video, voiceover, captions | `docs/video-pipeline.md` in the repository |
+| Promo film, reel, launch video, voiceover, captions | [Video pipeline in the full repository](https://github.com/MustBeSimo/web-design-studio/blob/main/docs/video-pipeline.md); not a file shipped with this skill |