design-review

Audits live websites for visual inconsistencies and fixes issues in source code with atomic commits.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill design-review-lgj-jonathan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/gstack/design-review
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill design-review-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Live sites accumulate visual debt: inconsistent spacing, broken hierarchy, AI-slop patterns, and slow interactions that nobody catches until users complain. This Skill acts as a designer's eye QA loop, finding those issues on a running site and fixing them directly in source code with before/after screenshot verification. ## Core Features & Use Cases - Visual audit of live sites: Crawls pages via a headless browse binary, detecting spacing issues, hierarchy problems, typography inconsistencies, and AI-generated-looking patterns, calibrated against your repo's DESIGN.md if one exists. - Iterative fix-and-verify loop: Fixes each issue in source code, commits atomically, and re-verifies with before/after screenshots so every change is provable. - Diff-aware mode: On a feature branch with no URL given, reviews only the pages your branch changed. - Use Case: You just shipped a new settings page and something feels off. Run the design review against localhost:3000, and it flags the misaligned form labels and inconsistent card padding, fixes them, and shows you screenshots proving the improvement. ## Quick Start Ask the AI to run a design review on your local dev server at 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 run a visual design audit on my website?

Point the design review at a URL like http://localhost:3000 or a deployed site. It crawls 5-8 pages by default, flags spacing, hierarchy, and typography issues, then fixes each one in source code with an atomic commit and before/after screenshots.

How to review only the pages changed in my feature branch?

Run the design review on a feature branch without providing a URL. It automatically enters diff-aware mode and audits only the pages affected by your branch's changes instead of the whole site.

Does the design review work with authenticated pages?

Yes. You can sign in as a test user or import cookies. If the browse tool is connected to your real browser via CDP mode, it reuses your existing session and skips cookie import entirely.

Why does the design review require a clean git working tree?

Each design fix gets its own atomic commit, so uncommitted changes would get mixed in. If your tree is dirty, it asks you to commit or stash your changes before starting the audit.

Can I use a custom design system with the design review?

Yes. Place a DESIGN.md or design-system.md in your repo root and the review calibrates all judgments against it, treating deviations from your stated system as higher severity. Without one, it uses universal design principles.