scroll-world README

The project's README from github.com/oso95/scroll-world. As one markdown file: README.md.

scroll-world

https://github.com/user-attachments/assets/b08e641e-985b-4bd4-83ff-6750272d0c37

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

/plugin marketplace add oso95/scroll-world
/plugin install scroll-world@scroll-world

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, which installs into Codex, Claude Code, Cursor, and 20+ other agents:

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 agent's skills directory:

git clone https://github.com/oso95/scroll-world
cp -R scroll-world/skills/scroll-world ~/.claude/skills/   # Claude Code
cp -R scroll-world/skills/scroll-world ~/.codex/skills/    # Codex

Requirements

What it does

It generates the art with AI: cohesive isometric diorama scenes (GPT Image 2 — via Higgsfield, or the Codex CLI on a ChatGPT subscription) and the camera flights themselves (Seedance image-to-video via Monid by default, pay-per-clip; Seedance or Kling on Higgsfield credits as fallback — only models that can frame-lock a seam), scrubbed by scroll position — the same technique behind Apple's scroll-through product pages. The camera genuinely moves; scroll only drives time. It's framework-agnostic: you get the Higgsfield pipeline, the prompt templates, and a portable vanilla-JS scrub engine that drops into plain HTML, Next.js, Vue, or a Python-served page — nothing assumes a stack.

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, the ordered scenes the camera visits, whether you want the mobile version (a second chain rendered natively in 9:16 portrait — composed for phones, not a crop of the landscape film), and the budget — render tiers and stills source shown with estimated credit costs, approved before anything generates.
  2. Generates the assets — one still per scene, one "dive-in" camera 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. Mobile opt-in renders a parallel portrait chain the same way, frame-locked against its own 9:16 renders.
  3. Wires it up — a config-driven scroll engine that plays the whole chain as one flight, serving the portrait clips and posters automatically on phones.

What's in the skill

skills/scroll-world/
├── SKILL.md                    the procedure + the seam rule + gotchas
└── references/
    ├── prompts.md              intake checklist + every Higgsfield prompt template
    ├── pipeline.md             copy-paste batch scripts (generate → frames → connectors → encode)
    ├── scrub-engine.js         portable, config-driven scrub engine (blob-seek, lazy load, seam crossfade)
    ├── index-template.html     a minimal standalone page that mounts the engine
    └── knockout.py             background knockout for floating scenes

Notes

Star History

Star History Chart

License

MIT — see LICENSE.

scroll-world (oso95/scroll-world)

Searching Database…

这是什么?scroll-world 是一个智能体技能,可为任何品牌或行业构建沉浸式的滚动驱动“穿越世界”落地页——镜头从每个场景外部飞入其内部,再无缝衔接下一个场景,全程无切换,全部由 AI 生成的美术和视频驱动。
这是一个独立应用,还是我添加给编码智能体的技能?它是一个技能——一个兼容 SKILL.md 的软件包,用于安装到 Claude Code、Codex 或任何其他支持技能的智能体中,而不是能单独运行的东西。
除了编码智能体,真正运行它还需要什么?你需要 Monid CLI(API 密钥和余额,默认按片段付费的视频后端)、已用额度完成认证的 Higgsfield CLI(负责渲染静帧并提供 Kling 回退),再加上用于帧处理的 ffmpeg/ffprobe 和带 Pillow 的 Python 3;Codex CLI 是可选项,可通过 ChatGPT 生成静帧,以代替 Higgsfield 额度。
运行它要花钱吗?要——素材生成按图片和视频片段计费(大致是 Higgsfield 额度上的 N 次图片生成,加上 Monid 上的 2N-1 次视频生成;如果同时渲染移动端链路则费用翻倍),一个 6 场景 1080p 项目估计约 27 美元;该技能在花任何钱之前都会显示预估总额。
实际生成美术和视频的是哪些 AI 模型?场景静帧由 GPT Image 2 生成(通过 Higgsfield,或用 ChatGPT 订阅下的 Codex CLI),镜头飞行片段默认来自通过 Monid 调用的 Seedance 图生视频,回退方案是使用 Higgsfield 额度的 Seedance 或 Kling。
它支持落地页的移动版本吗?支持。选择启用后会原生渲染一条 9:16 竖屏的第二条链路——专为手机构图,而不是从横屏影片裁剪而来——滚动引擎会在移动设备上自动提供该版本。
为什么滚动移动的是镜头,而不只是触发一段动画?它借鉴了 Apple 滚动式产品页背后的技术:镜头真正地飞越预渲染、逐帧对齐的视频接缝,滚动位置只驱动播放时间,而不是运动本身。
这个技能如何决定构建哪些场景?它会依次询问你主题/行业、卖点、品牌素材、美术方向、镜头应依次造访的场景、是否包含移动版本以及你的预算,然后在生成任何内容之前显示预估的额度成本。
Creator
oso95
Size
<0.1 MB
Stars
10.2K
Updated
CommitJul 29
Age
3mo
Commits · 90 Days