frontend-design-review

Review and visually QA web interfaces against numeric design laws with rendered screenshot evidence.

123|10|Updated May 24, 2026
One-click install
npx skills add https://github.com/JasonColapietro/suede-creator-skills --skill frontend-design-review-jasoncolapietro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: frontend-design-review
Source: https://github.com/JasonColapietro/suede-creator-skills/tree/main/vendorable/frontend-design-review
Command: npx skills add https://github.com/JasonColapietro/suede-creator-skills --skill frontend-design-review-jasoncolapietro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, and includes references (resource) components.

What problem does it solve? AI-generated and hastily built interfaces often compile correctly but render as generic, category-average designs with decorative color, card-in-card nesting, and placeholder metrics. This Skill replaces subjective taste with explicit design contracts, numeric thresholds, banned-default lists, and a render-and-compare loop so visual quality is verified from screenshots rather than assumed from code. ## Core Features & Use Cases - Design contract and aesthetic direction: Lock audience, surface job, color roles, type roles, and one of eight named tonal directions before writing CSS. - Numeric design laws and scoped bans: Apply contrast floors, fluid type scales with clamp(), dark-mode surface rules, and component laws for forms, modals, tables, and navigation, with named replacements for banned patterns like gradient text and ghost cards. - Rendered visual QA: Capture desktop (1280x900) and mobile (390x844) screenshots via Playwright, compare mocks against implementations, and write a visual-qa-report.md with P0-P3 findings. - Design system scoring and ship gate: Score systems out of 100 across ten dimensions and end with a ship, ship-with-caveats, or hold verdict backed by evidence. - Use Case: Ask for a review of a dashboard at a local URL; receive a diagnosis naming exact files and lines, a committed redesign direction, rendered screenshots at both breakpoints, and a ship gate verdict. ## Quick Start Review the design of the page at http://localhost:3000 and tell me what is wrong with it, rendering it at desktop and mobile sizes before answering.

Frequently Asked Questions about frontend-design-review

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

FAQPage Schema
How do I review the design of a web page with an AI agent?

Point the agent at a repo, local URL, or screenshot and ask for a design review with rendered evidence. The skill inspects the source, captures desktop and mobile screenshots, checks the page against design laws and banned defaults, and reports findings with file names and specific fixes.

How to compare a Figma mock or screenshot against a built implementation?

Provide the mock image path and the implementation URL in one request. The skill compares both in the same visual pass and saves a visual-qa-report.md with findings ordered P0 to P3, ending in a passed or blocked result.

What tool captures the screenshots for visual QA?

Screenshots are captured with Playwright using npx playwright screenshot with viewport sizes 1280x900 for desktop and 390x844 for mobile. One-time setup requires running npx playwright install chromium.

Does the design review work for dark mode interfaces?

Yes, dark mode has dedicated rules covering surface lightness ranges, border-based elevation instead of shadows, 7:1 body text contrast minimums, and reduced chroma for saturated accents. Dark mode is treated as its own design, not an inversion of light mode.

When should I not use a frontend design review skill?

Skip it for backend-only work or one-line copy changes with no visual consequence. It is designed for surfaces with visual output such as landing pages, dashboards, component systems, and app store assets.

How is a design system audit scored?

The system is scored out of 100 across ten dimensions including color consistency, typography hierarchy, spacing rhythm, accessibility, and polish. Below 70 the system is considered failing, and the two lowest dimensions are fixed first.