/ skills /design-review
Skill · Claude Code

design-review

See your live page beside real mockups, then approve what ships

Use it when You want to change how a page looks or is laid out and would rather pick from rendered options than read a description or get a redesign built blind.

Try it: paste this into Claude Code
Use the design-review skill to propose two or three layout options for the header and article cards on my /articles page.
23 featuresWorks on phone and desktopNothing ships until you approve it
Real work, before and after

See it work

Real pages, before and after a design-review round. They play on their own. Drag a slider to compare.

Before · live page
After · look A
Before · live pageAfter · look A
01

Retreat page hero

A pale boxed card becomes a full-bleed sunset hero.

design-review
Before
After · variant B
BeforeAfter · variant B
02

Bare date picker to a room-and-dates step

A bare date picker gains the room photo and a teal stay.

design-review
Before · plain links
After · report stacks
Before · plain linksAfter · report stacks
03

Plain report links to page stacks

Three plain links become fanned stacks of real report pages.

design-review
Before · v1Before · v1
After · flowersAfter · flowers
Plum themePlum theme
04

Text-only marketing flier to a photo card

A text-only card back becomes a wildflower-photo card.

design-review
Before · how it works
After · ranked bars
Before · how it worksAfter · ranked bars
05

Supplement test text to a ranked bar chart

A text section gains a ranked green-to-red bar chart.

design-review
Before · report table
After · range gauges
Before · report tableAfter · range gauges
06

Biofield measurement table to range gauges

A dense readings table becomes seven colored range gauges.

design-review
Before · Gantt list
After · two lanes
Before · Gantt listAfter · two lanes
07

Gantt list to a two-lane study plan

A long Gantt list becomes a two-lane timeline.

design-review
Before · numbers tableBefore · numbers table
After · ledgerAfter · ledger
Variant B · cardsVariant B · cards
08

Supplement table to dot chart

A dense table becomes a dot chart that flags good and bad.

design-review
Before · emoji cards
After · variant C
Before · emoji cardsAfter · variant C
09

Emoji device cards to line icons

Emoji cards become a dark band with line icons.

design-review
Before · list
After · cover wall
Before · listAfter · cover wall
10

Book list to a wall of covers

A text list becomes a wall of big book covers.

design-review
Before · readings table
After · bed maps
Before · readings tableAfter · bed maps
11

EMF readings table to bed heat maps

A table of readings becomes before-and-after bed heat maps.

design-review
Before · iPhoneBefore · iPhone
After · B (shipped)After · B (shipped)
Variant C · bannerVariant C · banner
12

Movie page layout fixes

A lonely cover becomes a header with the cover beside the title.

design-review

1What you see

01

Before Pictures

A real screenshot shows the page before the change

Each item opens with an actual screenshot of your page as it renders today, not a written description of it. You judge every proposal against what is really there.

02

See Your Options

Up to three working designs for each section

Each proposal is built as real HTML and CSS, not an AI image or a text diff, with one to three options per section. You see the actual layout, spacing and type, not an impression of them.

03

Your Look, Not Ours

Mockups use your site's own fonts, colors and spacing

Mockups are drawn with your page's real fonts, colors and spacing, with the fonts and images packed into the page so nothing falls back to a generic look. If your site has light and dark themes, mockups work in both.

04

The Words You Know

The Before shows your live text, not sample copy

When the text on your live site differs from your local copy, the live wording is pulled in before the screenshot is taken. The Before pane shows the page you know, not stale sample text.

05

One Piece at a Time

Every section is its own numbered item

Even a whole-page redesign is split into numbered items, one for each section or component. You can approve the header and send back the footer instead of taking or rejecting everything at once.

06

An Honest Opinion

Each item comes with a reason and a recommendation

Every item explains why the change is proposed and carries a Recommended or Not Recommended badge. Readability or accessibility concerns show up right there in the reason.

07

Phone and Desktop

Both screen sizes side by side, no toggling

Mockups can be shown in a fixed-width phone frame and a desktop frame next to each other. You check both sizes at a glance without toggling anything, and the review page itself never scrolls sideways.

08

What Needs You, First

Open decisions sit at the top of the page

Whatever still needs your call this round sits at the top of the page, above any recap or settled material. You never scroll past things you have already read to reach the next decision.

2How you decide

09

Pick a Favorite

Click an option to select it, marked with a border and a check

Clicking a mockup card selects it, marked with a border and a check rather than a colored fill, so the selection never covers up the design you are judging. The decision buttons then apply to whichever option is selected.

10

Four Clear Choices

Keep, use, approve with a comment, or ask for another try

Each item has Keep Original, Use Selected, Approve with Comment and Request Revision. They cover rejecting it, shipping it as shown, shipping it with changes, or asking for another try.

11

One Option, One Button

"Use Proposed" when there's only one design

When an item has only one mockup, the accept button reads Use Proposed instead of Use Selected. You don't hunt for a choice that doesn't exist or wonder whether your approval registered.

12

Say It in Words

A comment box opens when your words matter

Approve with Comment and Request Revision open a comment box for what to change or try instead. The other two buttons allow an optional note.

13

Status at a Glance

Every item shows where it stands

Each item shows its current state at a glance, from pending to accepted, commented, revise or kept original. You can scan the page and see what you have and haven't decided.

14

Done With It

A Mark as read switch drops an item from the next round

Each item has its own Mark as read switch, separate from the decision buttons. Items you have finished with are left out of the next round entirely.

15

Always Know Where You Are

A progress bar stays in view as you go

A bar pinned to the bottom of the page shows how many items you've reviewed and a count for each decision. You always know how far along you are.

3After you decide

16

One Paste Back

Copy My Decisions sends every choice to Claude

One button copies a plain-text summary of every decision, headed with the name of the page under review and listing the chosen option letter and any comments. You paste it into chat, and it can't be mixed up with another review in progress.

17

Only What You Approved

Nothing else on the page gets touched

Items you accept are built and nothing else is touched. Kept-original, revise and unreviewed items leave the page exactly as it is.

18

From Mockup to Real Page

Approved designs are rebuilt in your real templates and data

An approved mockup is rebuilt in your actual page template, wired to your real data and images instead of the sample content shown in the review. The finished page then gets the same checks as any other change.

19

Tested Before You See It

Every button is clicked before the page reaches you

Before each publish, the review page is loaded and clicked through automatically to confirm every button works, the export reads correctly, and no mockup overlaps or scrolls sideways. You don't get a page that looks fine but does nothing when clicked.

4Rounds

20

Just the Revisions

The next round brings back only what you sent back

The next round shows only the items you sent back, with new options shaped by your comments. It goes up at the same link, so the page you already have open just updates.

21

Compare With Last Time

The option you turned down stays, dimmed, for comparison

On a revised item, the option you turned down is carried forward, dimmed with a dashed border and labeled with its round. You can see what changed without it competing with the new choices.

22

Not Sure? Show Me a Few

A vague comment brings several real alternatives

You don't need to know what you want before you start. Ask for a revision with a vague comment and the next round brings several genuinely different options instead of one tweaked guess.

23

Where the Page Goes

A private link, a local file, or your Wi-Fi

Your project picks where review pages go: a private claude.ai link, an HTML file that opens in your browser, or that file served on your home Wi-Fi so a phone can open it. Nothing is ever uploaded or tunneled in the Wi-Fi mode, and the server stops when the review ends.