# design-review

design-review is a Claude Code command that reviews a UI build for visual hierarchy and craft. It rates findings by severity and returns a verdict.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 88 repo stars
- Author: alexj11324
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/commands/interface-design/design-review.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/alexj11324-design-review

## What it does

The command reviews hierarchy, type and color, surface depth, composition, interface states, structure, and content. It first sets the scope and infers the interface’s intent, then looks at the whole result before examining each area separately.

The checks cover interactive states, accessibility, component reuse, and structural workarounds. If `.interface-design/system.md` exists, the command uses it to understand the design intent. When a rendering tool or screenshot is available, it examines the rendered UI; otherwise, it reads the layout as a whole before inspecting details.

By default, the command reports findings and a verdict without changing the project. It only rebuilds the UI when asked.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/design-review.md` — Call it with /design-review. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/design-review.md` — Call it with /prompts:design-review. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/design-review.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/design-review.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/commands/interface-design/design-review.md

## When to use it
- spot weak visual hierarchy in a UI build
- find missing states on interactive elements
- rank interface findings by severity
- detect hand-built controls and layout workarounds

## Example prompts
- Review the current UI build with `/interface-design:design-review` and return a verdict.
- Check the interface changes on this branch with `/interface-design:design-review`.
- Review the navigation component for hierarchy and interaction states using `/interface-design:design-review`.

## Similar
- [ui-design-review](https://affpapa.org/en/nevibecode/skills/ui-design-review.md) — skill · 1200 installs
- [review-design-parity](https://affpapa.org/en/nevibecode/commands/review-design-parity.md) — command · ★ 8052 repo stars
- [design-review-garrytan](https://affpapa.org/en/nevibecode/skills/design-review-garrytan.md) — skill · 221 installs
- [visual-hierarchy-reviewer](https://affpapa.org/en/nevibecode/skills/visual-hierarchy-reviewer.md) — skill · ★ 529 repo stars
- [flows-design-review](https://affpapa.org/en/nevibecode/skills/flows-design-review.md) — skill · 1100 installs
- [design-like-im-5](https://affpapa.org/en/nevibecode/skills/design-like-im-5.md) — skill · 306 installs

## Other versions with the same name
- [design-review · wshobson](https://affpapa.org/en/nevibecode/commands/design-review.md) — ★ 42780 repo stars

From the same set: [alexj11324/mikka](https://affpapa.org/en/nevibecode/by/alexj11324/mikka.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
