ui-design-review

Review rendered frontend UI for design quality, accessibility, and responsiveness.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/toderian/project_template --skill ui-design-review-toderian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ui-design-review
Source: https://github.com/toderian/project_template/tree/main/plugins/agents-extras/skills/ui-design-review
Command: npx skills add https://github.com/toderian/project_template --skill ui-design-review-toderian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After building or modifying a frontend surface, it is hard to systematically catch visual regressions, accessibility gaps, broken responsive layouts, and missing interaction states before users do. This Skill provides a structured review process that inspects the rendered application in the browser rather than relying on code reading alone. ## Core Features & Use Cases - Visual Evidence Capture: Runs the app and captures screenshots at desktop (1280px), tablet (768px), and mobile (375px) widths, plus key interaction states, stored under .local/artifacts/. - Structured Review Checklist: Covers visual hierarchy, layout and responsiveness, accessibility and keyboard interaction, design-system consistency, content states, and performance-sensitive UI patterns. - Severity-Ranked Reporting: Reports findings as Must fix, Should fix, or Could improve, each with code paths, screenshot references, and concrete fix directions. - Use Case: After implementing a new settings page, ask for a UI review to get screenshots across breakpoints, an audit of form error and loading states, and a prioritized list of issues such as missing focus indicators or mobile overflow. ## Quick Start Review the UI of the page I just built and give me a prioritized list of design, accessibility, and responsiveness issues with screenshots.

Frequently Asked Questions about ui-design-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a frontend UI for accessibility issues?

Run the app and inspect interactive elements for semantic HTML, keyboard accessibility, visible focus states, and accessible names on icon-only controls. Also verify forms have labels, error, loading, and success states, and that motion respects reduced-motion preferences.

How to do a responsive design audit of a web page?

Capture screenshots at desktop around 1280px, tablet around 768px, and mobile around 375px widths. Check for clipping, horizontal overflow, overlapping controls, and whether fixed, sticky, modal, and sidebar elements work correctly on mobile.

What tool should I use to capture UI screenshots for review?

Use the available browser tool first; if none is available, use Playwright or the repository's existing e2e/screenshot flow. Store temporary screenshots under .local/artifacts/<review-slug>/screenshots/ with descriptive filenames per viewport and state.

Can a UI review be done if the app cannot run locally?

Yes, but with lower confidence. State the blocker clearly and perform a code-only review of the component, page, and style files, checking component reuse, semantic HTML, responsive strategy, and state coverage without visual evidence.

Should review screenshots be committed to the repository?

No, screenshots go under the ignored .local/ directory by default. If a durable report is requested, write Markdown to docs/resources/_reports/ui-design-review/ and only commit screenshots when listed in artifacts/README.md following the repo's artifact convention.