Content-Derived Design for AI Agents v2.13.1

Your HTML is the brief.
The engine reads it and redesigns it.

Content-Derived Design — palette, motifs, and motion are extracted from the concrete nouns, dates, and colors already in the source HTML. Not a mood board. A real artifact. npx reimagine-it ships one standalone HTML file — in 17 directions (including a photoshoot lookbook and a living particles field), each carrying a AAA motion pack: kinetic type, magnetic buttons, glow-follow cards, inertia-orbit 3D with fact billboards. Offline. No Figma. No CDN.

17Design tokens
19Health rules
9Committed journeys
0CDN deps
CI Gate main protected + codeowners secret scanning + push protection SLSA provenance OpenSSF Scorecard

Content-Derived Design — how it works

The engine reads the HTML you point at, extracts concrete nouns / dates / colors / proper nouns, and builds a design language from them. Source facts are not invented.

01 · Extract

Read the source

Find proper nouns, dates, color words, numbers, and anchor phrases in the HTML you point at. These are the raw material.

02 · Derive

Build the palette

A Texas notebook gets navy / red / gold from the Lone Star flag. A restaurant menu gets clay / saffron from the dish names. ≤ 5 colors, all from content.

03 · Motif

Pick the repeating mark

Lone Star, beam sweep, smoke tendril, pulse wave — one geometric motif from the source carried through every section.

04 · Ship

Produce one artifact

Single .html file. Inline CSS. Inline SVG. Inline WebGL. Compositor-only motion. Craft-floor checked. Opens offline. Double-clickable.

Nine sources. No shared silhouette.

Auto scored each source into a subject lane and forbade the same silhouette twice. A juice bar, a skate deck, and a streetwear drop cannot all become one bar-chart poster. Palettes come from hex colors already written into each source. Full case studies →

Auto results — nine distinct compositions

These are the committed Auto desktops. Same command, nine silhouettes. Scores and fidelity come from each bundle’s auto.json. Read every source, result, and report → · Step-by-step case studies →

Auto result reel: nine sources cycling through their scored directions

Venator Auto desktop
Venatorgradient · 246 · 100%
Crimson Circuit Auto desktop
Crimson Circuitcinematic · 258 · 100%
Velocita Auto desktop
Velocitaartistic · 240 · 100%
Maracuyá Auto desktop
Maracuyálanding · 246 · 100%
Flick Fits Auto desktop
Flick Fitsphotography · 250 · 100%
Meridian Auto desktop
Meridian3js · 260 · 100%
Horizon Auto desktop
Horizondashboard · 330 · 100%
Hearth & Grain Auto desktop
Hearth & Grainphotography · 226 · 100%
Millbrook Auto desktop
Millbrookinfographic · 278 · 100%
SourceAutoScoreFidelityAlternates
Venatorgradient246100%landing, artistic
Crimson Circuitcinematic258100%gradient, landing
Velocitaartistic240100%gradient, landing
Maracuyálanding246100%photography, gradient
Flick Fitsphotography250100%showcase, landing
Meridian Tower3js260100%editorial, svg
Horizondashboard330100%gradient, landing
Hearth & Grainphotography226100%landing, editorial
Millbrookinfographic278100%simulation, editorial

Proof — sources outside the journeys

Two community proofs — jobs none of the journeys cover. A clinic bulletin lands infographic (352 · 100%); a fashion-house photoshoot campaign lands the lookbook editorial spread (188 · 100% · 19/19 facts). Committed stills regenerate byte-identically from the sources in examples/community/.

Riverside Community Clinic walk-in bulletin redesigned as an infographic timeline at desktop width
clinic bulletin — desktop --auto → infographic
Riverside Community Clinic bulletin at tall phone width
clinic — mobile
Maison Vesper autumn/winter 2026 photoshoot campaign redesigned as a lookbook editorial spread at desktop width
Maison Vesper campaign — desktop --auto → lookbook
Maison Vesper campaign lookbook at tall phone width
campaign — mobile

