scrollcraft-anywhere

The scrollcraft skill, usable from every coding agent — not just Claude Code.

scrollcraft builds premium scroll-driven websites and holds them to a real design standard: eight mutually exclusive page grammars, a required signature move per build, a fingerprint gate so no two of your sites share a skeleton, and a headless-browser verification pass. The catch was packaging: it shipped as a Claude Code plugin only.

This repo fixes that. One vendored copy of the full skill lives in .scrollcraft/ inside your project; the installer drops a small adapter file for each agent it detects, and every adapter says the same thing: before building any scroll-driven or marketing-grade page, read .scrollcraft/SKILL.md and follow it end to end.

Supported agents

Agent What gets installed How it loads
Claude Code .claude/skills/scrollcraft/ (native skill, full copy) automatic
Cursor .cursor/rules/scrollcraft.mdc agent-decided rule
Windsurf .windsurf/rules/scrollcraft.md model-decided rule
Codex & any AGENTS.md reader section appended to AGENTS.md always in context
GitHub Copilot section appended to .github/copilot-instructions.md always in context
Gemini CLI section appended to GEMINI.md always in context
opencode .opencode/agent/scrollcraft.md (subagent) on request
Aider section appended to CONVENTIONS.md run with --read CONVENTIONS.md
Cline .clinerules/scrollcraft.md always in context
Roo Code .roo/rules/scrollcraft.md always in context

Anything not listed that reads AGENTS.md picks up the codex adapter for free.

Install

# inside your web project
node /path/to/scrollcraft-anywhere/install.mjs

The installer scans for agent config markers (.claude/, .cursor/, AGENTS.md, GEMINI.md, .windsurf/, .opencode/, .clinerules/, ...), copies the skill to .scrollcraft/, and writes one adapter per detected agent. It records everything in .scrollcraft-anywhere.json.

node install.mjs --list              # show what was detected, change nothing
node install.mjs --all               # install for every known agent
node install.mjs --only cursor,codex # specific agents
node install.mjs --force             # overwrite existing non-marker files
node install.mjs --remove            # clean uninstall via the manifest

Re-running is safe: appended sections are refreshed between marker tags, tracked files are rewritten, and files you created yourself are never touched without --force.

First run

node .scrollcraft/scripts/doctor.mjs   # preflight: ffmpeg, Chrome, playwright-core

Requirements are unchanged from upstream: Node 18+, a full ffmpeg build, playwright-core + Chrome (installed in the build folder). A KIE_AI_API_KEY is optional and only needed for generated assets — building from your own photos and footage is free.

Layout

install.mjs              detection matrix + adapter writers + manifest uninstall
vendor/scrollcraft/      verbatim upstream skill (SKILL.md, references/, engine/, scripts/)
.scrollcraft/            where the skill lands in a target project
.scrollcraft-anywhere.json  install manifest: what we wrote, what we appended

Design rules

  • One copy of the truth. Adapters are thin pointers; the procedure itself is vendored once. Update vendor/ and reinstall to refresh.
  • No symlinks. Everything is real files, so it works identically on Windows, macOS and Linux.
  • Adapters never dump the skill into context. Each one is a short instruction to read SKILL.md first, so agents that preload whole rule files don't burn context on all nine reference docs when the task doesn't need them.
  • Upstream stays untouched. vendor/ is a verbatim copy of the released skill; only the packaging layer is new.

Honest limitations

  • Adapter formats were written against each tool's documented conventions as of mid-2026; frontmatter fields occasionally move between releases. If an agent ignores its adapter, check its current docs for rule-file syntax.
  • Claude Code users may prefer the original plugin (/plugin marketplace add nateherkai/scroll-craft) — same skill, plus plugin-marketplace updates.
  • The skill's scripts have only ever been exercised on Windows upstream; SCROLLCRAFT_FFMPEG and SCROLLCRAFT_CHROME override the search paths elsewhere.