plan-design-review

Audit live sites for visual design issues and export DESIGN.md.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/shihwesley/shihwesleys-harness --skill plan-design-review-shihwesley
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-design-review
Source: https://github.com/shihwesley/shihwesleys-harness/tree/main/skills/gstack/plan-design-review
Command: npx skills add https://github.com/shihwesley/shihwesleys-harness --skill plan-design-review-shihwesley

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designer-led live-site audits surface visual inconsistencies, spacing issues, hierarchy problems, interaction feel gaps, AI slop patterns, typography issues, missed states, and slow-feeling interactions. It produces a prioritized design audit with annotated screenshots and letter grades. It can infer your design system and export as DESIGN.md. The workflow is report-only — never modifies code. For the fix loop, use /qa-design-review.

Core Features & Use Cases

  • Detect visual hierarchy, typography, spacing, and AI slop issues on live sites.
  • Infer or export a Design System baseline (DESIGN.md) for projects.
  • Generate a structured audit with annotated screenshots and letter grades for design critique.
  • Use in design-review workflows on live or staging sites to inform improvements without code changes.

Quick Start

Run a live-site design audit against your current page to generate the DESIGN.md baseline.

Frequently Asked Questions about plan-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 a live site?

A live-site design audit detects visual hierarchy, typography, spacing, and AI slop issues on your live or staging web app. It generates a prioritized design critique with annotated screenshots and letter grades without modifying any code.

Can I generate a design system baseline from an existing web app?

Yes, the design audit can infer your visual design rules from an existing web app and export them as a DESIGN.md file. This baseline captures your project's typography and spacing standards for future reference.

What is the best way to identify AI slop patterns on a staging site?

The best way to identify AI slop patterns on a staging site is to run a designer-led visual design audit. This process surfaces AI slop alongside visual inconsistencies and slow-feeling interactions, producing a structured report with letter grades.

Does the live-site design audit modify my codebase?

No, the live-site design audit is strictly report-only and never modifies your codebase. It produces a design critique with annotated screenshots to inform improvements, while the fix loop is handled separately via /qa-design-review.