Proof — real public-domain pages

Six U.S. government and public-collection pages — National Park Service, NASA, NOAA/NWS, Census Bureau, Federal Register, Smithsonian — rebuilt by Auto with no declared palette to lean on: the engine derives color from language alone. Artemis II lands the 3js orbit view (100%), the hurricane outlook a landing brief (100%), the Yellowstone bulletin an editorial feature (84% — the floor is 80). The 2026 additions stress new failure modes: the Census income brief carries nine dollar figures that must survive (infographic, 21/21), the Federal Register FOIA rule is all dates and citations (simulation, 17/17), and the Smithsonian Apollo 11 object page is descriptive copy (simulation, 21/21). Sources are public domain, committed in examples/public-sources/.

NASA Artemis II mission overview redesigned as an interactive 3D orbit view at desktop width
Artemis II — desktop --auto → 3js
NASA Artemis II mission overview at tall phone width
Artemis II — mobile
Yellowstone National Park visitor bulletin redesigned as an editorial feature at desktop width
Yellowstone bulletin — desktop --auto → editorial
National Weather Service hurricane outlook redesigned as a briefing landing page at tall phone width
hurricane outlook — mobile --auto → landing
Census Bureau 2023 income brief redesigned as a ranked statistical poster at desktop width
Census income brief — desktop --auto → infographic
Census Bureau 2023 income brief at tall phone width
Census income brief — mobile
Federal Register FOIA procedural rule redesigned as a playable timeline simulation at desktop width
Federal Register FOIA rule — desktop --auto → simulation
Smithsonian Apollo 11 command module page at tall phone width
Apollo 11 Columbia — mobile --auto → simulation

Source → Auto, on desktop and phone

Each composite is the plain source on the left and the Auto page on the right, with a phone frame. Use it to check facts and reading path, not just color. Design Health — CI quality gate →

Venator crypto battle royale: plain source to signal-yellow gradient arena, landing, and phone screens

Game → signal-yellow gradient → landing → mobile

Crimson Circuit music festival: plain source to magenta cinematic chapters, gradient, and phone screens

Festival → magenta cinematic → gradient → mobile

Velocita skateboards: plain source to flame-orange artistic poster, landing, and phone screens

Skate brand → orange poster → landing → mobile

Maracuyá juice bar: plain source to coral product landing, photography, and phone screens

Juice bar → coral landing → photography → mobile

Flick Fits streetwear: plain source to electric-blue photography folio, showcase, and phone screens

Streetwear → blue folio → showcase → mobile

Meridian Tower building: plain source to amber 3D object, editorial feature, svg diagram, and phone screens

Building → amber 3D → editorial → svg → mobile

Horizon observability: plain source to navy ops dashboard, gradient, and phone screens

Dev tools → navy dashboard → gradient → mobile

Hearth & Grain bakery: plain source to crust-brown photography folio of the morning bake, and phone screens

Bakery → crust-brown folio → landing → mobile

Millbrook city budget: plain source to navy-and-brass infographic timeline, and phone screens

Civic budget → brass infographic → simulation → mobile

Nine redesign journeys with phone frames: gaming arena, festival poster, skate deck, juice menu, streetwear drop, building suite, dev-tools dashboard, bakery folio, and civic budget poster

How to judge it: check the facts, the reading path, and whether the composition belongs to the subject—not just whether the colors changed.

Seventeen directions. One honest method.

Every token is a real generator in the engine — each one reads the same extracted content and builds a structurally different composition. Layouts are generated; source facts are not invented.

webpage token output01
webpage

Articles and source documents

Measured reading hierarchy

landing token output02
landing

Products and services

Hero and action rhythm

dashboard token output03
dashboard

Metrics and operations

Console, KPIs, and status

infographic token output04
infographic

Facts and comparisons

Shared scales and timelines

cinematic token output05
cinematic

Narrative moments

Depth and paced chapters

artistic token output06
artistic

