design-review · alexj11324 — Claude Code command for UI 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.
AGPL-3.0 ★ 88 updated 2026-11-17
.claude/commands/design-review.mdWhat design-review 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.
What it helps with
- 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 for the agent
- Review the current UI build with
/interface-design:design-reviewand 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.
How to install design-review
Manually: put the files in place
.claude/commands/design-review.mdCall it with /design-review. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/design-review.mdCall it with /prompts:design-review. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/design-review.prompt.mdManually: put the files in place
.gemini/commands/design-review.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about design-review
How do I install design-review in Claude Code?
Create .claude/commands/design-review.md and add the command contents to that file.
What does design-review do?
It reviews a UI build across design concerns, assigns severity to findings, and returns a verdict. It does not change the project unless asked.
What does design-review examine?
It covers hierarchy, typography and color, surfaces, composition, interface states, structure, and content.
Similar slash commands
All slash commands for Design →design-review by other authors comes first.