Skip to content

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.json
index 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.md
index 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 at
once; 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 it
or 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.md
index 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.js
index 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);
}