Visual Audit
Purpose
Perform a structured visual design critique of an interface, producing specific actionable feedback on hierarchy, contrast, spacing, typography, color, and overall coherence.
Inputs
- Screenshots, mockups, or live implementation of the interface
- Design system or style guide (if it exists)
- Target context (marketing page, app dashboard, settings screen, etc.)
- Accessibility requirements (WCAG AA, AAA, or custom)
Process
Step 1: Squint Test
View the interface at arm's length (or blur it mentally). Identify:
- What's the loudest element? Is it the right one?
- Can you identify the primary action within 3 seconds?
- Is there a clear visual reading order?
- Are there any areas of visual "soup" (too much competing for attention)?
Step 2: Hierarchy Audit
Check the information hierarchy:
- Heading levels: Are there clear H1 → H2 → H3 distinctions via size and weight?
- Primary vs secondary actions: Is the primary action visually dominant (filled button) vs secondary (ghost/outline)?
- Content grouping: Are related items visually grouped (proximity) and distinct groups separated (spacing)?
- Emphasis distribution: Is anything fighting for attention that shouldn't be?
Step 3: Typography Audit
Check the type system:
- Scale consistency: Are font sizes from a defined scale (not arbitrary)?
- Line height: Is body text at 1.4-1.6x line height for readability?
- Measure: Are line lengths between 45-75 characters for body text?
- Weight usage: Is font weight used semantically (bold for emphasis, not decoration)?
- Font pairing: Are typefaces intentionally paired (one serif + one sans, or a single family)?
Step 4: Color and Contrast Audit
Check color usage:
- Contrast ratios: All text meets WCAG AA (4.5:1 normal text, 3:1 large text)
- Color meaning: Color is not the sole indicator of status (add icons, text, patterns)
- Palette coherence: Colors come from a defined palette, not ad-hoc hex values
- Dark mode: If supported, contrast ratios are verified in dark mode too
- Saturation balance: No oversaturated elements that vibrate or strain eyes
Step 5: Spacing and Alignment Audit
Check spatial consistency:
- Grid adherence: Elements align to a defined grid (4px, 8px base)
- Consistent spacing: Same-level items use the same spacing value
- Breathing room: Content doesn't feel cramped; whitespace is used intentionally
- Alignment lines: Elements that should align actually align (check left edges, baselines)
Step 6: Component Consistency Audit
Check for visual consistency:
- Button styles: All buttons of the same type look the same
- Card patterns: Cards share border radius, shadow, padding
- Icon style: Icons are from one set (outlined, filled, or mixed intentionally)
- Form elements: Inputs, selects, and textareas share a visual language
Output Format
# Visual Audit Report
## Overall Assessment
**Score:** [1-10]
**Summary:** [2-3 sentences on the interface's visual effectiveness]
## Squint Test Results
- **Primary focus:** [What draws the eye first — is this correct?]
- **Reading order:** [Clear / Unclear / Competing elements]
- **Visual noise:** [Low / Medium / High]
## Findings
### [CRITICAL] [Category] — [Finding]
**Current:** [What's happening now]
**Issue:** [Why it's a problem — cite specific principle]
**Fix:** [Specific change — exact values where possible]
### [IMPROVEMENT] [Category] — [Finding]
**Current:** [What's happening now]
**Suggestion:** [Specific improvement with rationale]
## Contrast Report
| Element | Foreground | Background | Ratio | Pass AA |
|---------|-----------|------------|-------|---------|
| Body text | #333 | #fff | 12.6:1 | Yes |
| Muted text | #999 | #fff | 2.8:1 | NO |
## Quick Wins
1. [Change that would have the biggest visual impact for the least effort]
2. [Second quick win]
3. [Third quick win]
Quality Checks
Evolution Notes
1---2name: visual-audit3department: "artisan"4description: "Structured visual design critique with specific actionable feedback"5version: 16triggers:7 - "visual"8 - "design review"9 - "UI audit"10 - "hierarchy"11 - "contrast"12 - "spacing"13 - "typography"14 - "color"15 - "layout"16---1718# Visual Audit1920## Purpose2122Perform a structured visual design critique of an interface, producing specific actionable feedback on hierarchy, contrast, spacing, typography, color, and overall coherence.2324## Inputs2526- Screenshots, mockups, or live implementation of the interface27- Design system or style guide (if it exists)28- Target context (marketing page, app dashboard, settings screen, etc.)29- Accessibility requirements (WCAG AA, AAA, or custom)3031## Process3233### Step 1: Squint Test3435View the interface at arm's length (or blur it mentally). Identify:36- What's the loudest element? Is it the right one?37- Can you identify the primary action within 3 seconds?38- Is there a clear visual reading order?39- Are there any areas of visual "soup" (too much competing for attention)?4041### Step 2: Hierarchy Audit4243Check the information hierarchy:44- **Heading levels:** Are there clear H1 → H2 → H3 distinctions via size and weight?45- **Primary vs secondary actions:** Is the primary action visually dominant (filled button) vs secondary (ghost/outline)?46- **Content grouping:** Are related items visually grouped (proximity) and distinct groups separated (spacing)?47- **Emphasis distribution:** Is anything fighting for attention that shouldn't be?4849### Step 3: Typography Audit5051Check the type system:52- **Scale consistency:** Are font sizes from a defined scale (not arbitrary)?53- **Line height:** Is body text at 1.4-1.6x line height for readability?54- **Measure:** Are line lengths between 45-75 characters for body text?55- **Weight usage:** Is font weight used semantically (bold for emphasis, not decoration)?56- **Font pairing:** Are typefaces intentionally paired (one serif + one sans, or a single family)?5758### Step 4: Color and Contrast Audit5960Check color usage:61- **Contrast ratios:** All text meets WCAG AA (4.5:1 normal text, 3:1 large text)62- **Color meaning:** Color is not the sole indicator of status (add icons, text, patterns)63- **Palette coherence:** Colors come from a defined palette, not ad-hoc hex values64- **Dark mode:** If supported, contrast ratios are verified in dark mode too65- **Saturation balance:** No oversaturated elements that vibrate or strain eyes6667### Step 5: Spacing and Alignment Audit6869Check spatial consistency:70- **Grid adherence:** Elements align to a defined grid (4px, 8px base)71- **Consistent spacing:** Same-level items use the same spacing value72- **Breathing room:** Content doesn't feel cramped; whitespace is used intentionally73- **Alignment lines:** Elements that should align actually align (check left edges, baselines)7475### Step 6: Component Consistency Audit7677Check for visual consistency:78- **Button styles:** All buttons of the same type look the same79- **Card patterns:** Cards share border radius, shadow, padding80- **Icon style:** Icons are from one set (outlined, filled, or mixed intentionally)81- **Form elements:** Inputs, selects, and textareas share a visual language8283## Output Format8485```markdown86# Visual Audit Report8788## Overall Assessment89**Score:** [1-10]90**Summary:** [2-3 sentences on the interface's visual effectiveness]9192## Squint Test Results93- **Primary focus:** [What draws the eye first — is this correct?]94- **Reading order:** [Clear / Unclear / Competing elements]95- **Visual noise:** [Low / Medium / High]9697## Findings9899### [CRITICAL] [Category] — [Finding]100**Current:** [What's happening now]101**Issue:** [Why it's a problem — cite specific principle]102**Fix:** [Specific change — exact values where possible]103104### [IMPROVEMENT] [Category] — [Finding]105**Current:** [What's happening now]106**Suggestion:** [Specific improvement with rationale]107108## Contrast Report109| Element | Foreground | Background | Ratio | Pass AA |110|---------|-----------|------------|-------|---------|111| Body text | #333 | #fff | 12.6:1 | Yes |112| Muted text | #999 | #fff | 2.8:1 | NO |113114## Quick Wins1151. [Change that would have the biggest visual impact for the least effort]1162. [Second quick win]1173. [Third quick win]118```119120## Quality Checks121122- [ ] Every finding includes a specific fix, not just a problem description123- [ ] Contrast ratios are calculated with actual color values124- [ ] Typography findings reference a type scale or specific sizes125- [ ] Spacing findings reference a grid system or specific values126- [ ] At least 3 quick wins are identified with effort-to-impact prioritization127- [ ] Dark mode contrast is checked if dark mode is supported128129## Evolution Notes130<!-- Observations appended after each use -->