design-review

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

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/TarunTeja44/portfolio --skill design-review-tarunteja44
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/TarunTeja44/portfolio/tree/main/.agents/skills/gstack-design-review
Command: npx skills add https://github.com/TarunTeja44/portfolio --skill design-review-tarunteja44

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually reviewing a website for visual inconsistencies, spacing problems, weak typography, and accessibility issues is slow and subjective. This Skill performs a systematic designer-grade audit of a live site, then fixes the issues it finds directly in source code, committing each fix atomically and verifying with before/after screenshots. ## Core Features & Use Cases - Structured Design Audit: Evaluates pages against a 10-category, ~80-item checklist covering visual hierarchy, typography, color contrast, spacing, and interaction quality, producing a graded report. - Iterative Fix-and-Verify Loop: Fixes identified issues in source code one at a time, commits each fix atomically, and re-verifies with before/after screenshots. - Multiple Review 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 design review to catch undersized touch targets, inconsistent heading scales, and WCAG contrast failures, then have each issue fixed and committed automatically. ## Quick Start Ask the AI to run a design review on your local dev site 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 design review on my website?

Provide a target URL or run it on a feature branch with no URL to enter diff-aware mode. The skill navigates the site, screenshots pages, evaluates a 10-category design checklist, and produces a graded audit report before fixing issues.

What design issues does a visual QA audit check for?

The audit checks roughly 80 items across 10 categories including visual hierarchy, typography scale and line-height, WCAG color contrast, spacing consistency, touch target sizes, and generic AI-looking patterns. Each finding gets an impact rating of high, medium, or polish.

Can design review run on a site that requires login?

Yes. When the skill detects a redirect to a login, signin, auth, or SSO path, it pauses and asks whether you want to import browser cookies first using the setup-browser-cookies flow.

Does design review work on feature branches?

Yes. On a feature branch with no URL given, it automatically enters diff-aware mode: it analyzes the branch diff, maps changed files to affected pages, detects a locally running app, and audits only the impacted pages.

Why does design review require a clean git working tree?

Each design fix is committed atomically so changes can be reviewed and reverted individually. A dirty tree would mix your uncommitted work with automated fix commits, so the skill asks you to commit or stash before starting.

What are the limitations of automated design review?

It evaluates rendered pages through screenshots and computed styles, so it cannot judge brand strategy, content quality, or subjective aesthetic direction. It also requires the browse binary to be built and a reachable target URL.