tommygeoco/ui-audit

AI skill for automated UI audits
Evaluate interfaces against proven UX principles.

What is this?

A skill that gives AI assistants the ability to perform structured UI audits. Based on Making UX Decisions by Tommy Geoco.

Audits include:

Visual hierarchy & typography
Visual style & spacing
Accessibility & contrast
Navigation & wayfinding
Cognitive load & information architecture
Social proof & trust signals
Onboarding & empty states

Installation

# Agent Skills (Vercel)
npx skills add uxtools/ui-audit

# ClawdHub
clawdhub install ui-audit

# npm
npm install ui-audit

Usage

Ask your AI assistant:

Audit this design: [figma-url]
Review this landing page for accessibility issues
What visual hierarchy patterns should I use for a pricing page?

What's Included

ui-audit/
├── SKILL.md                    # Main skill instructions
├── CLAUDE.md                   # Claude-specific quick reference
└── references/
    ├── 00-core-framework.md    # Decision-making process
    ├── 10-checklist-*.md       # Execution checklists
    └── 2*-patterns-*.md        # UI pattern libraries

Guidelines

View the full list of principles at audit.uxtools.co

Decisioning

Weigh information in order: Institutional knowledge → User familiarity → Research
Align every decision with macro bets: Velocity, Efficiency, Accuracy, or Innovation
Define jobs-to-be-done first

Visual Hierarchy

Primary action is obvious within 3 seconds
2:1 ratio minimum between heading levels
Related items are grouped (Law of Proximity)

Accessibility

Keyboard works everywhere
Focus is always visible
Color is not the only indicator

View all guidelines →

Author

Tommy Geoco — uxtools.co • uxdecisions.com

License

MIT

README