Reviews a running app's user experience by walking through every screen (or command/endpoint surface) and writing severity-tagged findings to docs/UI-UX-REVIEW.md. Use when the user asks for a UI review, UX walkthrough, design QA, or a "does the app feel right" pass on a live app.
Installation
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Reviews a running app's user experience by walking through every screen (or command/endpoint surface) and writing severity-tagged findings to docs/UI-UX-REVIEW.md. Use when the user asks for a UI review, UX walkthrough, design QA, or a "does the app feel right" pass on a live app.
user-invocable
true
argument-hint
["app-path-or-description"]
UI/UX Review
Your task is to review the running app's user experience surface by surface and write docs/UI-UX-REVIEW.md in the target project.
Steps
Baseline — Establish and record the vantage point: profile/role, viewport, theme, locale, date. The review is a snapshot from a stated baseline, not a universal claim.
Access the app — Reuse the driver detection in e2e-testing's driving-tools reference if installed alongside; otherwise probe ToolSearch for a browser/device driver. No driver → paired mode: the user walks, shares screenshots and observations, you record.
Walk every surface — Follow references/review-rubric.md: global findings first, then one section per screen, each finding tagged 🔴/🟡/🔵. For CLI/API apps the rubric's adaptation table redefines "screen".
Sweep beyond the happy path — The rubric's checklist: both themes, narrow viewport, i18n leaks and diacritics, empty states, loading states, error states.
Record what works — A "What already works well (keep)" section is part of the doc: it protects good patterns from churn and keeps the review actionable.
Close with fix order — A short numbered list: severity first, cheap-and-visible next.
Boundaries
A functional bug found on the way (crash, data loss, logout trap) belongs in the e2e test plan — cross-reference it if one exists; otherwise record it here and suggest running e2e-testing.
Root causes in source belong to frontend-review; here record the observed symptom.