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.