A skill that turn any brand into a scrollable 3D world landing page
JavaScript
Engine: optional connectors + @layer theming; NSFW + photoreal guidance
cyw6a6cc89385e4
diff --git a/plugins/scroll-world/.claude-plugin/plugin.json b/plugins/scroll-world/.claude-plugin/plugin.jsonindex f4eb6f0..d96d3da 100644--- a/plugins/scroll-world/.claude-plugin/plugin.json+++ b/plugins/scroll-world/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "scroll-world","description": "Build an immersive scroll-scrubbed 'fly through the world' landing page for any industry or brand using Higgsfield. As the visitor scrolls, a pre-rendered camera flies from outside each scene into its interior, then flows on to the next scene with no cuts — one continuous connected flight. Interviews the user for the topic, story beats, and brand kit, then generates cohesive scenes + seamless camera clips and wires a portable, framework-agnostic scroll-scrub engine. Use for a '3D world' / 'browse-through-the-industry' hero, a scroll cinematic, or a diorama landing.",- "version": "0.1.1",+ "version": "0.1.2","author": {"name": "cyw","email": "[email protected]"diff --git a/plugins/scroll-world/skills/scroll-world/SKILL.md b/plugins/scroll-world/skills/scroll-world/SKILL.mdindex 39509bd..d2932e8 100644--- a/plugins/scroll-world/skills/scroll-world/SKILL.md+++ b/plugins/scroll-world/skills/scroll-world/SKILL.md@@ -285,6 +285,20 @@ is the thing most likely to be wrong:- **Concurrent gens 503 / "not_enough_credits" race** → transient when many launch atonce; re-roll the individual failure, it's not really out of credits (verify with`higgsfield workspace list`).+- **NSFW false-positives (Seedance `status "nsfw"`)** → the video content filter flags+ perfectly innocuous clips, especially **bedroom, pool, spa/wellness** contexts and+ trigger words like "bed", "pool", "waterfall", "wine", "swim". It's partly the prompt+ wording and partly the reference frames. Fixes, in order: (1) re-roll — it's often+ non-deterministic and passes on the 2nd–3rd try; (2) strip trigger words and add+ "empty, unoccupied, no people, no figures, architectural, tasteful"; (3) if a connector+ still won't pass, set that connector slot to `null` — the engine crossfades that seam+ directly (optional connectors), so the page still completes. Budget extra credits/time+ for these re-rolls on interiors/real-estate content.+- **Dark / custom theme** → the engine wraps its default tokens in `@layer sw`, so a+ page-level `:root` / `.sw-root { --sw-bg; --sw-ink; --sw-accent; --sw-font-* }` block+ wins cleanly (no specificity hacks). `--sw-ink` is your primary **text/heading** colour;+ the **accent** fills the primary button and active nav. For a dark theme, set `--sw-bg`+ dark and `--sw-ink` light — the copy scrim and title shadow follow `--sw-bg` automatically.- **`--generate-audio` errors on seedance** → omit it; mute in HTML and `-an` on encode.- **White-box scenes** → `gpt_image_2` returns a solid bg; either match the page bg to itor knock it out (Step 3).diff --git a/plugins/scroll-world/skills/scroll-world/references/prompts.md b/plugins/scroll-world/skills/scroll-world/references/prompts.mdindex 412e34f..2b059bf 100644--- a/plugins/scroll-world/skills/scroll-world/references/prompts.md+++ b/plugins/scroll-world/skills/scroll-world/references/prompts.md@@ -31,6 +31,7 @@ Alternate directions (swap the first two sentences, keep the palette/no-text tai- **Glossy toy:** "Isometric glossy vinyl-toy diorama, smooth plastic shading, soft rim light, collectible figurine look."- **Claymation:** "Isometric stop-motion clay set, visible thumbprints, handmade plasticine texture, soft studio softbox light."- **Neon night:** "Isometric miniature at night, warm interior glow and neon signage, moody rim light, wet reflective ground."+- **Photoreal architectural** (real estate, hospitality, premium/luxury): "Ultra-photorealistic architectural photography of a single cohesive [subject], cinematic wide-angle, warm golden-hour light, natural materials, restrained designer furnishings, a breathtaking view, editorial magazine quality (Architectural Digest), shallow depth of field, no people." For photoreal, drop the floating-island framing and the knockout (Step 3) — the scenes are **full-bleed** (a dark page background reads premium), the "dive" glides *through doorways/glass* rather than opening a roof, and cohesion comes entirely from the identical preamble (do NOT pass an `--image` reference — it clones the same room). Interiors trip Seedance's NSFW filter often; see SKILL Gotchas.## Scene still prompt (Step 2)diff --git a/plugins/scroll-world/skills/scroll-world/references/scrub-engine.js b/plugins/scroll-world/skills/scroll-world/references/scrub-engine.jsindex c558e25..3ed6329 100644--- a/plugins/scroll-world/skills/scroll-world/references/scrub-engine.js+++ b/plugins/scroll-world/skills/scroll-world/references/scrub-engine.js@@ -55,8 +55,11 @@ function mountScrollWorld(container, config) {const dive = { kind: 'dive', si: i, clip: s.clip, still: s.still, accent: s.accent, w: DIVE_W };SEGMENTS.push(dive);s._seg = dive;- if (i < N - 1) {- SEGMENTS.push({ kind: 'conn', si: i, clip: CONNECTORS[i] || null,+ // A connector is optional: if connectors[i] is falsy, the two dives simply+ // crossfade directly (no fly-over). Lets a page complete even when a+ // connector can't be generated (e.g. a content-filter false-positive).+ if (i < N - 1 && CONNECTORS[i]) {+ SEGMENTS.push({ kind: 'conn', si: i, clip: CONNECTORS[i],still: SECTIONS[i + 1].still, accent: SECTIONS[i + 1].accent, w: CONN_W });}});@@ -332,7 +335,11 @@ function injectCSS() {}@media (prefers-reduced-motion:reduce){ .sw-hint i::after{animation:none;} .sw-pt{display:none;} }`;- const style = document.createElement('style'); style.id = 'sw-css'; style.textContent = css;+ // Wrap in a cascade layer so the page's own theme tokens (unlayered+ // :root / .sw-root { --sw-bg / --sw-ink / --sw-accent … }) always win over+ // these defaults, regardless of injection order. Enables clean dark themes.+ const style = document.createElement('style'); style.id = 'sw-css';+ style.textContent = '@layer sw {\n' + css + '\n}';document.head.appendChild(style);}