Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Kayforkind/reimagine-it --skill variations -a claude-code
Open on GitHub

What 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 variations on page.html and save the review in review/.
  • Create 4 distinct design directions from page.html and place them side by side.
  • Regenerate the same set from page.html with seed 42.

How to install reimagine-it-variations

1Skills CLI (Vercel)

npx skills add Kayforkind/reimagine-it --skill variations -a claude-code

2Manually: put the files in place

~/.claude/skills/variations/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/variations/

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

Similar skills

Everything for Design →

From the same set7

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor