ui-audit

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

Guidelines • ClawdHub • npm

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