design-review

Audit UI pages, components, and breakpoints against a design-review checklist.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/shaneholloman/ship --skill design-review-shaneholloman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-review
Source: https://github.com/shaneholloman/ship/tree/main/design-review
Command: npx skills add https://github.com/shaneholloman/ship --skill design-review-shaneholloman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designer and developer teams often struggle to identify visual inconsistencies, spacing issues, and AI-generated slop in their UI. This Skill provides a structured, repeatable Design Audit process that surfaces defects and guides fixes across a live project.

Core Features & Use Cases

  • Phase-based design audit: First Impressions, Design System Extraction, Page-by-Page Audit, Interactions, Cross-Page Consistency, and a unified report.
  • Diff-aware scope: When on a feature branch, Audits only pages affected by code changes to preserve time and focus.
  • Baseline & reporting: Generates annotated screenshots, a design-audit report, and a suggested design-system baseline to lock in decisions.
  • Workflow integration: Works with existing repos and design docs to calibrate decisions against project standards.

Quick Start

Run the design-review workflow on your target project to begin a full design audit.

Frequently Asked Questions about design-review

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

FAQPage Schema
What is a UI design audit and how does it fix visual inconsistencies?▼

A UI design audit systematically reviews pages, components, and breakpoints against a checklist to surface visual and interaction inconsistencies. This process produces an actionable report with annotated screenshots to guide fixes and establish a cohesive design baseline.

How do I run a design review on my live project repository?▼

To run a design review, provide a linked design system reference and access to your target URL or repository pages. The workflow executes phased audits from first impressions to cross-page consistency, ultimately generating a final design-audit report.

Can I audit only the UI components affected by my feature branch changes?▼

Yes, the design audit supports diff-aware scope. When running on a feature branch, it automatically audits only the pages and components affected by code changes, preserving time and focus while still generating a full design-audit report.

Does a UI audit require an existing design system to function?▼

Yes, a linked design system reference is a required input to calibrate decisions against project standards. However, the audit can also extract a suggested design-system baseline during the process to help lock in future decisions.

What's the best way to identify spacing issues and AI-generated UI slop?▼

The best way to identify spacing issues and AI-generated UI slop is a structured design audit. It applies a comprehensive review checklist across pages and breakpoints, extracting style findings and generating annotated screenshots for actionable fixes.

What limitations exist when auditing responsive breakpoints across pages?▼

Limitations include the need for accessible target URLs or repository pages to generate screenshots. The audit scope is bounded by the provided design system reference, and diff-aware mode restricts reviews to only feature branch code changes.