nextjs-design-audit

Audits Next.js interfaces for visual inconsistencies and fixes issues with atomic commits.

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/lucaszhh/agents --skill nextjs-design-audit-lucaszhh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nextjs-design-audit
Source: https://github.com/lucaszhh/agents/tree/main/skills/front/nextjs-design-audit
Command: npx skills add https://github.com/lucaszhh/agents --skill nextjs-design-audit-lucaszhh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After implementing UI changes, visual inconsistencies in spacing, typography, color, responsive behavior, and component states often slip through. This Skill performs a structured visual QA audit of the coded interface, scores it objectively against the project's design system, and fixes each issue iteratively with before/after evidence. ## Core Features & Use Cases - Tiered Visual Audits: Choose between quick (~5 min), standard (~15 min), or exhaustive (~30 min) audit levels covering spacing, typography, color, responsive layout, components, UI states, and accessibility. - Objective Scoring: Rates five categories (0-20 each) for a total 0-100 score with clear ship/no-ship thresholds. - Iterative Fix Loop: Documents each issue with severity and file location, applies a minimal fix, creates an atomic commit, and re-verifies with screenshots. - Use Case: After building a new dashboard page, ask for a visual QA pass. The Skill navigates key pages at mobile, tablet, and desktop breakpoints, finds an overflow issue and a missing error-state retry button, fixes both with atomic commits, and saves a full report to .agents/audits/. ## Quick Start Audit the design of the dashboard page and fix any visual inconsistencies you find.

Frequently Asked Questions about nextjs-design-audit

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

FAQPage Schema
How do I run a visual QA audit on a Next.js page?▼

Invoke the audit after implementing UI changes and specify the screen or scope. The Skill navigates key pages at mobile (375px), tablet (768px), and desktop breakpoints, checks a structured checklist, scores the result, and fixes each issue with an atomic commit.

What does the design audit checklist cover?▼

The checklist covers spacing consistency, typographic hierarchy, design system color palette and contrast ratios, responsive layout across three breakpoints, component state coverage (hover, focus, disabled), UI states (loading, empty, error), and accessibility basics like focus visibility and labels.

How is the visual audit score calculated?▼

Five categories are scored from 0 to 20 each: spacing, typography, color, layout/responsive, and components/states. The total ranges 0-100, where 60-84 is acceptable for merging and 85-100 is production-ready.

What happens if Playwright or pa11y is not installed?▼

The Skill degrades gracefully. If Playwright or the dev server is unavailable, issues are documented through static inspection of JSX and tokens without screenshots. If pa11y fails, accessibility is audited manually using the built-in checklist.

When should I not use a visual design audit?▼

Do not use it for functional bugs, which belong in a debug flow, or for designing interfaces from scratch, which belongs in a design craft step. It is strictly for QA and polish of already-implemented UI, without modifying business logic.