design-review

Audits live websites for visual design issues and fixes them with atomic commits.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/dhnpmp-tech/project-agent --skill design-review-dhnpmp-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/dhnpmp-tech/project-agent/tree/main/.claude/skills/gstack/design-review
Command: npx skills add https://github.com/dhnpmp-tech/project-agent --skill design-review-dhnpmp-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Live websites often ship with visual inconsistencies, spacing problems, broken hierarchy, and generic AI-looking interfaces that nobody systematically reviews. This Skill acts as a designer's eye: it audits rendered pages with screenshots, finds concrete design defects, fixes them in source code, and verifies each fix with before/after screenshots. ## Core Features & Use Cases - Structured Design Audit: Runs a multi-phase review covering first impression, design system extraction (fonts, colors, heading scale, touch targets), page-by-page visual audit, responsive screenshots, console errors, and performance checks. - Iterative Fix-and-Verify Loop: Fixes each identified issue in source code, commits atomically, and re-verifies with before/after screenshots so every change is traceable. - Flexible Modes: Supports full, quick, deep, diff-aware (feature-branch scoped), and regression modes that compare against a previous design baseline. - Use Case: Before launching a marketing site, run a deep audit across 10-15 pages to catch undersized buttons, inconsistent heading scales, and slow interactions, then let the Skill fix and commit each issue. ## Quick Start Ask the AI to run a design review on your site, for example: audit the design of http://localhost:3000 and fix any visual issues it finds.

Frequently Asked Questions about design-review

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

FAQPage Schema
How do I audit the visual design of a live website?

Point the design review at a target URL and it navigates pages, captures full-page and responsive screenshots, extracts the rendered design system (fonts, colors, heading scale), and produces a graded audit report. It then fixes found issues in source code with atomic commits.

What design issues does a visual QA audit detect?

The audit detects visual inconsistency, spacing problems, hierarchy issues, undersized touch targets below 44px, excessive font or color counts, console errors, and slow interactions. It also flags generic AI-looking interface patterns.

Can I run a design review only on pages changed in my branch?

Yes. When invoked on a feature branch without a URL, diff-aware mode analyzes the branch diff, maps changed files to affected routes, detects a locally running app on common ports, and audits only the impacted pages.

Does the design review require a clean git working tree?

Yes. The Skill stops if uncommitted changes exist because each design fix gets its own atomic commit. You are asked to commit or stash your changes before the review begins.

What is the difference between quick, full, and deep design review modes?

Quick mode covers the homepage plus two key pages for a fast score. Full mode reviews 5-8 pages with the complete checklist. Deep mode covers 10-15 pages with every interaction flow, suited for pre-launch audits.