AI skill for automated UI audits. Evaluate interfaces against proven UX principles for visual hierarchy, accessibility, cognitive load, navigation, and more. Based on Making UX Decisions by Tommy Geoco.
AI skill for automated UI audits. Evaluate interfaces against proven UX principles for visual hierarchy, accessibility, cognitive load, navigation, and more. Based on Making UX Decisions by Tommy Geoco.
UI Audit Skill
Evaluate interfaces against proven UX principles. Based on Making UX Decisions by Tommy Geoco.
When to Use This Skill
Making UI/UX design decisions under time pressure
Evaluating design trade-offs with business context
Choosing appropriate UI patterns for specific problems
Reviewing designs for completeness and quality
Structuring design thinking for new interfaces
Core Philosophy
Speed ≠ Recklessness. Designing quickly is not automatically reckless. Recklessly designing quickly is reckless. The difference is intentionality.
The 3 Pillars of Warp-Speed Decisioning
Scaffolding — Rules you use to automate recurring decisions
Decisioning — Process you use for making new decisions
Crafting — Checklists you use for executing decisions
references/31-patterns-navigation.md — Priority nav, off-canvas, sticky, bottom nav
Usage Instructions
For Design Decisions
Read 00-core-framework.md for the decisioning workflow
Identify if this is a recurring decision (use scaffold) or new decision (use process)
Apply the 3-step weighing: institutional knowledge → user familiarity → research
For New Interfaces
Follow the 6-step checklist in 10-checklist-new-interfaces.md
Reference relevant pattern files for specific UI components
Use fidelity and visual style checklists to enhance quality
For Pattern Selection
Identify the core problem (chunking, disclosure, cognitive load, etc.)
Load the relevant pattern reference
Evaluate benefits, use cases, psychological principles, and implementation guidelines
Decision Workflow Summary
When facing a UI decision:
1. WEIGH INFORMATION
├─ What does institutional knowledge say? (existing patterns, brand, tech constraints)
├─ What are users familiar with? (conventions, competitor patterns)
└─ What does research say? (user testing, analytics, studies)
2. NARROW OPTIONS
├─ Eliminate what conflicts with constraints
├─ Prioritize what aligns with macro bets
└─ Choose based on JTBD support
3. EXECUTE
└─ Apply relevant checklist + patterns
Macro Bet Categories
Companies win through one or more of:
Bet
Description
Design Implication
Velocity
Features to market faster
Reuse patterns, find metaphors in other markets
Efficiency
Manage waste better
Design systems, reduce WIP
Accuracy
Be right more often
Stronger research, instrumentation
Innovation
Discover untapped potential
Novel patterns, cross-domain inspiration
Always align micro design bets with company macro bets.
Key Principle: Good Design Decisions Are Relative
A design decision is "good" when it:
Supports the product's jobs-to-be-done
Aligns with company macro bets
Respects constraints (time, tech, team)
Balances user familiarity with differentiation needs
There is no universally correct UI solution—only contextually appropriate ones.
Generating Audit Reports
When asked to audit a design, generate a comprehensive report. Always include these sections:
Required Sections (always include)
Visual Hierarchy — Headings, CTAs, grouping, reading flow, type scale, color hierarchy, whitespace
Visual Style — Spacing consistency, color usage, elevation/depth, typography, motion/animation
Onboarding — For new user experiences: first-run, tutorials, progressive disclosure
Social Proof — For landing/marketing pages: testimonials, trust signals, social integration
Forms — For data entry: labels, validation, error messages, field types
Audit Output Format
{"title":"Design Name — Screen/Flow","project":"Project Name","date":"YYYY-MM-DD","figma_url":"optional","screenshot_url":"optional - URL to screenshot","macro_bets":[{"category":"velocity|efficiency|accuracy|innovation","description":"...","alignment":"strong|moderate|weak"}],"jtbd":[{"user":"User Type","situation":"context without 'When'","motivation":"goal without 'I want to'","outcome":"benefit without 'so I can'"}],"visual_hierarchy":{"title":"Visual Hierarchy","checks":[{"label":"Check name","status":"pass|warn|fail|na","notes":"Details"}]},"visual_style":{ ... },"accessibility":{ ... },"priority_fixes":[{"rank":1,"title":"Fix title","description":"What and why","framework_reference":"XX-filename.md → Section Name"}],"notes":"Optional overall observations"}
Checks Per Section (aim for 6-10 each)
Visual Hierarchy: heading distinction, primary action clarity, grouping/proximity, reading flow, type scale, color hierarchy, whitespace usage, visual weight balance