Posters and expressive pages

Asymmetric type and layered fields

photography token output07
photography

Portfolios and collections

Folio plates and captions

svg token output08
svg

Marks and diagrams

Inline geometric illustration

3js token output09
3js

Spatial stories

Offline orbitable canvas

simulation token output10
simulation

Time and process

Playable timeline and scrubber

glass token output11
glass

Modern panels and cards

Frosted backdrop depth

editorial token output12
editorial

Long-form text and essays

Magazine layout with drop caps

motion token output13
motion

Scroll-driven stories

Animated reveals and parallax

gradient token output14
gradient

Bold brand presentations

Gradient mesh cards and text

showcase token output15
showcase

Capability demonstrations

Motion-forward capability cards and stats

lookbook token output16
lookbook

Photoshoots and collections

Editorial spread with numbered looks

particles token output17
particles

Living networks and signals

Interactive constellation of the anchors

Infographics — wide and tall.

A data-heavy source — 14 species, 320 miles, 1,180 volunteer hours, a 42% jump — rendered as a dense infographic at desktop width and phone width. Same command, two aspect ratios.

Infographic at wide desktop width
wide — desktop --token infographic
Infographic at tall phone width
tall — mobile

Source: Cedar & Ash — 2026 Season Field Report · command: npx reimagine-it -i source.html -t infographic -o report.html · every number below appears in the source.

Gaming — loud, yellow, unmissable.

A crypto battle-royale page — loot boxes, kill-to-earn stakes, a season clock — becomes a signal-yellow gradient arena at desktop width and phone width. The palette comes from the hex colors already in the source, not from a style prompt.

Venator gaming page at wide desktop width
wide — desktop --auto → gradient
Venator gaming page at tall phone width
tall — mobile

Source: Venator — Crypto Battle Royale · command: npx reimagine-it --auto -i source.html · Auto scored gradient first for gaming sources: the arena reads as a brand surface, not an ops console.

Observability — plain SLO page to mission control.

A bare uptime/SLO source — 99.99% availability, 2.1B events, 180 ms p50 — becomes a navy ops console at desktop width and phone width. Auto scores dashboard first for operational sources; KPIs come from numbers already in the source.

Horizon observability dashboard at wide desktop width
wide — desktop --auto → dashboard
Horizon observability dashboard at tall phone width
tall — mobile

Source: Horizon — Observability & SLOs · command: npx reimagine-it --auto -i source.html · alternates: gradient (kinetic headline) and landing (glyph hero).

One command. Three furnished designs.

Point /reimagine-it at a building page and it does the visual heavy lifting: an orbitable 3D object, a magazine feature, and a living SVG diagram — every one derived from the same source, no direction from you needed.

npx reimagine-it --auto -i meridian.html   # reads the page, ships 3 designs
Meridian Tower orbitable 3D object at desktop width
01 · auto — 3D object
Meridian Tower magazine feature
02 · editorial
Animated living SVG diagram of Meridian Tower anchors
03 · svg● live render

Source: Meridian Tower — A Living Building · the amber, steel, copper, and sky palette comes from the hex colors in the source · the 3D object orbits (drag or arrow keys) and the diagram spins and breathes — real engine output, not mockups. See all nine journeys ↓

For agents — MCP server & one-file skill

The same engine, exposed to any MCP-compatible host (Claude Code, Codex, Copilot, Gemini CLI, and friends) or used as a single-file agent skill. Deterministic, offline, no API keys — an agent can generate, self-audit its own output with 19 rules, and explain the design decision.

MCP · any host

One JSON stanza

{ "mcpServers": { "reimagine-it": {
  "command": "npx",
  "args": ["-y", "--package", "reimagine-it",
           "reimagine-it-mcp"] } } }

Node native HTTP/streamable transport; no Python required.

8 tools

Generate, rank, verify

