hicks-law — Claude Code skill: fewer choices per screen
A skill that applies Hick's Law — decision time grows with the number of simultaneous choices. Useful when a screen throws too many options at the user.
npx skills add Owl-Listener/designer-skills --skill hicks-law -a claude-codeWhat hicks-law does
The skill puts your agent in the role of a cognitive load expert for interfaces. It reads a screen or mockup and points at where too many decisions happen at once: trim top-level navigation, move rare actions into overflow menus, split onboarding into one question per step.
Inside is the principle plus the formula RT = a + b × log₂(n + 1). That formula fits simple equal-probability choices like menu items or keyboard shortcuts; for complex real-world decisions it predicts poorly, and the skill says so. A section on common mistakes covers conflating fewer options with less functionality, and hiding options people need often.
The advice is to group before you cut. Categorisation lowers apparent complexity more than removal does. For high-frequency actions it suggests smart defaults so the choice never comes up. If your question is how many items survive in memory afterwards, that is millers-law instead.
What it helps with
- cut the number of top-level navigation items
- break onboarding into one decision per step
- move rare toolbar actions into an overflow menu
- rebuild a pricing table to stop choice paralysis
- group form fields and put required ones first
Example prompts for the agent
- look at this screen and tell me where there are too many simultaneous choices
- apply hicks-law to the nav and the pricing table
- check the onboarding flow — are we asking everything on one step
How to install hicks-law
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill hicks-law -a claude-code2Manually: put the files in place
~/.claude/skills/hicks-law/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/hicks-law/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill hicks-law -a codex2Manually: put the files in place
.agents/skills/hicks-law/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill hicks-law -a cursor2Manually: put the files in place
.cursor/skills/hicks-law/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Owl-Listener/designer-skills hicks-law2Manually: put the files in place
.github/skills/hicks-law/SKILL.md1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill hicks-law -a gemini-cli2Platform CLI
gemini skills install https://github.com/Owl-Listener/designer-skills --path interaction-design/skills/hicks-lawManually: put the files in place
.devin/skills/hicks-law/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill hicks-law -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about hicks-law
How do I install hicks-law in Claude?
Run npx skills add Owl-Listener/designer-skills --skill hicks-law -a claude-code. The skill lands at ~/.claude/skills/hicks-law/SKILL.md.
What does hicks-law do?
It makes the agent review an interface through Hick's Law and suggest ways to cut simultaneous choices: grouping, progressive disclosure, defaults.
How is hicks-law different from millers-law?
hicks-law is about decision time and how many options sit on screen; millers-law is about how many items a person keeps in memory afterwards.
Source text
SKILL.md · MIT
--- name: hicks-law description: Apply Hick's Law — decision time grows with the number of simultaneous choices. Use when a screen offers too many options at once. For how many items survive in memory afterwards, use `millers-law`. --- # Hick's Law You are an expert in cognitive load and decision-making in interface design. ## What You Do You apply Hick's Law to reduce decision time and cognitive burden by controlling the number and complexity of choices presented at any moment. ## The Principle The time it takes to make a decision increases logarithmically with the number of choices. Doubling the number of options does not double decision time — but each added option still costs something. The practical design implication: - Presenting fewer options at once speeds up decision-making - Grouping and progressive disclosure reduce apparent complexity without hiding functionality - The quality and clarity of options matters as much as the count — ambiguous or overlapping options are harder to choose from than a larger set of distinct ones ## The Formula (for context) `RT = a + b × log₂(n + 1)` — where RT is reaction time, n is the number of choices, and a/b are empirically measured constants. The formula applies best to simple, equal-probability choices (keyboard shortcuts, menu items); it is less predictive for complex real-world decisions. ## Where to Apply It - **Navigation menus**: limit top-level items; group secondary items - **Toolbars and action bars**: surface the most common actions; tuck the rest in overflow menus - **Onboarding flows**: present one decision per step rather than multiple questions on a single screen - **Form fields**: reduce optional fields; present required fields first - **Pricing tables**: three tiers is the conventional sweet spot; more creates analysis paralysis - **Search results and feeds**: pagination and progressive loading prevent the full count from overwhelming decision ## Common Mistakes - Conflating "fewer options" with "less functionality" — the goal is reducing simultaneous choices, not removing features - Applying it to justify hiding important options users need frequently - Ignoring choice quality: five clear, distinct options can be easier to choose from than three vague ones ## Best Practices - Group related options before reducing count — categorization reduces apparent complexity more than removal - For high-frequency actions, consider defaulting or smart defaults to skip the choice entirely - Use progressive disclosure: show defaults, let users reveal advanced options - Test decision time directly in usability studies when navigation or menu depth is in question
© Owl-Listener · MIT · Owl-Listener/designer-skills