| name | design-review |
| description | Live design audit and polish workflow for Codex. Use when an implemented UI should be reviewed for visual quality, interaction quality, and consistency. |
Design Review
Use this skill when a real interface exists and the task is to audit or improve its visual and interaction quality.
This port is adapted from garrytan/gstack at commit 4d2c8d94d00cc4f4f3d4c26316a4f939ceedc045.
Workflow
- Resolve the target to a stable file, route, component, or URL. Load the project design context and representative source.
- Run an unanchored visual and interaction pass before reading deterministic findings.
- Inspect the implemented UI using the best available evidence path:
- browser testing
- screenshots
- local rendering
- source review when visual verification is limited
- Run the optional Impeccable detector through
design-quality when it is already installed. Record rule IDs, false positives, and skipped evidence paths.
- Identify the highest-value design issues:
- hierarchy
- spacing
- readability
- consistency
- responsiveness
- motion or feedback
- Tag findings P0 to P3 and separate aesthetic judgment from deterministic or accessibility evidence.
- Fix the most important issues directly in code when the user wants changes.
- Re-check the result and summarize what improved and what is still unverified.
- When persistence is useful and authorized, save the review under
reports/design-reviews/ and compare it with the latest report for the same target.
Guardrails
- Preserve the existing design system when one already exists.
- Do not introduce generic AI-slop styling.
- Be explicit when you could only review source code and not the live UI.
- If the user wants critique only, report issues without making fixes.
- Use independent subagents only when the user has authorized delegation; otherwise run the evidence passes sequentially and state the method.
Outputs
Always include:
- what was reviewed
- top design issues
- fixes made or recommended
- verification path used
- detector status and justified exceptions
- remaining blind spots
