Sandbox
@MustBeSimo/cinematic-scroll-skill

Design skill for cinematic websites in coding agents

Web Design Studio helps an agent turn a subject into a distinctive website with motion, 3D, and clear fallback states. The repo provides a compact agent contract, visual systems, components, references, and checks that verify the result across desktop, mobile, reduced motion, and no-JS views.

34 stars2 forksJavaScriptUpdated 6d ago
Who it's for

Builders who want their agent to create polished websites with reusable motion and 3D patterns.

What it delivers

You can produce a production-ready story page with a consistent visual direction and proof that it works on real devices.

What it does

Agent skill contract

`SKILL.md` routes the agent to the right references and workflow only when needed.

Visual systems and components

`themes/` contains eleven one-file visual systems, and `components/` contains reusable HTML and React patterns.

Live example library

`examples/` includes 28 reference builds, including flagship 3D scenes and simpler editorial studies.

Verification and proof

`tools/cinematic-doctor/`, `tools/page-proof/`, and `tools/verify/` check craft, browser behavior, and fallback states.

Next.js starter

`templates/nextjs/` gives an optional scaffold for full-site builds inside an existing React or Next.js app.

Optional brand matching

`tools/tastehq/` supports brand queries when a target URL or embedded grammar is available.

How to get it

  1. 1Run
    npx skills add MustBeSimo/cinematic-scroll-skill
  2. 2Run
    npx cinematic-scroll-skill
    npx cinematic-scroll-skill --dir .cursor/skills
  3. 3Run
    openclaw skills install cinematic-scroll
  4. 4Run
    /plugin marketplace add MustBeSimo/cinematic-scroll-skill
    /plugin install cinematic-scroll@mustbesimo
  5. 5Run
    git clone https://github.com/MustBeSimo/cinematic-scroll-skill ~/.claude/skills/cinematic-scroll

README

Web Design Studio

Distinctive websites, interactive 3D and motion—built with your coding agent.

Formerly Cinematic Scroll. The product has a broader name; the established cinematic-scroll install commands, GitHub repository and ClawHub listing stay the same.

npm CI license stars

Web Design Studio — the web, with a human touch. Original Renaissance-inspired artwork beside the studio identity.

One sentence in. A distinctive, production-ready website out.
Live site · Real 3D flagships · Install · ClawHub · Star on GitHub

Web Design Studio is a free, MIT-licensed design and build skill for coding agents. It turns a product, portfolio, launch, or story into a distinctive website with deliberate art direction, interactive 3D, scroll choreography, resilient motion, and evidence that the result actually works.

It is not a prompt pack and it is not a runtime dependency. The skill guides the agent; the finished website stays yours.

Choose the install route for your agent:

OpenClaw / ClawHub

npx clawhub install @mustbesimo/cinematic-scroll

Claude Code, Cursor and other agents supported by the skills installer

npx skills add MustBeSimo/cinematic-scroll-skill

Inspect the ClawHub package or check agent-specific setup.

Then ask:

Use cinematic-scroll to turn this product into a one-page story. Match the brand and assets in this project, create one memorable scroll reveal, and prove the mobile and reduced-motion versions.

No account, Pro purchase, TasteHQ key, or image-generation key is required.

Interaction toolkit

Six text treatments, magnetic/depth surfaces, four original shader families and a shared scroll/pointer/proximity runtime—all MIT. React and Three.js adapters add demand rendering, adaptive quality, asset cleanup and context recovery. The WebGPU/TSL study is a separate experimental preview with WebGL2 fallback.

  • FIELD: observe, focus and reframe an optical instrument.
  • Effects lab: isolate and explore the ingredients.
  • Runtime guide: copyable APIs and integration contracts.

Open the standalone HTML files, or serve the repository. For React, run npm ci && npm run dev in templates/nextjs, then visit /v3-flagship, /effects-lab or /webgpu-preview. Generated examples stay synchronized with npm run build:lab and npm run build:flagship. No remote publication is needed.

Three/types are pinned to 0.185.0 because the compatible postprocessing release excludes 0.186. Optional runtime code belongs to your output; there is no hosted service dependency or paid visual-effect tier. Web Design Studio Pro's Motif Engine remains separate.

