A skill that turn any brand into a scrollable 3D world landing page
JavaScript
Support Codex and the skills CLI alongside Claude Code
cywf941ef93eec7
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex 9fe701e..1c79612 100644--- a/.claude-plugin/marketplace.json+++ b/.claude-plugin/marketplace.json@@ -9,7 +9,8 @@"plugins": [{"name": "scroll-world",- "source": "./plugins/scroll-world",+ "source": "./",+ "skills": ["./skills/scroll-world"],"description": "Build an immersive scroll-scrubbed landing page where a pre-rendered camera flies from outside each scene into its interior, then flows on to the next with no cuts. Interviews the user for topic, story beats, and brand kit; generates cohesive scenes + seamless camera clips with Higgsfield; wires a portable, framework-agnostic scrub engine.","category": "design"}diff --git a/plugins/scroll-world/.claude-plugin/plugin.json b/.claude-plugin/plugin.jsonsimilarity index 97%rename from plugins/scroll-world/.claude-plugin/plugin.jsonrename to .claude-plugin/plugin.jsonindex 4a7e04b..bc95670 100644--- a/plugins/scroll-world/.claude-plugin/plugin.json+++ b/.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.3",+ "version": "0.2.0","author": {"name": "cyw","email": "[email protected]"diff --git a/README.md b/README.mdindex 5419faa..36e9993 100644--- a/README.md+++ b/README.md@@ -4,15 +4,15 @@https://github.com/user-attachments/assets/b08e641e-985b-4bd4-83ff-6750272d0c37-A Claude Code skill that builds an immersive, **scroll-scrubbed "fly through the world"-landing page** for any industry or brand — the kind where, as you scroll, a camera flies+An agent skill — for Claude Code, Codex, and any `SKILL.md`-compatible agent — that+builds an immersive, **scroll-scrubbed "fly through the world" landing page** for any industry or brand — the kind where, as you scroll, a camera fliesfrom *outside* each scene *into* its interior, then flows on to the next scene with **nocuts**. One continuous connected flight through a little generated world (think the Emonslogistics site, applied to whatever you want).## Install-### As a plugin (recommended)+### Claude Code — as a plugin (recommended)```/plugin marketplace add oso95/scroll-world@@ -21,13 +21,27 @@ logistics site, applied to whatever you want).Then just ask for a scroll-through world landing page, or invoke `/scroll-world`.+### Codex & other agents — via the skills CLI++Using [Vercel's skills CLI](https://github.com/vercel-labs/skills), which installs into+Codex, Claude Code, Cursor, and 20+ other agents:++```bash+npx skills add oso95/scroll-world # pick your agent(s) when prompted+npx skills add oso95/scroll-world -a codex # or target Codex directly+```++In Codex, invoke it with `$scroll-world` (or `/skills` to browse), or just ask for a+scroll-through world landing page.+### Manually (drop-in skill)-Copy the skill folder into your Claude Code skills directory:+Copy the skill folder into your agent's skills directory:```bashgit clone https://github.com/oso95/scroll-world-cp -R scroll-world/plugins/scroll-world/skills/scroll-world ~/.claude/skills/+cp -R scroll-world/skills/scroll-world ~/.claude/skills/ # Claude Code+cp -R scroll-world/skills/scroll-world ~/.codex/skills/ # Codex```## Requirements@@ -51,21 +65,10 @@ When invoked, the skill:1. **Interviews you** — the subject/industry + pitch, a brand kit (import from a URL, handit over, or have it proposed), art direction, and the ordered scenes the camera visits.2. **Generates the assets** with Higgsfield — one still per scene, one "dive-in" camera- clip per scene, and the **connector** clips that join consecutive scenes.+ clip per scene, and the **connector** clips that join consecutive scenes, generated+ from the actual rendered frames of their neighbours so every seam is frame-identical.3. **Wires it up** — a config-driven scroll engine that plays the whole chain as one flight.-### The part that makes it good--The scenes connect **seamlessly** because each connector clip is generated with the-*actual rendered frames* of its neighbours as its start/end images (not the original-stills — those re-render slightly differently and would pop at the seam). Both sides of-every seam end up frame-identical, so the camera never cuts. This is baked into the skill-as the central rule.--It also captures the non-obvious production gotchas: blob-URL loading so scrubbing works on-hosts that don't serve HTTP byte-range requests, GOP/encoding settings that stay sharp-without bloating, and Higgsfield's quirks.-## What's in the skill```diff --git a/plugins/scroll-world/LICENSE b/plugins/scroll-world/LICENSEdeleted file mode 100644index 083f577..0000000--- a/plugins/scroll-world/LICENSE+++ /dev/null@@ -1,21 +0,0 @@-MIT License--Copyright (c) 2026 cyw--Permission is hereby granted, free of charge, to any person obtaining a copy-of this software and associated documentation files (the "Software"), to deal-in the Software without restriction, including without limitation the rights-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell-copies of the Software, and to permit persons to whom the Software is-furnished to do so, subject to the following conditions:--The above copyright notice and this permission notice shall be included in all-copies or substantial portions of the Software.--THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE-SOFTWARE.diff --git a/plugins/scroll-world/README.md b/plugins/scroll-world/README.mddeleted file mode 100644index b3de680..0000000--- a/plugins/scroll-world/README.md+++ /dev/null@@ -1,12 +0,0 @@-# scroll-world (plugin)--Builds an immersive scroll-scrubbed "fly through the world" landing page for any 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.--This directory is the installable plugin. The skill itself lives in-[`skills/scroll-world/`](skills/scroll-world/SKILL.md). See the-[repository README](../../README.md) for what it does, requirements, and install steps.--Invoke by asking Claude Code for a scroll-through world / diorama landing page, or run-`/scroll-world`.diff --git a/plugins/scroll-world/skills/scroll-world/SKILL.md b/skills/scroll-world/SKILL.mdsimilarity index 99%rename from plugins/scroll-world/skills/scroll-world/SKILL.mdrename to skills/scroll-world/SKILL.mdindex 0b41d9c..08f209e 100644--- a/plugins/scroll-world/skills/scroll-world/SKILL.md+++ b/skills/scroll-world/SKILL.md@@ -63,7 +63,8 @@ not the framework.The **subject is the user's to state — ask it as an open question in plain prose**, never afabricated multiple-choice. A made-up list of industries biases them and reads as youdeciding their business for them; let them answer in their own words (their real business,-a client's, or any idea). Reserve `AskUserQuestion` (with options) for the genuinely+a client's, or any idea). Reserve structured multiple-choice (`AskUserQuestion` in Claude+Code; a plain either/or question elsewhere) for the genuinelyenumerable, lower-stakes choices below — art direction and brand-kit approach — and eventhere, signal they can go their own way ("Other"). Ask only what you can't sensiblydefault. Cover:@@ -88,8 +89,9 @@ 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.** Use- `AskUserQuestion`: *"Want a mobile-optimized version too? Mobile support is in+5. **Mobile version (beta) — ALWAYS ask this; never silently generate both.** Ask as a+ two-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; on phones you get lighterencodes and engine hardening, but portrait crops the 16:9 frame and low-end devicesmay still stutter."* Options: "Desktop only" / "Desktop + mobile (beta)". The betadiff --git a/plugins/scroll-world/skills/scroll-world/references/index-template.html b/skills/scroll-world/references/index-template.htmlsimilarity index 100%rename from plugins/scroll-world/skills/scroll-world/references/index-template.htmlrename to skills/scroll-world/references/index-template.htmldiff --git a/plugins/scroll-world/skills/scroll-world/references/knockout.py b/skills/scroll-world/references/knockout.pysimilarity index 100%rename from plugins/scroll-world/skills/scroll-world/references/knockout.pyrename to skills/scroll-world/references/knockout.pydiff --git a/plugins/scroll-world/skills/scroll-world/references/pipeline.md b/skills/scroll-world/references/pipeline.mdsimilarity index 100%rename from plugins/scroll-world/skills/scroll-world/references/pipeline.mdrename to skills/scroll-world/references/pipeline.mddiff --git a/plugins/scroll-world/skills/scroll-world/references/prompts.md b/skills/scroll-world/references/prompts.mdsimilarity index 100%rename from plugins/scroll-world/skills/scroll-world/references/prompts.mdrename to skills/scroll-world/references/prompts.mddiff --git a/plugins/scroll-world/skills/scroll-world/references/scrub-engine.js b/skills/scroll-world/references/scrub-engine.jssimilarity index 100%rename from plugins/scroll-world/skills/scroll-world/references/scrub-engine.jsrename to skills/scroll-world/references/scrub-engine.js