reimagine-it-generate — Claude Code skill: HTML redesign engine
Reads an HTML page and rebuilds it in a new visual direction — landing, infographic, dashboard, or one of 17 others. Facts from the source stay; only the composition changes.
npx skills add Kayforkind/reimagine-it --skill generate -a claude-codeWhat reimagine-it-generate does
The engine parses headings, dates, numbers, links, and hex colors in the source HTML, derives a palette and motif from the content, then writes a new page. --auto mode picks the direction that fits the content best and prints the rationale. You can name a direction explicitly — infographic, landing, dashboard, or any of the 17 tokens — or generate multiple options with the variations command. The engine checks fidelity: the output must preserve ≥ 80% of source facts.
If the project has a brand, the lock command saves the palette and fonts to a .lock.json file, then --ref applies them to the new page. Run audit to verify the output before publishing. The engine invents no facts, statistics, or quotes — it only rearranges what was already in the HTML.
What it helps with
- turn a draft HTML page into a landing page
- build an infographic from a list of facts
- rebuild a page in a new format without losing data
- keep a brand style when redesigning
- generate multiple design options from one source
Example prompts for the agent
- Take
draft.htmland turn it into a landing page with--auto - Rebuild
report.htmlas an infographic:npx reimagine-it -i report.html -t infographic -o poster.html - Generate three design variants from
page.htmlintoreview/
How to install reimagine-it-generate
1Skills CLI (Vercel)
npx skills add Kayforkind/reimagine-it --skill generate -a claude-code2Manually: put the files in place
~/.claude/skills/generate/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/generate/
1Skills CLI (Vercel)
npx skills add Kayforkind/reimagine-it --skill generate -a codex2Manually: put the files in place
.agents/skills/generate/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Kayforkind/reimagine-it --skill generate -a cursor2Manually: put the files in place
.cursor/skills/generate/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Kayforkind/reimagine-it generate2Manually: put the files in place
.github/skills/generate/SKILL.md1Skills CLI (Vercel)
npx skills add Kayforkind/reimagine-it --skill generate -a gemini-cli2Platform CLI
gemini skills install https://github.com/Kayforkind/reimagine-it --path skills/reimagine-it/generateManually: put the files in place
.devin/skills/generate/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Kayforkind/reimagine-it --skill generate -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about reimagine-it-generate
How to install reimagine-it-generate in Claude Code?
Run npx skills add Kayforkind/reimagine-it --skill generate -a claude-code, the skill file will land in ~/.claude/skills/generate/SKILL.md.
What does reimagine-it-generate do?
Reads HTML, extracts facts, dates, numbers, and colors, then builds a new page in one of 17 visual directions — from landing to dashboard. Content stays, composition changes.
How do I pick a design direction?
Run --auto to let the engine choose the direction that fits the content, or name a token: infographic, landing, dashboard, cinematic, or any of the 17. The full list is in npx reimagine-it --list.
Source text
SKILL.md · MIT
---
name: reimagine-it-generate
description: >-
Generate one Content-Derived Design direction from an HTML source, or let
Auto choose the strongest direction. Use when the user says /reimagine-it
generate, "redesign this page", "make it a landing page", "turn this into
an infographic", names a token (all 17: webpage, infographic, svg, 3js,
simulation, artistic, cinematic, dashboard, photography, landing, editorial,
gradient, showcase, motion, glass, lookbook, particles),
or wants a
content-aware redesign instead of a mood board. CLI: npx reimagine-it --auto
-i page.html -o out.html. Part of the reimagine-it Content-Derived Design suite.
license: MIT
metadata:
author: Kayforkind
version: "2.15.0"
parent: reimagine-it
hosts:
- claude-code
- cursor
- codex
- copilot
- gemini-cli
keywords:
- redesign
- landing-page
- infographic
- design-generation
- content-derived-design
- html
category: Design
capabilities:
- content-derived-redesign
- auto-direction-choice
- seeded-variation
- brand-locking
trigger_phrases:
- /reimagine-it
- redesign this page
- reimagine it
- make it a landing page
- turn this into an infographic
- generate a design from this HTML
---
# /reimagine-it generate
**Parent:** [../SKILL.md](../SKILL.md) — the full Content-Derived Design engine. This sub-skill handles only generation of a redesigned page.
The source file is the brief. The engine reads headings, facts, names, dates,
numbers, links, emails, and hex colors already in the HTML, derives a palette
and motif from them, and writes a stronger standalone page. Source facts are
not invented; only the composition changes.
## Usage
```bash
# Let Auto choose, generate, verify, and explain (recommended first call)
npx reimagine-it --auto -i page.html -o redesign.html
# Pick a direction
npx reimagine-it -i page.html -t infographic -o poster.html
# Pin a creative variation
npx reimagine-it -i page.html -t landing --seed 42 -o landing.html
# Review three verified directions plus a contrast sheet
npx reimagine-it variations -i page.html -n 3 -o review/
# Keep an existing brand: lock, then reuse
npx reimagine-it lock -i house-style.html -o house.lock.json
npx reimagine-it -i page.html --ref house.lock.json -t landing -o on-brand.html
```
## The 17 tokens
webpage · infographic · svg · 3js · simulation · artistic · cinematic ·
dashboard · photography · landing · editorial · gradient · showcase · motion ·
glass · lookbook (photoshoots/collections) · particles (living networks)
`npx reimagine-it --list` describes each. **Auto** scores every lane against
the content and forbids the same silhouette twice.
## Procedure
1. Run Auto first (`--auto`). Read the printed rationale — it names why the
direction fits the content.
2. Check the fidelity line: the engine reports the percentage of detected
source facts preserved. It must be ≥ 80%.
3. Offer `variations` when the user wants choice; offer `--ref` when they
want an existing brand honored.
4. If the user names a token, run it directly — Auto is a default, not a gate.
## Must not
- Invent facts, statistics, or quotes not in the source
- Override the derived palette with generic colors (ban Inter/Roboto is the
*only* taste rule; content decides the rest)
- Ship without the fidelity check passing
- Skip verification when the output replaces a real page (run `audit`)
Part of [reimagine-it](https://github.com/Kayforkind/reimagine-it) — MIT.
© Kayforkind · MIT · Kayforkind/reimagine-it