What you get

  • A content-led story and visual direction before effects are chosen.
  • Standalone HTML for a fast first page, or integration into an existing app.
  • Pinned chapters, parallax, scrubbed video, kinetic type, and real 3D patterns.
  • Eleven swappable visual systems and nine reusable components.
  • Progressive fallbacks for touch, reduced motion, missing JavaScript, and WebGL failure.
  • A deterministic doctor plus browser proof across desktop, mobile, reduced-motion, and no-JS profiles.
  • Optional TasteHQ brand matching when a target URL or embedded grammar is available.

The agent chooses the lightest stack that can carry the story. Most pages do not need WebGL; when real depth matters, the same performance and fallback standards still apply.

See the proof

Seven Real 3D flagships

Seven live websites, seven different reasons to use depth. Every flagship is scrollable, source-visible, bounded by a performance budget, and backed by a designed fallback.

Aureus 01 · Aureus
Liquid chrome · camera descent
Atelier Marne 02 · Atelier Marne
Art halls · architectural flythrough
Verdant 03 · Verdant
Instanced foliage · sunlight
Aether 04 · Aether
Object · world · field · figure
Obsidian 05 · Obsidian
Faceted glass · material response
Weather 06 · Weather
Cloud volume · density control
Nexus 07 · Nexus
Particles · wave displacement
Explore all 28 examples →

Try a live scene, then copy its build prompt and adapt it to your subject.

If an example helps you build something, star the repository to keep it handy.

More than one aesthetic

The motion grammar stays consistent; the art direction does not. Browse the complete visual collection, including every original editorial and all eleven visual systems.

Live exampleDirectionCode
Classic TouchRenaissance editorialSource
Maya TorresBrutalist creative studioSource
VantascopeEditorial sci-fiSource
Maison SolenneQuiet luxurySource
BloomPlayful product storySource
Atelier NocturneKinetic editorialSource
Digital WealthFinancial product storySource
KernMechanical instrument and calibrationSource
Meridiansymmetric monumentSource
Vanta Labsclinical noirSource
Polly & Plotstorybook geometrySource
Obsidiantemporal monumentSource
Farsightatmospheric sublimeSource
Keepsakewarm scrapbookSource
Driftnaturalistic driftSource
Concrete / Orangebrutalist kineticSource
Chromaliquid chromeSource
Verdant Pressbotanical editorialSource
Signaldata cinematicSource
Naturally RootedA slower editorial studySource
NovadeckA playful digital throwbackSource

The visual systems live in themes/. The components live in components/. They are starting points, not a fixed house style.

Web Design Studio and Pro

The normal edition is the complete, useful product—not a trial.

Web Design Studio · free foreverWeb Design Studio Pro · for repeat practice
Build complete cinematic websitesBuild on accumulated project knowledge
Story and motion planningIntent-based pattern retrieval
28 references + 11 visual systemsReuse tracking across builds
Components and Real 3D patternsLearned variants from your own language
Doctor + five-profile browser proofDeeper iteration without starting cold
Optional TasteHQ matchingProprietary Motif Engine

Use Web Design Studio for as many personal or commercial projects as you like. Use Pro when repeated work should compound into a visual memory.

Explore Web Design Studio Pro → · Compare editions · See how the stack fits

Install

All paths install the same normal edition.

Skills registry

npx skills add MustBeSimo/cinematic-scroll-skill

npm installer

npx cinematic-scroll-skill
npx cinematic-scroll-skill --dir .cursor/skills

OpenClaw / ClawHub

openclaw skills install cinematic-scroll

The ClawHub edition is a lean, text-only normal edition with the complete story, implementation, interaction, 3D, accessibility, and verification workflow. Its source lives in skills/cinematic-scroll/ and is gated by NVIDIA SkillSpector in CI without a suppression baseline.

Claude Code marketplace

/plugin marketplace add MustBeSimo/cinematic-scroll-skill
/plugin install cinematic-scroll@mustbesimo

Git clone

git clone https://github.com/MustBeSimo/cinematic-scroll-skill ~/.claude/skills/cinematic-scroll

For Claude Desktop, Cursor, Hermes, and alternative OpenClaw paths, see COMPATIBILITY.md.

Two build modes

Mode A — a section or standalone page

Use this for a hero, a campaign page, or a fast concept. The output can be one runnable HTML file with no build step.

Build a self-contained pinned hero for this brand. Keep the page readable without JavaScript and give touch devices a natural-flow version.

Mode B — a full release site

Use this for multi-chapter stories and existing React/Next.js products. The skill preserves the installed framework and scroll provider, then integrates the sequence at a real route.

