# reimagine-it

Adopt this skill: https://proskills.md/skills/design/kayforkind-reimagine-it-skills-reimagine-it

Page: https://proskills.md/skills/design/kayforkind-reimagine-it-skills-reimagine-it
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/reimagine-it/SKILL.md
size: 8071
upstream: https://github.com/kayforkind/reimagine-it/blob/main/skills/reimagine-it/SKILL.md

````text
---
name: reimagine-it
description: >-
  Content-Derived Design — reads existing HTML and writes a stronger standalone
  page from headings, facts, names, dates, numbers, links, emails, and colors
  already in that file. CLI: npx reimagine-it --auto -i page.html -o out.html;
  also variations, lock, and audit. Use when the user says /reimagine-it, "reimagine it", "reinvent this",
  "redesign this page", "make an infographic", wants a content-aware redesign
  or a visual leap instead of a mood board.   All 17 tokens: webpage,
  infographic, svg, 3js, simulation, artistic, cinematic, dashboard,
  photography, landing, editorial, gradient, showcase, motion, glass,
  lookbook, particles — plus leftover words as a brief. Also /reimagine-it
  audit for quality checks. The agent runs the CLI; it does not hand-author
  the page.
  Installed via npx skills add Kayforkind/reimagine-it or plugin marketplace.
  Not /better. Not a mood board. Does not ingest PDF, PPTX, or DOCX.
license: MIT
metadata:
  author: Kayforkind
  version: "2.15.0"
  hosts:
    - claude-code
    - cursor
    - codex
    - copilot
    - gemini-cli
    - factory-droid
    - agent-skills
keywords:
  - content-derived-design
  - redesign
  - infographic
  - svg
  - threejs
  - frontend
  - html
  - css
  - palette
  - motion
  - offline
category: Design
capabilities:
  - content-extraction
  - color-palette-generation
  - infographic-creation
  - svg-generation
  - threejs-scene-generation
  - simulation-generation
  - accessibility-audit
  - visual-verification
trigger_phrases:
  - /reimagine-it
  - reimagine it
  - reinvent this
  - redesign this page
  - make an infographic
  - content-aware redesign
  - design from content
  - redesign from source
  - palette from content
  - variations
  - lock brand
  - design health
  - audit this page
  - auto redesign
  - frontend
  - html
  - css
  - palette
  - motion
  - offline
---

# /reimagine-it

**Banks:** [references/notes.md](references/notes.md) · [references/forms.md](references/forms.md) · [references/webpage-craft.md](references/webpage-craft.md) *(only for the webpage form)* · **[references/craft-floor.md](references/craft-floor.md)** *(the interaction contract every webpage output must clear; read every run)* · **[references/review.md](references/review.md)** *(§5.d named-object accuracy + clone scan; load on every verify)* · [references/forms/](references/forms/) *(non-webpage form packs: pdf, document, slides, universal)* · [references/domains/](references/domains/) *(only when the user gave a domain token: `artistic` / `dashboard` / `photography` / `cinematic` (aka `3d`, `webgl`) / `ecommerce` / `landing` / `portfolio` / `infographic`)* · [references/modifiers/](references/modifiers/) *(only when the user gave a modifier: `glassmorphism` / `bento` / `neon` / `brutalism` / `neumorphism` / `handdrawn`)* · [references/locks/](references/locks/) *(loaded on `--ref <name>`)* · **[references/research/web-craft-2025.md](references/research/web-craft-2025.md)** *(deep source pack — Awwwards SOTY stack scan, Rauno/Emil craft floor, Lupi/Fragapane data humanism, Feixen/Weingart/Troxler print grammar, Apple AIDA cinematic, view-transitions, scroll-driven animations, kinetic type, sound, neubrutalism — read once, cite in reports)* · **[references/research/infographic-craft.md](references/research/infographic-craft.md)** *(15-source infographic pack — Cleveland–McGill, Tufte, Bertin, ISOTYPE, Minard/Snow, Cairo, Lupi, FT Visual Vocabulary, USWDS, WCAG charts, InfoAlign layouts — load when the form or domain is `infographic`)* · [examples.md](examples.md)

