--- name: scroll-craft description: > Build a premium, scroll-driven interactive landing page for any business: a service company, a physical product, a food brand, a drink brand. Scroll becomes the timeline. Video scrubs frame by frame under the wheel, sections pin and advance, rails pan sideways, headlines assemble line by line, the page ground shifts colour as you travel, and the pointer moves things that are not scrolling. Interviews the human first (their vibe, their journey, one unbroken world or distinct scenes, and what assets they already own), then picks a page grammar and a signature move so no two builds share a skeleton, generates photoreal assets through kie.ai or builds from the user's own footage and photos, writes real semantic HTML on a design-system floor, and verifies the result by screenshotting its own scroll. Use for "scrollytelling", "scroll animation site", "a site where scrolling plays a video", "Apple-style landing page", "3D scroll world", "interactive landing page", "make my brand a scroll experience", "make it feel different", "this looks like a template", "a unique scroll site", or any request for a site that should feel like an experience rather than a document. allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion ---

# scroll-craft

Scroll is the only input every visitor already knows how to use. This skill treats it as a timeline: the wheel is a scrubber, the page is a film with real text on top, and each section behaves differently enough that the visitor keeps going to find out what the next one does.

**What you produce:** an interview brief, a page grammar, a customer-journey map, a feeling curve with one engineered peak, a scroll score, one signature move, generated assets, one real HTML page on a token-driven design floor, and a strip of screenshots proving it holds up at every scroll position.

## What this is not

It is not "generate a flythrough and drop text on it." That approach produces one device applied to a whole page, and every site built that way is recognisable at a glance: same claymation diorama, same centred copy, same `01 / 06` counter, same "scroll to explore" nudge. Five sections that behave identically are one section shown five times.

Four rules follow from that, and they are the spine of this skill:

1. **Variety is the product.** A page uses at least four device families and never the same device twice in a row. Read [references/devices.md](references/devices.md). 2. **The world is photographic unless the brand is genuinely illustrated.** Soft matte low-poly clay diorama is banned as a default. Read [references/worlds.md](references/worlds.md). 3. **No continuous chain.** A single unbroken camera flight is the most expensive and most fragile thing you can build, and it exists only to hide cuts between scenes. Vary the device instead and the cut disappears for free, because the visitor is not watching one film. Chain only when the brief is literally "one continuous journey." 4. **A different world is not a different page.** The device kit varies how a page looks. Structure is a separate axis, and it has to be decided deliberately or every build inherits the same skeleton. The first four builds did exactly that. Read [references/uniqueness.md](references/uniqueness.md).

## Step 0: The interview

**Always interview the human before generating anything.** Not a brief you inferred from the brand name, not a plan you present for approval. Actual questions, asked, answered, written down. A page built from assumptions comes back looking like the last page built from assumptions.

The skill is a range instrument, not a house style. The human brings intent and whatever assets they own; the interview is where that turns into the right kind of page: one unbroken world, distinct scenes, printed chapters, a live surface. The skill can do any of them. The interview decides which.

Keep it short. Eight questions, asked in one pass:

1. **Vibe in three to five words**, plus up to three references from any medium. A film, an album cover, a shop, a magazine, a game. Not "sites you like": naming sites is how a page ends up looking like an existing site. 2. **The scroll journey, section by section, in their words.** What the visitor should hit first, what comes next, what the last thing is. Their sequence, not a menu you offered. 3. **The energy curve.** Where it should feel calm, where it should feel intense. A page that is loud the whole way is as flat as one that is quiet the whole way. 4. **How should someone feel while scrolling, stage by stage, and what is the ONE moment they should remember?** Energy is loudness. This is emotion, and the two do not line up: on a loud page the quiet act can be the most intense. The stage-by-stage answer becomes the feeling curve, the one moment becomes the peak. Both are required in BRIEF.md. See [references/feel.md](references/feel.md). 5. **One thing this site should do that no site they have seen does.** This is the seed of the signature move. Push for a real answer; "be memorable" is not one. 6. **How far from premium-minimal they want to go.** Offer the range in [uniqueness.md §5](references/uniqueness.md): brutalist, maximalist, playful, retro, dense, editorial, premium-minimal. Their answer governs the aesthetic family, not your taste. 7. **One unbroken world, or distinct scenes?** Should the whole page feel like one continuous place the scroll flies through (worldflight, see [references/worldflight.md](references/worldflight.md)), or like separate scenes, chapters, or cuts? This is the single biggest structural fork, and it is their call, not a device you pick later. Offer both plainly; neither is the default. 8. **What assets do they already have?** Footage, photos, product shots, a brand kit, clips of themselves. Real assets anchor the world and cut generation cost; the answer decides what gets graded and encoded versus generated. "Nothing" is a fine answer and means a fully generated world.

Write the answers into `<workspace>/builds/<name>/BRIEF.md` before any act planning, in their words, not paraphrased into marketing prose. Everything downstream reads from that file.

