Web Usability — Agent Skill (Don't Make Me Think)
Rules from Don't Make Me Think, Revisited (Steve Krug, 2014). Users scan and satisfice — design for that, not for careful reading.
Pair with web-api-design for backend contracts and clean-code for implementation.
When to apply
- Designing or reviewing web/mobile pages, flows, navigation, labels, forms
- Writing UI copy, error messages, onboarding
- Planning lightweight usability tests
- User says: usability, UX, Krug, don't make me think, make this obvious
Core laws
- Don't make me think — every page/question should be self-evident at a glance.
- Users scan, they don't read — design billboards, not essays.
- Users satisfice — first reasonable option wins; make the right choice obvious.
- Users muddle through — they use what works, not what's optimal; don't rely on instructions.
- Omit needless words — half the words on most pages can go.
- Test with real users — early, often, cheap; fixes beat debates.
Agent workflow
1. GLANCE TEST — can user tell what this is and what to do in 5 seconds?
2. SCAN DESIGN — hierarchy, headings, bold keywords, short chunks
3. CHOICES — mindless, clearly labeled, no clever names
4. NAVIGATION — persistent, breadcrumbs, you-are-here, search when needed
5. COPY — cut words; kill happy talk and instructions
6. TEST PLAN — 3 users, monthly, fix top issues
How users actually behave (Ch 2)
- Scan pages for words/phrases that match their task
- Click the first thing that looks close enough (satisficing)
- Back button is the most-used control — support undo mentally
- Never assume users read instructions, compare all options, or choose optimally
Design implication: make the right thing look clickable and obvious.
Billboard design (Ch 3)
- Clear visual hierarchy — what's most important looks most important
- Use conventions — logo top-left, nav top, search box where expected
- Break pages into clear areas — user decides where to look first
- Make clickable things obvious — buttons look like buttons; links look like links
- Format text for scanning — short paragraphs, bullets, bold key terms
- Minimize noise — every extra element competes for attention
5-second test: Show page 5 seconds — can they say what it's for?
Mindless choices (Ch 4)
- Every click should not require thought
- Category names must be mutually exclusive and unambiguous
- Avoid cute/punny labels — use what users would say
- Trunk test: On any random page, user should instantly know: site, page, major sections, local nav, utilities, "you are here"
Omit needless words (Ch 5)
Remove:
- Happy talk — "Welcome! We're glad you're here…"
- Redundant instructions — if UI is self-explanatory
- Half the words — then half again
Keep: words that reduce ambiguity or answer a question the user has.
Navigation (Ch 6)
- Persistent navigation on every page (except focused flows like checkout)
- Show location — breadcrumbs, highlighted section, page name
- Home link on logo; Search when catalog/content is large
- Utilities (login, cart, help) separated from primary nav
- Site ID + tagline on every page unless user is deep in a known section
Home page / landing (Ch 7)
Answer immediately:
- What is this?
- What can I do here?
- What's new/important?
Don't cram everything — prioritize what most users need. Tagline = 6–8 words explaining what you do.
Mobile (Ch 10)
- Tradeoffs are real — less screen = harder; don't hide essentials
- Smart defaults, sensible autofill, forgiving inputs
- Learnable gestures only when payoff is clear
- Desktop patterns don't always translate — test on device
Courtesy & accessibility (Ch 11–12)
- Be a mensch — helpful error messages, don't punish users for mistakes
- Accessibility helps everyone — alt text, contrast, keyboard nav, form labels
- Fix obvious a11y issues in every review (headings, focus, link text)
Usability testing (Ch 9)
Do this:
- 3 users per round is enough to find major issues
- One morning a month — not a big lab study
- Give tasks; stay quiet; note where they hesitate or go wrong
- Fix top serious problems first; debaters lose to testers
Don't: wait for perfect prototype; argue instead of test.
Smells to flag
| Smell |
Fix |
| Clever labels / inside jargon |
Plain user language |
| Wall of text |
Scan-friendly chunks |
| Same-weight everything |
Visual hierarchy |
| Mystery meat navigation |
Obvious links, you-are-here |
| Instructions before action |
Self-explanatory UI |
| Too many equal choices |
Defaults, recommendations, grouping |
| No home/search on inner pages |
Persistent nav |
| Untested redesign |
Monthly 3-user test |
Review output format
## 5-second test
[Can user tell what this is and what to do?]
## Must fix
- [Blocks task completion or causes confusion]
## Scan & hierarchy
- [Headings, noise, clickable affordances]
## Copy
- [Words to cut or clarify]
## Navigation
- [Location, trunk test failures]
## Quick test suggestion
[1–3 tasks for next usability round]
Source
Steve Krug, Don't Make Me Think, Revisited (3rd ed., 2014).
1---2name: web-usability3description: Apply Steve Krug's Don't Make Me Think (3rd ed.) web usability principles when designing or reviewing websites, web apps, navigation, copy, mobile UX, or running lightweight usability tests. Use for UX review, page layout, labels, flows, accessibility basics, or when the user mentions usability, Krug, or don't make me think.4---56# Web Usability — Agent Skill (Don't Make Me Think)78Rules from *Don't Make Me Think, Revisited* (Steve Krug, 2014). **Users scan and satisfice — design for that, not for careful reading.**910Pair with **web-api-design** for backend contracts and **clean-code** for implementation.1112## When to apply1314- Designing or reviewing web/mobile pages, flows, navigation, labels, forms15- Writing UI copy, error messages, onboarding16- Planning lightweight usability tests17- User says: usability, UX, Krug, don't make me think, make this obvious1819---2021## Core laws22231. **Don't make me think** — every page/question should be self-evident at a glance.242. **Users scan, they don't read** — design billboards, not essays.253. **Users satisfice** — first reasonable option wins; make the right choice obvious.264. **Users muddle through** — they use what works, not what's optimal; don't rely on instructions.275. **Omit needless words** — half the words on most pages can go.286. **Test with real users** — early, often, cheap; fixes beat debates.2930---3132## Agent workflow3334```351. GLANCE TEST — can user tell what this is and what to do in 5 seconds?362. SCAN DESIGN — hierarchy, headings, bold keywords, short chunks373. CHOICES — mindless, clearly labeled, no clever names384. NAVIGATION — persistent, breadcrumbs, you-are-here, search when needed395. COPY — cut words; kill happy talk and instructions406. TEST PLAN — 3 users, monthly, fix top issues41```4243---4445## How users actually behave (Ch 2)4647- **Scan** pages for words/phrases that match their task48- **Click** the first thing that looks close enough (satisficing)49- **Back** button is the most-used control — support undo mentally50- Never assume users read instructions, compare all options, or choose optimally5152Design implication: **make the right thing look clickable and obvious**.5354---5556## Billboard design (Ch 3)5758- Clear **visual hierarchy** — what's most important looks most important59- **Use conventions** — logo top-left, nav top, search box where expected60- **Break pages into clear areas** — user decides where to look first61- **Make clickable things obvious** — buttons look like buttons; links look like links62- **Format text for scanning** — short paragraphs, bullets, bold key terms63- **Minimize noise** — every extra element competes for attention6465**5-second test:** Show page 5 seconds — can they say what it's for?6667---6869## Mindless choices (Ch 4)7071- Every click should **not require thought**72- Category names must be **mutually exclusive** and **unambiguous**73- Avoid cute/punny labels — use what users would say74- **Trunk test:** On any random page, user should instantly know: site, page, major sections, local nav, utilities, "you are here"7576---7778## Omit needless words (Ch 5)7980Remove:81- **Happy talk** — "Welcome! We're glad you're here…"82- **Redundant instructions** — if UI is self-explanatory83- **Half the words** — then half again8485Keep: words that **reduce ambiguity** or **answer a question the user has**.8687---8889## Navigation (Ch 6)9091- **Persistent navigation** on every page (except focused flows like checkout)92- **Show location** — breadcrumbs, highlighted section, page name93- **Home** link on logo; **Search** when catalog/content is large94- **Utilities** (login, cart, help) separated from primary nav95- Site ID + tagline on every page unless user is deep in a known section9697---9899## Home page / landing (Ch 7)100101Answer immediately:1021. What is this?1032. What can I do here?1043. What's new/important?105106Don't cram everything — **prioritize** what most users need. Tagline = 6–8 words explaining what you do.107108---109110## Mobile (Ch 10)111112- **Tradeoffs are real** — less screen = harder; don't hide essentials113- **Smart defaults**, sensible autofill, forgiving inputs114- **Learnable gestures** only when payoff is clear115- Desktop patterns don't always translate — test on device116117---118119## Courtesy & accessibility (Ch 11–12)120121- Be a **mensch** — helpful error messages, don't punish users for mistakes122- **Accessibility helps everyone** — alt text, contrast, keyboard nav, form labels123- Fix obvious a11y issues in every review (headings, focus, link text)124125---126127## Usability testing (Ch 9)128129**Do this:**130- **3 users** per round is enough to find major issues131- **One morning a month** — not a big lab study132- Give tasks; **stay quiet**; note where they hesitate or go wrong133- Fix **top serious problems first**; debaters lose to testers134135**Don't:** wait for perfect prototype; argue instead of test.136137---138139## Smells to flag140141| Smell | Fix |142|-------|-----|143| Clever labels / inside jargon | Plain user language |144| Wall of text | Scan-friendly chunks |145| Same-weight everything | Visual hierarchy |146| Mystery meat navigation | Obvious links, you-are-here |147| Instructions before action | Self-explanatory UI |148| Too many equal choices | Defaults, recommendations, grouping |149| No home/search on inner pages | Persistent nav |150| Untested redesign | Monthly 3-user test |151152---153154## Review output format155156```markdown157## 5-second test158[Can user tell what this is and what to do?]159160## Must fix161- [Blocks task completion or causes confusion]162163## Scan & hierarchy164- [Headings, noise, clickable affordances]165166## Copy167- [Words to cut or clarify]168169## Navigation170- [Location, trunk test failures]171172## Quick test suggestion173[1–3 tasks for next usability round]174```175176---177178## Source179180Steve Krug, *Don't Make Me Think, Revisited* (3rd ed., 2014).