design-review

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

2|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/westkite1201/garden-engine --skill design-review-westkite1201
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/westkite1201/garden-engine/tree/main/.claude/skills/gstack/design-review
Command: npx skills add https://github.com/westkite1201/garden-engine --skill design-review-westkite1201

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Visual inconsistencies, spacing problems, weak hierarchy, and generic AI-looking interfaces slip into production because manual design QA is slow and subjective. This Skill performs a structured designer-grade audit of a live site, then fixes each issue in source code with before/after screenshot verification. ## Core Features & Use Cases - Design Audit with Grades: Visits 5-8 pages, extracts the actual rendered design system (fonts, colors, heading scale, touch targets), and produces a report with letter grades and a first-impression critique. - Iterative Fix Loop: Fixes each finding in source code, commits atomically, and re-verifies with before/after screenshots. - Multiple Modes: 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 to catch undersized tap targets, inconsistent heading scales, and console errors, then have each issue fixed and committed automatically. ## Quick Start Ask the AI to run a design review on your local dev server URL and fix the 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 run a design review on my website?

Provide a target URL such as a localhost dev server or production site. The skill navigates pages, takes screenshots, extracts the rendered design system, and produces a graded audit report before fixing issues.

What does a visual design audit check for?

It checks font and color consistency, heading hierarchy, spacing patterns, touch target sizes under 44px, console errors, and performance. It also flags generic AI-looking interface patterns and deviations from your DESIGN.md.

Can I review only the pages changed in my feature branch?

Yes. When run on a feature branch without a URL, diff-aware mode analyzes the branch diff, maps changed files to affected routes, detects a running local app, and audits only those pages.

Does the design review require a clean git working tree?

Yes. Each design fix gets its own atomic commit, so uncommitted changes must be committed or stashed first. The skill prompts you to choose before proceeding.

What are the limitations of automated design review?

It evaluates rendered output against design heuristics and your DESIGN.md, but subjective brand judgment still benefits from human review. Authenticated pages require sign-in or imported cookies to audit.