reimagine        one direction from raw HTML
design_auto      choose · generate · verify · explain
design_variations  ranked directions + contrast sheet
design_lock      capture a brand surface as JSON
extract_content  inspect the source evidence
list_tokens      discover the 17 directions
audit_html       19-rule Design Health check
list_rules       the full rule registry

An agent can prove its own output before shipping it.

Design decision report

Inspectable "why"

voice      editorial | grotesque | techno | …
palette    OKLCH, source accent rotated
art        primitives actually used
score      136-point design-QA
fidelity   every source fact present

Written beside the artifact with --emit; Auto explains its pick from real evidence.

Measured quality — every direction benchmarked

All 17 tokens × 4 representative sources score 100/100 usability and full fidelity, with 96.8% mean class-set difference (no two directions produce the same page; the closest pair, webpage+landing, rose from 76% to 91.7% after landing grew its own hero form). Benchmarked against the same bar Auto itself applies: standalone HTML, source title and anchors retained, focus-visible, reduced-motion, no placeholder copy, no external fetch.

CI-enforced

Proof regenerates — or CI fails

Every committed example artifact must regenerate byte-identically from the committed engine. Every screenshot stays in sync. npm pack must match the intentional file list exactly.

Property-tested

Honesty is fuzzed

The extractor's "no invented facts" contract runs against hostile and malformed input; a 250-seed weekly stress harness holds the fidelity floor across every token × source cell. The audit linter itself is fuzzed too.

Supply-chain

Hardened end to end

Actions SHA-pinned + Dependabot-bumped; CI installs with --ignore-scripts and hash-verified PyPI pins; releases carry cosign signatures + SLSA provenance; CodeQL and Semgrep scan every push.

Guarantee

Offline & deterministic

Output is one standalone HTML file — no CDN, no API keys, no telemetry. Same input + seed → byte-identical output: clients can re-derive any published artifact themselves.

The audit is deterministic and heuristic — not a claim of full WCAG conformance or visual taste. Review a generated page before shipping it to a client. Full details: README audit posture →

Install — one command

Works in Claude Code, Cursor, Codex, Copilot, Gemini CLI, Factory Droid, Windsurf, Pi, and any Agent Skills host. One chair: skills/reimagine-it/. This is Kayforkind’s Content-Derived Design CLI — not Keith Mangold’s reimagineit.ai interview SaaS.

CLI · no agent required

npx reimagine-it

npx reimagine-it --auto -i page.html -o redesign.html
npx reimagine-it variations -i page.html -n 4
npx reimagine-it lock -i brand.html -o house.lock.json
npx reimagine-it audit redesign.html

Brand-lock with --ref house.lock.json. Reverse-lock from any HTML.

Claude Code

Plugin marketplace

/plugin marketplace add Kayforkind/reimagine-it
/plugin install reimagine-it@reimagine-it

Then /plugin → Marketplaces → Enable auto-update

Cursor · Codex · Copilot · Gemini CLI

npx skills add

npx skills add Kayforkind/reimagine-it

Global: npx skills add Kayforkind/reimagine-it -g

Codex CLI

Plugin marketplace

codex plugin marketplace add Kayforkind/reimagine-it
codex plugin add reimagine-it@reimagine-it
Factory Droid

droid plugin install

droid plugin marketplace add https://github.com/Kayforkind/reimagine-it
droid plugin install reimagine-it@reimagine-it --scope user
Pi

Single command

pi install https://github.com/Kayforkind/reimagine-it
Gemini CLI (manual)

Direct install

gemini skills install https://github.com/Kayforkind/reimagine-it.git --path skills/reimagine-it
7 typographic voices OKLCH palette system generative art primitives composition bands self-critique design score

Try it — no install required

Paste any HTML below. Pick a token — or let Auto draw three directions with a typographic voice, a harmonious palette, and a 136-point design score. The engine runs entirely in your browser. Same method the agent skill uses. New here? ▶ Watch the 60-second teaser (captioned) or the 39-second full walkthrough.

Paste your HTML Try a sample source
Pick a token
Seed (optional)
Preview