Skip to content

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.json
index 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.json
similarity index 97%
rename from plugins/scroll-world/.claude-plugin/plugin.json
rename to .claude-plugin/plugin.json
index 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.md
index 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 flies
from *outside* each scene *into* its interior, then flows on to the next scene with **no
cuts**. One continuous connected flight through a little generated world (think the Emons
logistics 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:
```bash
git 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, hand
it 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/LICENSE
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
similarity index 99%
rename from plugins/scroll-world/skills/scroll-world/SKILL.md
rename to skills/scroll-world/SKILL.md
index 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 a
fabricated multiple-choice. A made-up list of industries biases them and reads as you
deciding 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 genuinely
enumerable, lower-stakes choices below — art direction and brand-kit approach — and even
there, signal they can go their own way ("Other"). Ask only what you can't sensibly
default. Cover:
@@ -88,8 +89,9 @@ default. Cover:
the hero product. Each section needs: a short subject description (what's IN the
diorama), an eyebrow, a headline, one line of body, and 0–3 tag pills. The last
section 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 lighter
encodes and engine hardening, but portrait crops the 16:9 frame and low-end devices
may still stutter."* Options: "Desktop only" / "Desktop + mobile (beta)". The beta
diff --git a/plugins/scroll-world/skills/scroll-world/references/index-template.html b/skills/scroll-world/references/index-template.html
similarity index 100%
rename from plugins/scroll-world/skills/scroll-world/references/index-template.html
rename to skills/scroll-world/references/index-template.html
diff --git a/plugins/scroll-world/skills/scroll-world/references/knockout.py b/skills/scroll-world/references/knockout.py
similarity index 100%
rename from plugins/scroll-world/skills/scroll-world/references/knockout.py
rename to skills/scroll-world/references/knockout.py
diff --git a/plugins/scroll-world/skills/scroll-world/references/pipeline.md b/skills/scroll-world/references/pipeline.md
similarity index 100%
rename from plugins/scroll-world/skills/scroll-world/references/pipeline.md
rename to skills/scroll-world/references/pipeline.md
diff --git a/plugins/scroll-world/skills/scroll-world/references/prompts.md b/skills/scroll-world/references/prompts.md
similarity index 100%
rename from plugins/scroll-world/skills/scroll-world/references/prompts.md
rename to skills/scroll-world/references/prompts.md
diff --git a/plugins/scroll-world/skills/scroll-world/references/scrub-engine.js b/skills/scroll-world/references/scrub-engine.js
similarity index 100%
rename from plugins/scroll-world/skills/scroll-world/references/scrub-engine.js
rename to skills/scroll-world/references/scrub-engine.js