What is the scroll-craft skill?
Scroll-craft is an agent skill by nateherkai for building premium scroll-driven websites. It supplies a design workflow, eight page grammars, a typography and spacing floor, a scroll engine and a headless browser check that tests contrast, dead scroll and stuck video. It targets Codex and other coding agents, and also ships as a plugin.
Scroll-craft is an agent skill for building scroll-driven websites with a stated design standard. The README says most AI site output is either well behaved and forgettable or a flashy animation with weak contrast, and the skill treats interaction and craft as one job.
The skill folder holds the procedure in SKILL.md, a set of reference files, a scroll engine, templates and scripts. The README asks you to keep that folder intact, because the references, engine and verification tools work together.
What changes in your agent's output
- Pages are planned as acts with a feeling curve, one line per act, before any section is built.
- One engineered peak gets the asset budget and the most scroll room, instead of several equal highlights.
- Typography follows a floor: two families at most, tighter tracking as size grows, and a 45 to 75 character measure.
- Every build must invent one bespoke signature interaction, and must differ from your earlier pages on at least four of six dimensions.
- The finished page is walked by a headless browser, which reports dead scroll, faded copy and measured contrast.
Who scroll-craft is for
Best for
- Landing pages and portfolios where scroll storytelling is the point and the brief allows a bold look.
- Builders who have their own photos or footage, since the README calls that route first class and free of generation spend.
- Agencies that ship many sites and want a registry that stops them repeating themselves, plus a rule set that pairs with frontend-design.
Not for
- Plain brochure or documentation sites. The README says that if you want a page that looks like everything else, this is the wrong tool.
- Teams that cannot run Node 18, a full ffmpeg build and Chrome for the verification pass.
- Anyone who needs a verified result on macOS or Linux today, because the README says builds have only been run on Windows.
Use it with UiChemy
A scroll-driven build is custom HTML, CSS and JS. UiChemy Composer works with that kind of code inside WordPress, so you can bring a finished page into an editable site. Click Get Started on uichemy.com.
How to install Scroll-Craft Skill: Scroll-Driven Websites for AI Agents
/plugin marketplace add nateherkai/scroll-craftNeeds Node 18 or newer, a full ffmpeg build and playwright-core with Chrome. A generation key is optional.Claude Code plugin
Run the marketplace command above, then
/plugin install nateherk-design. If the install summary says to reload, run/reload-plugins. Invoke it with/nateherk-design:scroll-craftor describe the site you want.Codex
Clone the repository and copy the whole scroll-craft folder from plugins/nateherk-design/skills into your project's .agents/skills directory, then ask Codex to use the Scrollcraft skill.
Other agents
Place the folder in the agent's documented skill directory, or leave the repository in your workspace and ask the agent to read the SKILL.md and follow it.
Run the doctor script
From the repository root run
node plugins/nateherk-design/skills/scroll-craft/scripts/doctor.mjs, then the workspace script with the ensure flag. The README says to do this before anything else.
Check that it loaded
Run the doctor script. It checks your ffmpeg build, playwright-core and Chrome setup, which the README names as the three most common setup faults.
Key features
- Scroll as the timelineVideo scrubs frame by frame under the wheel, sections pin while an argument advances, rails pan sideways and headlines assemble line by line.
- Eight page grammarsFilmic one-shot, chaptered editorial, live surface, continuous world, typographic poster, gallery, split stage and rhythmic cutlist. Each forbids what the others require.
- Required signature moveEvery build invents one bespoke interaction that exists on that site alone. A recoloured spotlight does not count.
- Fingerprint gateA new build has to differ from your existing pages on at least four of six dimensions: grammar, navigation, hero, act shape, close and signature move.
- Feeling curve and one peakEach act gets an emotion and the on-screen cause of it. Two adjacent acts with the same feeling mean one is filler.
- Typography and spacing floorTwo families maximum, a 4px base scale, more space above a heading than below it, and fluid section padding for phones.
- Colour roles and depth toolsSix colour roles with one accent, tinted secondary text, no pure black, and depth from shadows, edge light, scale and blur, overlap and grain.
- Refuse listIdentical feature-card grids, scroll cues, gradient text, invented statistics, fake dashboards and AI-purple gradients are declined by default.
- Headless browser verificationA browser walks every scroll position and reports dead scroll, cues that never reach full opacity, contrast on the composited page and clips stuck on a poster.
- Brand guidelines as inputsPoint it at a brand kit and the hard rules in it win, including rules that forbid things the skill would otherwise reach for.
Frequently asked questions
What is the scroll-craft skill?
Scroll-craft is an agent skill from nateherkai for building scroll-driven websites. It bundles a design procedure, reference files, a scroll engine and a verification script, and asks the agent to plan acts, pick a page grammar and prove the result in a headless browser.
How do I install scroll-craft?
For Claude Code, run the plugin marketplace command and then the plugin install command from the README. For Codex, copy the scroll-craft folder into .agents/skills. For other agents, place the folder in their skill directory and keep the references, scripts and engine inside it.
Does scroll-craft work with Codex and other coding agents?
Yes, the README says to use it with Codex, Claude Code or another agent that can read instructions, edit files, run commands and inspect a browser. It notes that tool names and automatic skill discovery can differ between agents, and the ten-site rebuild was built with Codex.
What do I need installed to run it?
Node 18 or newer, a full ffmpeg build for encoding clips so they scrub, and playwright-core with Chrome for the verification pass. A generation API key is only needed if you want assets generated. Building from your own photos and footage needs no key.
Does it cost money to use?
The skill is MIT licensed. The README says generated video is not free and a ten-leg continuous-world flight is a real spend, while a page built from your own assets costs nothing. Generation is optional.
What does the verification step check?
A headless browser walks the finished page at every scroll position and reports dead scroll, copy that never reaches full opacity, contrast measured on the composited page per line, and clips stuck on a poster. It also writes a contact sheet for a human to judge.
What are the limits of scroll-craft?
The README lists three. It has only been run on Windows, generated video costs real money, and it is opinionated on purpose, so it refuses common layouts and will argue with you about the page's peak. Plan a manual review pass for meaning and taste.
How is it different from other frontend design skills?
It targets one kind of page, immersive scroll-driven sites, and adds an engine and a scroll verification harness. For general UI quality look at design-taste-frontend, and for animation rules see gsap-scrolltrigger.