BRIEF.md must contain, at minimum:

- The eight interview answers, verbatim. - **The feeling curve.** One line per act: the emotion, then what on screen causes it. Written before the acts exist, added to as the score fills in. - **The peak.** The one moment, written as the sentence a visitor would say to a friend, plus which act it lives in. - **The completed tell-someone sentence.** "It's the site where ___", filled with an experience, not a device name. - Any authored silence, so the verification pass can tell it from dead scroll.

[references/feel.md](references/feel.md) is the spec for all four.

**If the human is genuinely unreachable** and the run is fully autonomous, write BRIEF.md yourself: answer all eight questions in the brand's voice, mark the file `Self-authored, not interviewed` at the top, and say so in the final report. A self-authored brief is a fallback, never the plan.

## Bootstrap

Environment, not a stage of the work. Do it once the interview is answered and before Step 1.

**Run the preflight rather than checking by hand.** It knows the failure modes that otherwise surface later as misleading errors, chiefly a stripped ffmpeg that reports a missing filter as a syntax error in your command:

```bash node <skill>/scripts/doctor.mjs ```

It reports node, a full ffmpeg build, playwright and Chrome, the API key, and the resolved workspace. Required failures exit non-zero. Say plainly which items are missing rather than working around them silently.

### The workspace

Builds and the fingerprint registry live in one directory, and **it is resolved, never assumed**:

```bash node <skill>/scripts/workspace.mjs --ensure # prints it, creates it, seeds the registry ```

Resolution order, first hit wins:

1. `SCROLLCRAFT_HOME` 2. the nearest `.scrollcraft.json` walking up from the cwd, `{ "workspace": "..." }` 3. `<project root>/scrollcraft`, where the project root is the nearest ancestor holding a `.git`

So a build folder is `<workspace>/builds/<name>/` and the registry is `<workspace>/FINGERPRINTS.md`. The registry starts **empty**: the gate exists to stop you repeating yourself, so your first build has nothing to clear.

If you already keep builds somewhere else, drop a `.scrollcraft.json` at your project root pointing at it and nothing moves.

### The rest

1. `KIE_AI_API_KEY`, **only if you are generating assets.** A build from the user's own photos and footage needs no key and no spend, and that is a first-class route, not a fallback. Confirm balance with `node <skill>/scripts/kie.mjs probe`. A still costs cents and a 5s clip costs more; a six-act page with two clips is a small spend, not a large one. 2. A brand kit if one exists (colours, logo, type, existing product shots). If the brand has a folder in this repo, read it before generating anything, and obey its hard rules. A brand that forbids invented numbers means no stat counters, however good they look.

Copy `engine/scrollcraft.js` and `engine/scrollcraft.css` into the build folder. Never edit the engine per-project; it is the mechanism. Theme it with tokens and write your own markup.

## Step 1: The brief, journey first

The subject is the user's to state. Ask it open, in plain prose, never as a fabricated multiple-choice list of industries: a made-up menu biases them and reads as you deciding their business for them.

Step 0 already covered vibe, sequence, energy and range. Do not ask any of it again. Ask only what you cannot sensibly default:

1. **What is this, and who is it for?** One or two sentences in their words. 2. **What must the visitor believe by the end?** The single sentence the page exists to install. Not a feature list. If they give three, make them pick. 3. **What does the visitor do next?** One action. One label for it, used everywhere on the page. 4. **What do you already have?** Logo, palette, photography, product shots, footage, a brand doc. Real assets beat generated ones every time. 5. **Art direction**: offer the worlds in [references/worlds.md](references/worlds.md) as a real choice, and say they can go their own way.

Then write the **journey** before anything else: four to seven beats, each one a shift in what the visitor knows or feels.

``` 1 Recognition they see their own morning 2 Tension the cost of it, named plainly 3 Turn the thing that changes 4 Substance why it holds up 5 Range what they can choose 6 Commitment the one action ```

Beats are the spine. Sections serve beats; a section that serves no beat is cut, however nice the shot is. Show the journey to the user and get it right before generating a single asset, because assets are the expensive part and the journey determines every one of them.

## Step 2: Grammar, gate, then score

Three things in order, and the first two come before any act planning. Full detail in [references/uniqueness.md](references/uniqueness.md).

**Pick a grammar.** Eight of them, and they are mutually exclusive because each one forbids things the others require. Filmic one-shot is the one the first four builds all used, so choosing it again means saying in the report why the other seven did not fit the interview. Nav, hero and close all follow from the grammar; they are not decided separately.

**Invent the signature move.** One bespoke interaction that lives on this site alone, coded in the page, not a parameter change to a kit device. Question 5 of the interview is the seed. The engine stays untouched.

