reimagine-it-variations — Claude Code skill: what it does, install
This skill turns one HTML source into several design directions and a side-by-side contrast sheet. Use it before choosing a visual direction.
npx skills add Kayforkind/reimagine-it --skill variations -a claude-codeWhat reimagine-it-variations does
The skill takes a single HTML page and produces 2–8 standalone directions. Each one gets its own HTML file, while index.html places the set side by side for review. The variations.json report records the rank, token, seed, voice, fit, quality, and fidelity for every direction.
Set the count with -n; the procedure starts with -n 3 when the request gives no count. A saved seed rebuilds the same set, and --ref house.lock.json supplies a house reference for an on-brand pass. The seed is required for reproducibility. A direction with fidelity below 80% must not be presented as a selectable option.
What it helps with
- explore several visual directions from one HTML page
- compare every direction in a side-by-side sheet
- save each design as a standalone HTML page
- rank directions using quality and fidelity
- rebuild a reviewed set from its seed
Example prompts for the agent
- Run
/reimagine-it variationsonpage.htmland save the review inreview/. - Create 4 distinct design directions from
page.htmland place them side by side. - Regenerate the same set from
page.htmlwith seed42.
How to install reimagine-it-variations
1Skills CLI (Vercel)
npx skills add Kayforkind/reimagine-it --skill variations -a claude-code2Manually: put the files in place
~/.claude/skills/variations/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/variations/
1Skills CLI (Vercel)
npx skills add Kayforkind/reimagine-it --skill variations -a codex2Manually: put the files in place
.agents/skills/variations/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Kayforkind/reimagine-it --skill variations -a cursor2Manually: put the files in place
.cursor/skills/variations/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Kayforkind/reimagine-it variations2Manually: put the files in place
.github/skills/variations/SKILL.md1Skills CLI (Vercel)
npx skills add Kayforkind/reimagine-it --skill variations -a gemini-cli2Platform CLI
gemini skills install https://github.com/Kayforkind/reimagine-it --path skills/reimagine-it/variationsManually: put the files in place
.devin/skills/variations/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Kayforkind/reimagine-it --skill variations -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-variations
How do I install reimagine-it-variations in Claude Code?
Run npx skills add Kayforkind/reimagine-it --skill variations -a claude-code, then open ~/.claude/skills/variations/SKILL.md.
What does reimagine-it-variations do?
It creates 2–8 design directions from one HTML source, saves each direction as a separate page, and builds index.html for side-by-side review. The variations.json file reports the ranking and review data.
Can I reproduce the same design set?
Yes. Keep the seed and pass it with --seed, for example npx reimagine-it variations -i page.html -n 4 --seed 42 -o review/. One seed reproduces the full set.
Source text
SKILL.md · MIT
---
name: reimagine-it-variations
description: >-
Generate several distinct design directions from one HTML source plus a
contrast sheet that shows every direction side by side. Use when the user
says /reimagine-it variations, "show me options", "give me three takes",
"which direction works best", or wants to compare design directions before
choosing one. CLI: npx reimagine-it variations -i page.html -n 4 -o review/.
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:
- design-variations
- design-exploration
- contrast-sheet
- direction-review
- content-derived-design
category: Design
capabilities:
- multi-direction-generation
- contrast-sheet-review
- seeded-reproduction
trigger_phrases:
- /reimagine-it variations
- show me design options
- give me three takes
- compare design directions
- which direction works best
---
# /reimagine-it variations
**Parent:** [../SKILL.md](../SKILL.md) — the full Content-Derived Design engine. This sub-skill handles only multi-direction exploration.
Generates 2–8 distinct directions from one source plus an `index.html`
contrast sheet that lays them out side by side with per-direction quality,
fidelity, and voice. One seed reproduces the whole set.
## Usage
```bash
npx reimagine-it variations -i page.html -n 4 -o review/
npx reimagine-it variations -i page.html -n 4 --seed 42 -o review/ # reproducible
npx reimagine-it variations -i page.html -n 4 --ref house.lock.json # on-brand
```
Output per run:
| File | What it is |
|------|-----------|
| `variation-1-<token>.html` … | One standalone page per direction |
| `index.html` | Contrast sheet: all directions side by side |
| `variations.json` | Ranked report: token, seed, voice, fit, quality, fidelity |
## Procedure
1. Run with `-n 3` unless the user asked for a different count.
2. Read `variations.json` back to the user: rank, token, quality, fidelity.
3. Name the *structural* difference between the top two — not just the colors.
4. Print the seed and tell the user how to reproduce the set.
5. Once a direction is chosen, generate it standalone with
`npx reimagine-it -i page.html -t <token> --seed <seed>`.
## Must not
- Present variations as options when fidelity is below 80% for any of them
- Describe two variations as different if they share a silhouette
- Lose the seed — the set is only reviewable if it is reproducible
- Skip the contrast sheet; side-by-side comparison is the point
Part of [reimagine-it](https://github.com/Kayforkind/reimagine-it) — MIT.
© Kayforkind · MIT · Kayforkind/reimagine-it