`/reimagine-it` is a **Content-Derived Design** engine. The shipped product reads **HTML** and writes **HTML**: extract the headings, facts, names, dates, numbers, links, emails, and colors already in the file, then generate a standalone page in one of 17 tokens (or `--auto`). Default output is offline.

Do **not** claim the CLI redesigns PDF, PPTX, DOCX, MOBI, or “any file.” If the user pointed at another format, convert or wrap it as HTML first, run the engine, and only then — if they asked and the toolchain exists — export with a host tool. Report that extra step as host conversion, not as an engine feature.

If `local.md` exists beside this file, Read it after this skill (host chairs, org, paths). Public installs have no `local.md`.

Say once: **"Running /reimagine-it."**

## Engine — run the CLI; do not invent the page

The shipped product is the **CLI**. `/reimagine-it` is orchestration around it, not a license to hand-author HTML.

1. If the source is not HTML, wrap or extract it into HTML first. Do not claim the engine ingested PDF, PPTX, or DOCX.
2. Run the matching command and use the file it writes:

```bash
npx reimagine-it --auto -i page.html -o redesign.html
npx reimagine-it -i page.html -t infographic -o poster.html
npx reimagine-it variations -i page.html -n 3 -o review/
npx reimagine-it extract -i page.html
npx reimagine-it audit redesign.html
```

The CLI enforces the source guard mechanically: an `--output` path that resolves to the source file exits 2 without writing. Pass `--no-clobber` to also refuse replacing an existing output file — useful when an agent or CI loop must not clobber a reviewed artifact. Auto mode also holds an advisory run lock next to the artifact, so a second agent targeting the same output fails fast instead of interleaving writes; crashed runs self-heal via stale-lock detection, and `--force` overrides.

3. Open that artifact. Report from it. If `npx reimagine-it` cannot run, ship `REIMAGINED: partial` and name the exact blocker — do not substitute a model-written page.

## Categories (you choose · agent decides)

Optional tokens. **Combine freely.** You pick tokens; the agent picks questions, form (if unset), mutations, and the stretch.

| Category | You choose | Agent decides |
|----------|------------|---------------|
| *(none)* | Default. No interview. | Infer, lock, form, build. |
| **Auto** — `auto` / `--auto` | Let the tool manage the normal redesign loop. | Extract evidence → rank coherent forms → generate candidates → verify → return the strongest artifact. Source stays read-only. |
| `interview` | Talk before build. | Which questions, recommended answers, when to stop. |
| **Form family** — `code` `cli` `protocol` `demo` `prose` `product` `architecture` `experiment` | Force that form family. | How the notes land in it. |
| **Visual form** — `svg` `3js` `infographic` `canvas` `html` `webpage` `simulation` | Force a visual form. | Craft inside that medium. Token `infographic` also loads [references/domains/infographic.md](references/domains/infographic.md) (poster of an argument, not a dashboard). Token `svg` / `3js` ship **alive-micro** by default (2–4 fact-tied loops that beautify; brief `still` freezes). Token `simulation` ships a playable model of facts already in **this** source — default paused on the first fact; nested short spans are inspectable; type in the gutter. None of these are a Texas skin; leftover words are a lens. |
| **Host conversion (not CLI tokens)** — `pdf` `document` `slides` | Only if the user asked **and** local tools exist. | Convert/wrap as HTML → run the engine → optional export (Weasyprint, python-docx, python-pptx). The CLI does not read or write these formats. |
| **Domain aesthetic** — second word after `webpage`: `artistic` `dashboard` `photography` `cinematic` (`3d`, `webgl`) `ecommerce` `landing` `portfolio` `infographic` | Force a webpage aesthetic. | Load [references/domains/<domain>.md](references/domains/) and extend the [webpage-craft](references/webpage-craft.md) spine. `cinematic` upgrades the 3D floor to inline WebGL2. `infographic` is a statistical poster (common-scale encodings + ISOTYPE + data table) — not an ops dashboard. |
| **Modifier** — third word or `--style <name>`: `glassmorphism` `bento` `neon` `brutalism` `neumorphism` `handdrawn` | Layer a UI/UX modifier on top of the domain. | Loa
````

## File: README.md
upstream: https://github.com/kayforkind/reimagine-it/blob/main/README.md

````text
# reimagine-it