**Run the fingerprint gate.** Read your registry at `<workspace>/FINGERPRINTS.md` (see **The workspace** in Bootstrap; run `node <skill>/scrip

--- name: scroll-craft description: > Build a premium, scroll-driven interactive landing page for any business: a service company, a physical product, a food brand, a drink brand. Scroll becomes the timeline. Video scrubs frame by frame under the wheel, sections pin and advance, rails pan sideways, headlines assemble line by line, the page ground shifts colour as you travel, and the pointer moves things that are not scrolling. Interviews the human first (their vibe, their journey, one unbroken world or distinct scenes, and what assets they already own), then picks a page grammar and a signature move so no two builds share a skeleton, generates photoreal assets through kie.ai or builds from the user's own footage and photos, writes real semantic HTML on a design-system floor, and verifies the result by screenshotting its own scroll. Use for "scrollytelling", "scroll animation site", "a site where scrolling plays a video", "Apple-style landing page", "3D scroll world", "interactive landing page", "make my brand a scroll experience", "make it feel different", "this looks like a template", "a unique scroll site", or any request for a site that should feel like an experience rather than a document. allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion ---

# scroll-craft

Scroll is the only input every visitor already knows how to use. This skill treats it as a timeline: the wheel is a scrubber, the page is a film with real text on top, and each section behaves differently enough that the visitor keeps going to find out what the next one does.

**What you produce:** an interview brief, a page grammar, a customer-journey map, a feeling curve with one engineered peak, a scroll score, one signature move, generated assets, one real HTML page on a token-driven design floor, and a strip of screenshots proving it holds up at every scroll position.

## What this is not

It is not "generate a flythrough and drop text on it." That approach produces one device applied to a whole page, and every site built that way is recognisable at a glance: same claymation diorama, same centred copy, same `01 / 06` counter, same "scroll to explore" nudge. Five sections that behave identically are one section shown five times.

Four rules follow from that, and they are the spine of this skill:

1. **Variety is the product.** A page uses at least four device families and never the same device twice in a row. Read [references/devices.md](references/devices.md). 2. **The world is photographic unless the brand is genuinely illustrated.** Soft matte low-poly clay diorama is banned as a default. Read [references/worlds.md](references/worlds.md). 3. **No continuous chain.** A single unbroken camera flight is the most expensive and most fragile thing you can build, and it exists only to hide cuts between scenes. Vary the device instead and the cut disappears for free, because the visitor is not watching one film. Chain only when the brief is literally "one continuous journey." 4. **A different world is not a different page.** The device kit varies how a page looks. Structure is a separate axis, and it has to be decided deliberately or every build inherits the same skeleton. The first four builds did exactly that. Read [references/uniqueness.md](references/uniqueness.md).

## Step 0: The interview

**Always interview the human before generating anything.** Not a brief you inferred from the brand name, not a plan you present for approval. Actual questions, asked, answered, written down. A page built from assumptions comes back looking like the last page built from assumptions.

The skill is a range instrument, not a house style. The human brings intent and whatever assets they own; the interview is where that turns into the right kind of page: one unbroken world, distinct scenes, printed chapters, a live surface. The skill can do any of them. The interview decides which.

Keep it short. Eight questions, asked in one pass:

1. **Vibe in three to five words**, plus up to three references from any medium. A film, an album cover, a shop, a magazine, a game. Not "sites you like": naming sites is how a page ends up looking like an existing site. 2. **The scroll journey, section by section, in their words.** What the visitor should hit first, what comes next, what the last thing is. Their sequence, not a menu you offered. 3. **The energy curve.** Where it should feel calm, where it should feel intense. A page that is loud the whole way is as flat as one that is quiet the whole way. 4. **How should someone feel while scrolling, stage by stage, and what is the ONE moment they should remember?** Energy is loudness. This is emotion, and the two do not line up: on a loud page the quiet act can be the most intense. The stage-by-stage answer becomes the feeling curve, the one moment becomes the peak. Both are required in BRIEF.md. See [references/feel.md](references/feel.md). 5. **One thing this site should do that no site they have seen does.** This is the seed of the signature move. Push for a real answer; "be memorable" is not one. 6. **How far from premium-minimal they want to go.** Offer the range in [uniqueness.md §5](references/uniqueness.md): brutalist, maximalist, playful, retro, dense, editorial, premium-minimal. Their answer governs the aesthetic family, not your taste. 7. **One unbroken world, or distinct scenes?** Should the whole page feel like one continuous place the scroll flies through (worldflight, see [references/worldflight.md](references/worldflight.md)), or like separate scenes, chapters, or cuts? This is the single biggest structural fork, and it is their call, not a device you pick later. Offer both plainly; neither is the default. 8. **What assets do they already have?** Footage, photos, product shots, a brand kit, clips of themselves. Real assets anchor the world and cut generation cost; the answer decides what gets graded and encoded versus generated. "Nothing" is a fine answer and means a fully generated world.

Write the answers into `<workspace>/builds/<name>/BRIEF.md` before any act planning, in their words, not paraphrased into marketing prose. Everything downstream reads from that file.

BRIEF.md must contain, at minimum:

- The eight interview answers, verbatim. - **The feeling curve.** One line per act: the emotion, then what on screen causes it. Written before the acts exist, added to as the score fills in. - **The peak.** The one moment, written as the sentence a visitor would say to a friend, plus which act it lives in. - **The completed tell-someone sentence.** "It's the site where ___", filled with an experience, not a device name. - Any authored silence, so the verification pass can tell it from dead scroll.

[references/feel.md](references/feel.md) is the spec for all four.

**If the human is genuinely unreachable** and the run is fully autonomous, write BRIEF.md yourself: answer all eight questions in the brand's voice, mark the file `Self-authored, not interviewed` at the top, and say so in the final report. A self-authored brief is a fallback, never the plan.

## Bootstrap

Environment, not a stage of the work. Do it once the interview is answered and before Step 1.

**Run the preflight rather than checking by hand.** It knows the failure modes that otherwise surface later as misleading errors, chiefly a stripped ffmpeg that reports a missing filter as a syntax error in your command:

```bash node <skill>/scripts/doctor.mjs ```

It reports node, a full ffmpeg build, playwright and Chrome, the API key, and the resolved workspace. Required failures exit non-zero. Say plainly which items are missing rather than working around them silently.

### The workspace

Builds and the fingerprint registry live in one directory, and **it is resolved, never assumed**:

```bash node <skill>/scripts/workspace.mjs --ensure # prints it, creates it, seeds the registry ```

Resolution order, first hit wins:

1. `SCROLLCRAFT_HOME` 2. the nearest `.scrollcraft.json` walking up from the cwd, `{ "workspace": "..." }` 3. `<project root>/scrollcraft`, where the project root is the nearest ancestor holding a `.git`

So a build folder is `<workspace>/builds/<name>/` and the registry is `<workspace>/FINGERPRINTS.md`. The registry starts **empty**: the gate exists to stop you repeating yourself, so your first build has nothing to clear.

If you already keep builds somewhere else, drop a `.scrollcraft.json` at your project root pointing at it and nothing moves.

### The rest

1. `KIE_AI_API_KEY`, **only if you are generating assets.** A build from the user's own photos and footage needs no key and no spend, and that is a first-class route, not a fallback. Confirm balance with `node <skill>/scripts/kie.mjs probe`. A still costs cents and a 5s clip costs more; a six-act page with two clips is a small spend, not a large one. 2. A brand kit if one exists (colours, logo, type, existing product shots). If the brand has a folder in this repo, read it before generating anything, and obey its hard rules. A brand that forbids invented numbers means no stat counters, however good they look.

Copy `engine/scrollcraft.js` and `engine/scrollcraft.css` into the build folder. Never edit the engine per-project; it is the mechanism. Theme it with tokens and write your own markup.

## Step 1: The brief, journey first

The subject is the user's to state. Ask it open, in plain prose, never as a fabricated multiple-choice list of industries: a made-up menu biases them and reads as you deciding their business for them.

Step 0 already covered vibe, sequence, energy and range. Do not ask any of it again. Ask only what you cannot sensibly default:

1. **What is this, and who is it for?** One or two sentences in their words. 2. **What must the visitor believe by the end?** The single sentence the page exists to install. Not a feature list. If they give three, make them pick. 3. **What does the visitor do next?** One action. One label for it, used everywhere on the page. 4. **What do you already have?** Logo, palette, photography, product shots, footage, a brand doc. Real assets beat generated ones every time. 5. **Art direction**: offer the worlds in [references/worlds.md](references/worlds.md) as a real choice, and say they can go their own way.

Then write the **journey** before anything else: four to seven beats, each one a shift in what the visitor knows or feels.

``` 1 Recognition they see their own morning 2 Tension the cost of it, named plainly 3 Turn the thing that changes 4 Substance why it holds up 5 Range what they can choose 6 Commitment the one action ```

Beats are the spine. Sections serve beats; a section that serves no beat is cut, however nice the shot is. Show the journey to the user and get it right before generating a single asset, because assets are the expensive part and the journey determines every one of them.

## Step 2: Grammar, gate, then score

Three things in order, and the first two come before any act planning. Full detail in [references/uniqueness.md](references/uniqueness.md).

**Pick a grammar.** Eight of them, and they are mutually exclusive because each one forbids things the others require. Filmic one-shot is the one the first four builds all used, so choosing it again means saying in the report why the other seven did not fit the interview. Nav, hero and close all follow from the grammar; they are not decided separately.

**Invent the signature move.** One bespoke interaction that lives on this site alone, coded in the page, not a parameter change to a kit device. Question 5 of the interview is the seed. The engine stays untouched.

**Run the fingerprint gate.** Read your registry at `<workspace>/FINGERPRINTS.md` (see **The workspace** in Bootstrap; run `node <skill>/scrip

--- name: scroll-craft description: > Build a premium, scroll-driven interactive landing page for any business: a service company, a physical product, a food brand, a drink brand. Scroll becomes the timeline. Video scrubs frame by frame under the wheel, sections pin and advance, rails pan sideways, headlines assemble line by line, the page ground shifts colour as you travel, and the pointer moves things that are not scrolling. Interviews the human first (their vibe, their journey, one unbroken world or distinct scenes, and what assets they already own), then picks a page grammar and a signature move so no two builds share a skeleton, generates photoreal assets through kie.ai or builds from the user's own footage and photos, writes real semantic HTML on a design-system floor, and verifies the result by screenshotting its own scroll. Use for "scrollytelling", "scroll animation site", "a site where scrolling plays a video", "Apple-style landing page", "3D scroll world", "interactive landing page", "make my brand a scroll experience", "make it feel different", "this looks like a template", "a unique scroll site", or any request for a site that should feel like an experience rather than a document. allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion ---

# scroll-craft

Scroll is the only input every visitor already knows how to use. This skill treats it as a timeline: the wheel is a scrubber, the page is a film with real text on top, and each section behaves differently enough that the visitor keeps going to find out what the next one does.

**What you produce:** an interview brief, a page grammar, a customer-journey map, a feeling curve with one engineered peak, a scroll score, one signature move, generated assets, one real HTML page on a token-driven design floor, and a strip of screenshots proving it holds up at every scroll position.

## What this is not

It is not "generate a flythrough and drop text on it." That approach produces one device applied to a whole page, and every site built that way is recognisable at a glance: same claymation diorama, same centred copy, same `01 / 06` counter, same "scroll to explore" nudge. Five sections that behave identically are one section shown five times.

Four rules follow from that, and they are the spine of this skill:

1. **Variety is the product.** A page uses at least four device families and never the same device twice in a row. Read [references/devices.md](references/devices.md). 2. **The world is photographic unless the brand is genuinely illustrated.** Soft matte low-poly clay diorama is banned as a default. Read [references/worlds.md](references/worlds.md). 3. **No continuous chain.** A single unbroken camera flight is the most expensive and most fragile thing you can build, and it exists only to hide cuts between scenes. Vary the device instead and the cut disappears for free, because the visitor is not watching one film. Chain only when the brief is literally "one continuous journey." 4. **A different world is not a different page.** The device kit varies how a page looks. Structure is a separate axis, and it has to be decided deliberately or every build inherits the same skeleton. The first four builds did exactly that. Read [references/uniqueness.md](references/uniqueness.md).

## Step 0: The interview

**Always interview the human before generating anything.** Not a brief you inferred from the brand name, not a plan you present for approval. Actual questions, asked, answered, written down. A page built from assumptions comes back looking like the last page built from assumptions.

The skill is a range instrument, not a house style. The human brings intent and whatever assets they own; the interview is where that turns into the right kind of page: one unbroken world, distinct scenes, printed chapters, a live surface. The skill can do any of them. The interview decides which.

Keep it short. Eight questions, asked in one pass:

1. **Vibe in three to five words**, plus up to three references from any medium. A film, an album cover, a shop, a magazine, a game. Not "sites you like": naming sites is how a page ends up looking like an existing site. 2. **The scroll journey, section by section, in their words.** What the visitor should hit first, what comes next, what the last thing is. Their sequence, not a menu you offered. 3. **The energy curve.** Where it should feel calm, where it should feel intense. A page that is loud the whole way is as flat as one that is quiet the whole way. 4. **How should someone feel while scrolling, stage by stage, and what is the ONE moment they should remember?** Energy is loudness. This is emotion, and the two do not line up: on a loud page the quiet act can be the most intense. The stage-by-stage answer becomes the feeling curve, the one moment becomes the peak. Both are required in BRIEF.md. See [references/feel.md](references/feel.md). 5. **One thing this site should do that no site they have seen does.** This is the seed of the signature move. Push for a real answer; "be memorable" is not one. 6. **How far from premium-minimal they want to go.** Offer the range in [uniqueness.md §5](references/uniqueness.md): brutalist, maximalist, playful, retro, dense, editorial, premium-minimal. Their answer governs the aesthetic family, not your taste. 7. **One unbroken world, or distinct scenes?** Should the whole page feel like one continuous place the scroll flies through (worldflight, see [references/worldflight.md](references/worldflight.md)), or like separate scenes, chapters, or cuts? This is the single biggest structural fork, and it is their call, not a device you pick later. Offer both plainly; neither is the default. 8. **What assets do they already have?** Footage, photos, product shots, a brand kit, clips of themselves. Real assets anchor the world and cut generation cost; the answer decides what gets graded and encoded versus generated. "Nothing" is a fine answer and means a fully generated world.

Write the answers into `<workspace>/builds/<name>/BRIEF.md` before any act planning, in their words, not paraphrased into marketing prose. Everything downstream reads from that file.

BRIEF.md must contain, at minimum:

- The eight interview answers, verbatim. - **The feeling curve.** One line per act: the emotion, then what on screen causes it. Written before the acts exist, added to as the score fills in. - **The peak.** The one moment, written as the sentence a visitor would say to a friend, plus which act it lives in. - **The completed tell-someone sentence.** "It's the site where ___", filled with an experience, not a device name. - Any authored silence, so the verification pass can tell it from dead scroll.

[references/feel.md](references/feel.md) is the spec for all four.

**If the human is genuinely unreachable** and the run is fully autonomous, write BRIEF.md yourself: answer all eight questions in the brand's voice, mark the file `Self-authored, not interviewed` at the top, and say so in the final report. A self-authored brief is a fallback, never the plan.

## Bootstrap

Environment, not a stage of the work. Do it once the interview is answered and before Step 1.

**Run the preflight rather than checking by hand.** It knows the failure modes that otherwise surface later as misleading errors, chiefly a stripped ffmpeg that reports a missing filter as a syntax error in your command:

```bash node <skill>/scripts/doctor.mjs ```

It reports node, a full ffmpeg build, playwright and Chrome, the API key, and the resolved workspace. Required failures exit non-zero. Say plainly which items are missing rather than working around them silently.

### The workspace

Builds and the fingerprint registry live in one directory, and **it is resolved, never assumed**:

```bash node <skill>/scripts/workspace.mjs --ensure # prints it, creates it, seeds the registry ```

Resolution order, first hit wins:

1. `SCROLLCRAFT_HOME` 2. the nearest `.scrollcraft.json` walking up from the cwd, `{ "workspace": "..." }` 3. `<project root>/scrollcraft`, where the project root is the nearest ancestor holding a `.git`

So a build folder is `<workspace>/builds/<name>/` and the registry is `<workspace>/FINGERPRINTS.md`. The registry starts **empty**: the gate exists to stop you repeating yourself, so your first build has nothing to clear.

If you already keep builds somewhere else, drop a `.scrollcraft.json` at your project root pointing at it and nothing moves.

### The rest

1. `KIE_AI_API_KEY`, **only if you are generating assets.** A build from the user's own photos and footage needs no key and no spend, and that is a first-class route, not a fallback. Confirm balance with `node <skill>/scripts/kie.mjs probe`. A still costs cents and a 5s clip costs more; a six-act page with two clips is a small spend, not a large one. 2. A brand kit if one exists (colours, logo, type, existing product shots). If the brand has a folder in this repo, read it before generating anything, and obey its hard rules. A brand that forbids invented numbers means no stat counters, however good they look.

Copy `engine/scrollcraft.js` and `engine/scrollcraft.css` into the build folder. Never edit the engine per-project; it is the mechanism. Theme it with tokens and write your own markup.

## Step 1: The brief, journey first

The subject is the user's to state. Ask it open, in plain prose, never as a fabricated multiple-choice list of industries: a made-up menu biases them and reads as you deciding their business for them.

Step 0 already covered vibe, sequence, energy and range. Do not ask any of it again. Ask only what you cannot sensibly default:

1. **What is this, and who is it for?** One or two sentences in their words. 2. **What must the visitor believe by the end?** The single sentence the page exists to install. Not a feature list. If they give three, make them pick. 3. **What does the visitor do next?** One action. One label for it, used everywhere on the page. 4. **What do you already have?** Logo, palette, photography, product shots, footage, a brand doc. Real assets beat generated ones every time. 5. **Art direction**: offer the worlds in [references/worlds.md](references/worlds.md) as a real choice, and say they can go their own way.

Then write the **journey** before anything else: four to seven beats, each one a shift in what the visitor knows or feels.

``` 1 Recognition they see their own morning 2 Tension the cost of it, named plainly 3 Turn the thing that changes 4 Substance why it holds up 5 Range what they can choose 6 Commitment the one action ```

Beats are the spine. Sections serve beats; a section that serves no beat is cut, however nice the shot is. Show the journey to the user and get it right before generating a single asset, because assets are the expensive part and the journey determines every one of them.

## Step 2: Grammar, gate, then score

Three things in order, and the first two come before any act planning. Full detail in [references/uniqueness.md](references/uniqueness.md).

**Pick a grammar.** Eight of them, and they are mutually exclusive because each one forbids things the others require. Filmic one-shot is the one the first four builds all used, so choosing it again means saying in the report why the other seven did not fit the interview. Nav, hero and close all follow from the grammar; they are not decided separately.

**Invent the signature move.** One bespoke interaction that lives on this site alone, coded in the page, not a parameter change to a kit device. Question 5 of the interview is the seed. The engine stays untouched.

**Run the fingerprint gate.** Read your registry at `<workspace>/FINGERPRINTS.md` (see **The workspace** in Bootstrap; run `node <skill>/scrip

--- name: scroll-craft description: > Build a premium, scroll-driven interactive landing page for any business: a service company, a physical product, a food brand, a drink brand. Scroll becomes the timeline. Video scrubs frame by frame under the wheel, sections pin and advance, rails pan sideways, headlines assemble line by line, the page ground shifts colour as you travel, and the pointer moves things that are not scrolling. Interviews the human first (their vibe, their journey, one unbroken world or distinct scenes, and what assets they already own), then picks a page grammar and a signature move so no two builds share a skeleton, generates photoreal assets through kie.ai or builds from the user's own footage and photos, writes real semantic HTML on a design-system floor, and verifies the result by screenshotting its own scroll. Use for "scrollytelling", "scroll animation site", "a site where scrolling plays a video", "Apple-style landing page", "3D scroll world", "interactive landing page", "make my brand a scroll experience", "make it feel different", "this looks like a template", "a unique scroll site", or any request for a site that should feel like an experience rather than a document. allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion ---

# scroll-craft

Scroll is the only input every visitor already knows how to use. This skill treats it as a timeline: the wheel is a scrubber, the page is a film with real text on top, and each section behaves differently enough that the visitor keeps going to find out what the next one does.

**What you produce:** an interview brief, a page grammar, a customer-journey map, a feeling curve with one engineered peak, a scroll score, one signature move, generated assets, one real HTML page on a token-driven design floor, and a strip of screenshots proving it holds up at every scroll position.

## What this is not

It is not "generate a flythrough and drop text on it." That approach produces one device applied to a whole page, and every site built that way is recognisable at a glance: same claymation diorama, same centred copy, same `01 / 06` counter, same "scroll to explore" nudge. Five sections that behave identically are one section shown five times.

Four rules follow from that, and they are the spine of this skill:

1. **Variety is the product.** A page uses at least four device families and never the same device twice in a row. Read [references/devices.md](references/devices.md). 2. **The world is photographic unless the brand is genuinely illustrated.** Soft matte low-poly clay diorama is banned as a default. Read [references/worlds.md](references/worlds.md). 3. **No continuous chain.** A single unbroken camera flight is the most expensive and most fragile thing you can build, and it exists only to hide cuts between scenes. Vary the device instead and the cut disappears for free, because the visitor is not watching one film. Chain only when the brief is literally "one continuous journey." 4. **A different world is not a different page.** The device kit varies how a page looks. Structure is a separate axis, and it has to be decided deliberately or every build inherits the same skeleton. The first four builds did exactly that. Read [references/uniqueness.md](references/uniqueness.md).

## Step 0: The interview

**Always interview the human before generating anything.** Not a brief you inferred from the brand name, not a plan you present for approval. Actual questions, asked, answered, written down. A page built from assumptions comes back looking like the last page built from assumptions.

The skill is a range instrument, not a house style. The human brings intent and whatever assets they own; the interview is where that turns into the right kind of page: one unbroken world, distinct scenes, printed chapters, a live surface. The skill can do any of them. The interview decides which.

Keep it short. Eight questions, asked in one pass:

1. **Vibe in three to five words**, plus up to three references from any medium. A film, an album cover, a shop, a magazine, a game. Not "sites you like": naming sites is how a page ends up looking like an existing site. 2. **The scroll journey, section by section, in their words.** What the visitor should hit first, what comes next, what the last thing is. Their sequence, not a menu you offered. 3. **The energy curve.** Where it should feel calm, where it should feel intense. A page that is loud the whole way is as flat as one that is quiet the whole way. 4. **How should someone feel while scrolling, stage by stage, and what is the ONE moment they should remember?** Energy is loudness. This is emotion, and the two do not line up: on a loud page the quiet act can be the most intense. The stage-by-stage answer becomes the feeling curve, the one moment becomes the peak. Both are required in BRIEF.md. See [references/feel.md](references/feel.md). 5. **One thing this site should do that no site they have seen does.** This is the seed of the signature move. Push for a real answer; "be memorable" is not one. 6. **How far from premium-minimal they want to go.** Offer the range in [uniqueness.md §5](references/uniqueness.md): brutalist, maximalist, playful, retro, dense, editorial, premium-minimal. Their answer governs the aesthetic family, not your taste. 7. **One unbroken world, or distinct scenes?** Should the whole page feel like one continuous place the scroll flies through (worldflight, see [references/worldflight.md](references/worldflight.md)), or like separate scenes, chapters, or cuts? This is the single biggest structural fork, and it is their call, not a device you pick later. Offer both plainly; neither is the default. 8. **What assets do they already have?** Footage, photos, product shots, a brand kit, clips of themselves. Real assets anchor the world and cut generation cost; the answer decides what gets graded and encoded versus generated. "Nothing" is a fine answer and means a fully generated world.

Write the answers into `<workspace>/builds/<name>/BRIEF.md` before any act planning, in their words, not paraphrased into marketing prose. Everything downstream reads from that file.

BRIEF.md must contain, at minimum:

- The eight interview answers, verbatim. - **The feeling curve.** One line per act: the emotion, then what on screen causes it. Written before the acts exist, added to as the score fills in. - **The peak.** The one moment, written as the sentence a visitor would say to a friend, plus which act it lives in. - **The completed tell-someone sentence.** "It's the site where ___", filled with an experience, not a device name. - Any authored silence, so the verification pass can tell it from dead scroll.

[references/feel.md](references/feel.md) is the spec for all four.

**If the human is genuinely unreachable** and the run is fully autonomous, write BRIEF.md yourself: answer all eight questions in the brand's voice, mark the file `Self-authored, not interviewed` at the top, and say so in the final report. A self-authored brief is a fallback, never the plan.

## Bootstrap

Environment, not a stage of the work. Do it once the interview is answered and before Step 1.

**Run the preflight rather than checking by hand.** It knows the failure modes that otherwise surface later as misleading errors, chiefly a stripped ffmpeg that reports a missing filter as a syntax error in your command:

```bash node <skill>/scripts/doctor.mjs ```

It reports node, a full ffmpeg build, playwright and Chrome, the API key, and the resolved workspace. Required failures exit non-zero. Say plainly which items are missing rather than working around them silently.

### The workspace

Builds and the fingerprint registry live in one directory, and **it is resolved, never assumed**:

```bash node <skill>/scripts/workspace.mjs --ensure # prints it, creates it, seeds the registry ```

Resolution order, first hit wins:

1. `SCROLLCRAFT_HOME` 2. the nearest `.scrollcraft.json` walking up from the cwd, `{ "workspace": "..." }` 3. `<project root>/scrollcraft`, where the project root is the nearest ancestor holding a `.git`

So a build folder is `<workspace>/builds/<name>/` and the registry is `<workspace>/FINGERPRINTS.md`. The registry starts **empty**: the gate exists to stop you repeating yourself, so your first build has nothing to clear.

If you already keep builds somewhere else, drop a `.scrollcraft.json` at your project root pointing at it and nothing moves.

### The rest

1. `KIE_AI_API_KEY`, **only if you are generating assets.** A build from the user's own photos and footage needs no key and no spend, and that is a first-class route, not a fallback. Confirm balance with `node <skill>/scripts/kie.mjs probe`. A still costs cents and a 5s clip costs more; a six-act page with two clips is a small spend, not a large one. 2. A brand kit if one exists (colours, logo, type, existing product shots). If the brand has a folder in this repo, read it before generating anything, and obey its hard rules. A brand that forbids invented numbers means no stat counters, however good they look.

Copy `engine/scrollcraft.js` and `engine/scrollcraft.css` into the build folder. Never edit the engine per-project; it is the mechanism. Theme it with tokens and write your own markup.

## Step 1: The brief, journey first

The subject is the user's to state. Ask it open, in plain prose, never as a fabricated multiple-choice list of industries: a made-up menu biases them and reads as you deciding their business for them.

Step 0 already covered vibe, sequence, energy and range. Do not ask any of it again. Ask only what you cannot sensibly default:

1. **What is this, and who is it for?** One or two sentences in their words. 2. **What must the visitor believe by the end?** The single sentence the page exists to install. Not a feature list. If they give three, make them pick. 3. **What does the visitor do next?** One action. One label for it, used everywhere on the page. 4. **What do you already have?** Logo, palette, photography, product shots, footage, a brand doc. Real assets beat generated ones every time. 5. **Art direction**: offer the worlds in [references/worlds.md](references/worlds.md) as a real choice, and say they can go their own way.

Then write the **journey** before anything else: four to seven beats, each one a shift in what the visitor knows or feels.

``` 1 Recognition they see their own morning 2 Tension the cost of it, named plainly 3 Turn the thing that changes 4 Substance why it holds up 5 Range what they can choose 6 Commitment the one action ```

Beats are the spine. Sections serve beats; a section that serves no beat is cut, however nice the shot is. Show the journey to the user and get it right before generating a single asset, because assets are the expensive part and the journey determines every one of them.

## Step 2: Grammar, gate, then score

Three things in order, and the first two come before any act planning. Full detail in [references/uniqueness.md](references/uniqueness.md).

**Pick a grammar.** Eight of them, and they are mutually exclusive because each one forbids things the others require. Filmic one-shot is the one the first four builds all used, so choosing it again means saying in the report why the other seven did not fit the interview. Nav, hero and close all follow from the grammar; they are not decided separately.

**Invent the signature move.** One bespoke interaction that lives on this site alone, coded in the page, not a parameter change to a kit device. Question 5 of the interview is the seed. The engine stays untouched.

**Run the fingerprint gate.** Read your registry at `<workspace>/FINGERPRINTS.md` (see **The workspace** in Bootstrap; run `node <skill>/scrip