A skill that turn any brand into a scrollable 3D world landing page
JavaScript
v0.3.1: mobile out of beta
cyw68a150c06474
diff --git a/skills/scroll-world/SKILL.md b/skills/scroll-world/SKILL.mdindex 920ccb8..17e9f7c 100644--- a/skills/scroll-world/SKILL.md+++ b/skills/scroll-world/SKILL.md@@ -89,14 +89,14 @@ default. Cover:the hero product. Each section needs: a short subject description (what's IN thediorama), an eyebrow, a headline, one line of body, and 0–3 tag pills. The lastsection is usually the hero product + the CTA.-5. **Mobile version (beta) — ALWAYS ask this; never silently generate both.** Ask as a+5. **Mobile version — ALWAYS ask this; never silently generate both.** Ask as atwo-option choice (`AskUserQuestion` in Claude Code; a plain question elsewhere):- *"Want a mobile-optimized version too? Mobile support is in **beta** — the scroll-scrub- mechanic is desktop-native. The mobile version is a second camera chain rendered- natively in **9:16 portrait** — composed for phones, not a crop of the landscape film —- which roughly doubles the Higgsfield credit spend (state the estimated number)."*- Options: "Desktop only" / "Desktop + mobile (beta, native 9:16 — ~2× credits)". The- beta disclaimer and the credit cost must be stated to the user, not just implied.+ *"Want a mobile-optimized version too? The mobile version is a second camera chain+ rendered natively in **9:16 portrait** — composed for phones, not a crop of the+ landscape film — which roughly doubles the Higgsfield credit spend (state the+ estimated number)."*+ Options: "Desktop only" / "Desktop + mobile (native 9:16 — ~2× credits)". The+ credit cost must be stated to the user, not just implied.What the answer gates:- **Yes** → render the parallel 9:16 portrait chain and ship it as the mobile variants(Step 6 / pipeline.md §6b): portrait start canvases → 9:16 dives + connectors@@ -370,7 +370,7 @@ ffmpeg -i src.mp4 -an -vf "unsharp=5:5:0.8:5:5:0.0" \Encode all 2N-1 clips (dives + connectors) with the same settings for uniform quality.-**Mobile encodes (beta — only if the user opted in at Step 1.5).** The mobile version is+**Mobile encodes (only if the user opted in at Step 1.5).** The mobile version isthe **native 9:16 portrait chain** (pipeline.md §6b): portrait renders of every dive andconnector, encoded **720 wide (`scale=720:-2`), `-g 4`** (more keyframes = cheaper seeks —phone decoders' seek cost scales with GOP length), crf 23 — wired as `clipMobile` /@@ -397,7 +397,7 @@ mountScrollWorld(document.getElementById('world'), {sections: [{ id:'farm', label:'The Farms', still:'assets/farm.webp',clip:'assets/vid/farm.mp4',- clipMobile:'assets/vid/farm-m.mp4', // mobile beta only: native 9:16 render+ clipMobile:'assets/vid/farm-m.mp4', // mobile opt-in only: native 9:16 renderstillMobile:'assets/farm-m.webp', // its first frame as the portrait posterscroll: 1.6, linger: 0.45, // optional pacing: longer dwell + camera settles mid-sceneaccent:'#8FB98A', eyebrow:'From leaf to last sip', title:'It starts in the hills.',@@ -405,7 +405,7 @@ mountScrollWorld(document.getElementById('world'), {// …one per section; last may carry a `cta`],connectors: ['assets/vid/conn1.mp4','assets/vid/conn2.mp4', /* … length = sections-1 */],- connectorsMobile: ['assets/vid/conn1-m.mp4','assets/vid/conn2-m.mp4' /* … same length; mobile beta only */],+ connectorsMobile: ['assets/vid/conn1-m.mp4','assets/vid/conn2-m.mp4' /* … same length; mobile opt-in only */],});```@@ -427,8 +427,8 @@ freezing the clip), **keeps the still as a poster until the clip paints its firsand **primes each video on first touch** (fixes iOS's blank-until-played video), drops thedrifting particles, ignores URL-bar-only resizes (no scroll jump), and uses safe-areainsets so copy clears the notch/home indicator. All of this hardening is on by default —-no config needed. The `clipMobile`/`connectorsMobile` encodes are the opt-in **mobile-beta** part (Step 1.5): only wire them when the user asked for the mobile version.+no config needed. The `clipMobile`/`connectorsMobile` encodes are the opt-in part+(Step 1.5): only wire them when the user asked for the mobile version.For non-JS backends (Python/Rails/etc.): serve the assets and drop the engine `<script>`into the rendered HTML; nothing about it is framework-specific.@@ -446,10 +446,10 @@ is the thing most likely to be wrong:the crossfade band is too short.- Check the console for errors, confirm `video.seekable.end(0) > 0` (blob working), andthat `currentTime` tracks scroll across each clip's band.-- **Mobile — full checklist only if the user opted into the mobile beta (Step 1.5).**+- **Mobile — full checklist only if the user opted into the mobile version (Step 1.5).**For a desktop-only build, just sanity-check a phone viewport once: page loads, stillposters show, nothing overlaps — the engine's hardening covers graceful degradation.- For the beta (do this on a real phone or an emulated one, portrait + landscape):+ For the mobile build (do this on a real phone or an emulated one, portrait + landscape):- Emulate a phone viewport **with CPU throttled 4–6×** and scroll fast — the clip shouldtrack without freezing (the seek-coalescing + `-m.mp4` encodes are what make this hold).- Confirm the first scene shows immediately (its still is the poster) and the video takesdiff --git a/skills/scroll-world/references/index-template.html b/skills/scroll-world/references/index-template.htmlindex b60300a..96ecc8a 100644--- a/skills/scroll-world/references/index-template.html+++ b/skills/scroll-world/references/index-template.html@@ -34,7 +34,7 @@id: 'sceneA', label: 'Scene A',still: 'assets/sceneA.webp',clip: 'assets/vid/sceneA.mp4',- clipMobile: 'assets/vid/sceneA-m.mp4', // mobile beta only: lighter 720p encode served on phones+ clipMobile: 'assets/vid/sceneA-m.mp4', // mobile opt-in only: lighter 720p encode served on phonesaccent: '#8FB98A',// scroll: 1.6, linger: 0.45, // optional pacing: longer dwell; camera settles mid-sceneeyebrow: 'Value prop label',@@ -62,7 +62,7 @@'assets/vid/conn1.mp4',// 'assets/vid/conn2.mp4', …],- // Mobile beta only: lighter connectors for phones — same length/order as `connectors`.+ // Mobile opt-in only: lighter connectors for phones — same length/order as `connectors`.connectorsMobile: ['assets/vid/conn1-m.mp4',// 'assets/vid/conn2-m.mp4', …diff --git a/skills/scroll-world/references/prompts.md b/skills/scroll-world/references/prompts.mdindex ba62c8e..af8f737 100644--- a/skills/scroll-world/references/prompts.md+++ b/skills/scroll-world/references/prompts.md@@ -13,7 +13,7 @@ Collect and write down:- `TONE` — a word or two (cozy/premium, playful, industrial…).- `STYLE` — the art direction (default below).- `SECTIONS[]` — ordered list; for each: `id`, `label`, `subject` (what's in the diorama), `eyebrow`, `title`, `body` (≤ 1 sentence), `tags[]` (0–3). Last section = hero product + CTA.-- `MOBILE` — yes/no. **Always asked** (SKILL Step 1.5), presented to the user as **beta**+- `MOBILE` — yes/no. **Always asked** (SKILL Step 1.5), presented to the userwith the ~2× credit cost stated. Yes = the **native 9:16 portrait chain** (pipeline §6b):portrait renders of every dive/connector + `clipMobile`/`connectorsMobile`/`stillMobile`wiring + the full mobile QA. The §6 crop encodes are a no-credits stopgap only.diff --git a/skills/scroll-world/references/scrub-engine.js b/skills/scroll-world/references/scrub-engine.jsindex e3aa9bc..d7d4c3b 100644--- a/skills/scroll-world/references/scrub-engine.js+++ b/skills/scroll-world/references/scrub-engine.js@@ -28,7 +28,7 @@connectors: [clipUrl, …], // length = sections.length - 1 (nulls allowed)connectorsMobile: [clipUrl, …], // optional lighter connectors for phones (same length)- MOBILE (the clipMobile/connectorsMobile variants are the opt-in "mobile beta";+ MOBILE (the clipMobile/connectorsMobile variants are the opt-in mobile version;the rest of the phone handling below is always on)The engine is phone-aware out of the box: on a coarse-pointer / ≤860px viewport it- loads `clipMobile` / `connectorsMobile` when provided (encode these smaller +