> **The source file is the design brief.** Turn existing HTML into a beautiful, usable page — without losing its meaning.

[![CI](https://img.shields.io/github/actions/workflow/status/Kayforkind/reimagine-it/audit.yml?branch=main&label=CI&logo=github)](https://github.com/Kayforkind/reimagine-it/actions/workflows/audit.yml)
[![CI Gate](https://img.shields.io/github/actions/workflow/status/Kayforkind/reimagine-it/gate.yml?branch=main&label=CI%20Gate)](https://github.com/Kayforkind/reimagine-it/actions/workflows/gate.yml)
[![main is protected](https://img.shields.io/badge/main-protected%20%2B%20codeowners-2ea043.svg)](.github/SECURITY.md)
[![supply chain](https://img.shields.io/badge/actions-SHA--pinned%20%2B%20dependabot-2ea043.svg)](.github/SECURITY.md)
[![secret scanning](https://img.shields.io/badge/secret%20scanning-push%20protection%20on-2ea043.svg)](.github/SECURITY.md)
[![provenance](https://img.shields.io/badge/npm%20releases-SLSA%20provenance-2ea043.svg)](https://docs.npmjs.com/generating-provenance-statements)
[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/Kayforkind/reimagine-it/badge)](https://securityscorecards.dev/viewer/?uri=github.com/Kayforkind/reimagine-it)
[![Benchmark](https://img.shields.io/github/actions/workflow/status/Kayforkind/reimagine-it/benchmark.yml?branch=main&label=benchmark%20100%2F100)](https://github.com/Kayforkind/reimagine-it/actions/workflows/benchmark.yml)
[![Design Health](https://img.shields.io/github/actions/workflow/status/Kayforkind/design-health-action/audit.yml?branch=main&label=Design%20Health&logo=github)](https://github.com/Kayforkind/design-health-action/actions/workflows/audit.yml)
[![version 2.15.0](https://img.shields.io/badge/version-2.15.0-b22234.svg)](CHANGELOG.md)
[![npm](https://img.shields.io/npm/v/reimagine-it?color=e8a63f&label=npm)](https://www.npmjs.com/package/reimagine-it)
[![MIT](https://img.shields.io/badge/license-MIT-1a2138.svg)](LICENSE)
[![skills.sh](https://skills.sh/b/kayforkind/reimagine-it)](https://skills.sh/kayforkind/reimagine-it)
[![GitHub stars](https://img.shields.io/github/stars/Kayforkind/reimagine-it?style=flat&color=b22234)](https://github.com/Kayforkind/reimagine-it/stargazers)

[![reimagine-it — nine sources, no shared silhouette](https://raw.githubusercontent.com/Kayforkind/reimagine-it/main/docs/og.png)](https://kayforkind.github.io/reimagine-it/#results)

[![Auto result reel](https://raw.githubusercontent.com/Kayforkind/reimagine-it/main/docs/demo.gif)](https://kayforkind.github.io/reimagine-it/#playground)

**[▶ 39-second walkthrough](docs/playground-walkthrough.mp4)** — silent screen capture of the playground: paste HTML → Auto draws three directions → pick one → download the standalone artifact.

<div align="center">

**[Try the live playground](https://kayforkind.github.io/reimagine-it/#playground)** · **[See the results](https://kayforkind.github.io/reimagine-it/#results)** · **[Run it locally](#the-60-second-proof)** · **[Install it](#install)** · **[The lab behind it](https://navigatorslab.com/reimagine/)**

</div>

## One command. One inspectable result.

**reimagine-it** redesigns an existing HTML page from the content already inside it. It extracts the real headings, facts, links, names, dates, numbers, and colors, then builds a stronger visual system around them — without replacing the page with invented filler.

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

**Source in. Beautiful, usable HTML out. The source stays untouched.** The result is one standalone HTML file — offline, no CDN, no Figma, no build step. Four commands share that engine: generate (or `--auto`), `variations`, `lock`, and `audit`.

## See it work

Real sources, real CLI output — nine committed journeys. The seven launch journeys own seven distinct Auto tokens, so a juice bar, a skate deck, and a streetwear drop do not share a silhouette; the two newest prove the v2.7.0 guarantees — a bakery collection becomes a photography folio (not a data poster), and a city budget becomes an infographic whose first fold is the source's own timeline.

| Source | Auto | Score | Fidelity | Alternates |
|---|---|---|---|---|
| [Venator](examples/end-users/venator/) | `gradient` | 246 | 100% | `artistic`, `landing` |
| [Crimson Circuit](examples/end-users/crimson-circuit/) | `cinematic` | 258 | 100% | `gradient`, `motion` |
| [Velocita](examples/end-users/velocita/) | `artistic` | 240 | 100% | `gradient`, `editorial` |
| [Maracuyá](examples/end-users/maracuya/) | `landing` | 246 | 100% | `editorial`, `photography` |
| [Flick Fits](examples/end-users/flick/) | `photography` | 250 | 100% | `showcase`, `editorial` |
| [Meridian Tower](examples/end-users/meridian/) | `3js` | 260 | 100% | `editorial`, `cinematic` |
| [Horizon](examples/end-users/horizon/) | `dashboard` | 330 | 100% | `infographic`, `gradient` |
| [Hearth & Grain](examples/end-users/hearth-grain/) | `photography` | 226 | 100% | `dashboard`, `gradient` |
| [Millbrook](examples/end-users/millbrook-budget/) | `infographic` | 278 | 100% | `simulation`, `dashboard` |

<p align="center">
  <img src="https://raw.githubusercontent.com/Kayforkind/reimagine-it/main/docs/examples/end-users/venator/auto-desktop.png" width="280" alt="Venator Auto → signal-yellow gradient arena">
  <img src="https://raw.githubusercontent.com/Kayforkind/reimagine-it/main/docs/examples/end-users/crimson-circuit/auto-desktop.png" width="280" alt="Crimson Circuit Auto → magenta cinematic chapters">
  <img src="https://raw.githubusercontent.com/Kayforkind/reimagine-it/main/docs/examples/end-users/velocita/auto-desktop.png" width="280" alt="Velocita Auto → flame-orange artistic poster">
  <img src="https://raw.githubusercontent.com/Kayforkind/reimagine-it/main/docs/examples/end-users/maracuya/auto-desktop.png" width="280" alt="Maracuyá Auto → coral product landing">
  <img src="https://raw.githubusercontent.com/Kayforkind/reimagine-it/main/docs/examples/end-users/flick/auto-desktop.png" width="280" alt="Flick Fits Auto → electric-blue photography folio">
  <img src="https://raw.githubusercontent.com/Kayforkind/reimagine-it/main/docs/examples/end-users/meridian/auto-desktop.png" width="280" alt="Meridian Auto → amber 3D object">
  <img src="https://raw.githubusercontent.com/Kayforkind/reimagine-it/main/docs/examples/end-users/horizon/auto-desktop.png" width="280" alt="Horizon Auto → navy ops dashboard">
  <img src="https://raw.githubusercontent.com/Kayforkind/reimagine-it/main/docs/examples/end-users/hearth-grain/auto-desktop.png" width="280" alt="Hearth & Grain Auto → crust-brown bakery folio">
  <img src="https://raw.githubusercontent.com/Kayforkind/reimagine-it/main/docs/examples/end-users/millbrook-budget/auto-desktop.png" width="280" alt="Millbrook Auto → navy-and-brass budget infographic">
</p>

<p align="center"><sub>Auto desktops from the committed engine. Before/after composites and two alternatives live in each <a href="examples/end-users/">bundle</a>.</sub></p>

**Proven beyond the showcase** — [examples/public-sources/](examples/public-sources/) redesigns **six real public-domain pages** (National Park Service, NASA, NOAA/NWS, Census Bureau, Federal Register, Smithsonian) with no declared palette for the engine to lean on: Artemis II → `3js` orbit (100%), hurricane outlook → `landing` (100%), Yellowstone bulletin → `editorial` (84%), Census income brief → `infographic` (21/21 facts), FOIA rule → `simulation`, Apollo 11 → `simulation`. Community proofs in [examples/community/](examples/community/) cover jobs the journeys don't — a clinic bulletin → `infographic`, a fashion campaign → `lookbook`. Every artifact regenerates byte-identically in CI.

**One command, three furnished designs** — point `/reimagine-it` at a building page and it ships an orbitable 
````