Build a complete release story for this product inside the existing app. Reuse its design system, create one signature moment, and verify the built route.

The included templates/nextjs/ project is available when a new Next.js scaffold is actually needed. Generated media through fal.ai is optional; demo mode and local assets work without a key.

Quality is a gate

cinematic-doctor scores static craft and exits non-zero below the chosen threshold:

npm run doctor -- examples/flagship/index.html

The end-to-end verifier combines contract checks with browser evidence:

node tools/verify/verify-build.mjs ./index.html --phase polish

For a full interaction matrix:

node tools/page-proof/matrix.mjs ./index.html --out .verify/page-proof

That matrix covers desktop, mobile/touch, reduced motion on both layouts, and JavaScript disabled. A requested check that cannot run reports INCOMPLETE; a failed check reports FAIL. Neither is dressed up as success.

Install browser-tool dependencies once with npm install in the skill directory. Chrome or Chromium is needed only for screenshot proof, not to generate a standalone page.

Design system and architecture

SKILL.md                    compact agent contract and workflow router
design.md + tokens/        DTCG color, type, spacing, and motion contract
themes/                    eleven one-file visual systems
components/                nine named patterns in HTML and React
references/                story, build, motion, performance, 3D, and XR guidance
examples/                  live references, prompts, and Real 3D flagships
templates/nextjs/          optional full-site starter
tools/cinematic-doctor/    deterministic static quality gate
tools/page-proof/          browser screenshots and interaction matrix
tools/verify/              one-command verification orchestration
tools/tastehq/             optional brand query and score adapter
evals/                     triggering and workflow behavior checks

The main contract is SKILL.md. It routes to detailed references only when the build needs them, keeping agent context smaller and decisions clearer.

One choreography, two media

scroll-choreography.json is a declarative timing source that can compile to a webpage timeline and launch-film markers. See compile-choreography.mjs and the compilation contract.

Real 3D assets

The flagship can run procedurally before any model arrives. When assets are available, ASSETS-3D.md defines GLB/USDZ formats, scale, pivots, triangle caps, materials, camera nodes, and manifest paths so the upgrade is data—not a rewrite.

Develop and verify this repo

npm install
npm test

The test suite checks tokens, themes, links, skill mirrors, components, the doctor, evals, benchmark behavior, verification semantics, browser-matrix orchestration, package contents, and the TasteHQ adapter.

Useful commands:

npm run tokens:check
npm run themes:check
npm run components:doctor
npm run proof -- examples/noir/index.html
npm run bench -- https://example.com

CinematicBench is the companion passive benchmark for pacing, performance, accessibility, and motion craft.

Principles

  • Content and brand lead; effects follow.
  • Use real 3D only when spatial depth carries meaning.
  • One scroll clock, reversible setup, and no global teardown.
  • Mobile is a composition, not a shrunken desktop.
  • Reduced motion restores readable flow; it does not merely set duration to zero.
  • A static poster or readable page is a designed state, not an apology.
  • References inform direction without copying assets, logos, text, or exact compositions.

License

MIT © 2026 Simone Leonelli. See LICENSE.

Built something with it? Submit it to the showcase or email simone@w230.net.

Files in the repo

Repository payload51 top-level entries
  • .claude
  • .claude-plugin
  • .codex
  • .cursor
  • .github
  • assets
  • bench
  • bin
  • components
  • evals
  • examples
  • references
  • runtime
  • skills
  • stack
  • templates
  • themes
  • tokens
  • tools
  • .gitignore
  • .nojekyll
  • .npmignore
  • AGENTS.md
  • ASSETS-3D.md
  • audit-mode.md
  • bench-mode.md
  • COMPATIBILITY.md
  • compile-choreography.mjs
  • decision-log.md
  • design.md
  • IMAGE-SPEC.md
  • index.html
  • index.legacy.html
  • index.v2.html
  • learn-mode.md
  • LICENSE
  • manifest.json
  • manifest.md
  • MODELS.md
  • package-lock.json
  • package.json
  • README.md
  • REVIEW.md
  • scroll-choreography-compilation.md
  • scroll-choreography.json
  • SECURITY.md
  • sitemap.xml
  • SKILL.md
  • taste-guardrails.md
  • troubleshooting.md
  • V3-IMPLEMENTATION.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

obra/
superpowers

An agentic skills framework & software development methodology that works.

285k
1 add

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k