ux-audit
Installation
SKILL.md
Overview
Based on "Don't Make Me Think" by Steve Krug. Krug's core principle: every question a user has to ask themselves is a source of friction. Good UX eliminates questions. Users don't read - they scan. They don't make optimal choices - they satisfice (pick the first option that seems good enough). Design for scanning, not reading. Design for satisficing, not deliberation.
Krug's usability testing insight: you don't need 20 users. 5 users reveal ~85% of usability problems (Nielsen's law). The fastest audit tool is watching one real user try to use the product.
Workflow
Step 1: Define the flow and success criteria
State the flow you're auditing and what success looks like:
- Flow: [start state] to [end state] (e.g., landing page to first value moment)
- Success: [specific action that means the user succeeded]
- Current conversion/completion rate: [if known]
Step 2: Map every step in the flow
List every screen and decision point a user encounters. Include:
- What the user sees
- What the user must do (read, decide, input, wait)
- What the user must remember from a previous step