Skip to main content
ClaudeWave
Skill2.5k repo starsupdated 5d ago

jakobs-law

Apply Jakob's Law — users expect your product to work like the others they already use. Use when deciding whether to innovate on a familiar pattern. For OS-mandated conventions specifically, use `platform-conventions` (ui-design).

Install in Claude Code
Copy
git clone --depth 1 https://github.com/Owl-Listener/designer-skills /tmp/jakobs-law && cp -r /tmp/jakobs-law/interaction-design/skills/jakobs-law ~/.claude/skills/jakobs-law
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Jakob's Law

You are an expert in mental models, user expectations, and the role of convention in interface design.

## What You Do

You apply Jakob's Law to identify which design conventions carry strong user expectations, evaluate the cost of departing from them, and make deliberate decisions about when to follow and when to innovate.

## The Principle

Users spend most of their time on other products. They arrive at yours with pre-built expectations about where navigation lives, what a cart icon means, how a toggle behaves, and where to look for settings. Jakob's Law, articulated by Jakob Nielsen, states:

**Users prefer your site to work the same way as all the other sites they already know.**

This is not an argument for copying competitors. It is an argument for understanding which conventions carry strong enough expectations that departing from them imposes a real learning cost — and being deliberate when you do.

## Where Conventions Are Strongest

Some patterns are so universal that users rely on them unconsciously:

- **Logo top-left → home**: violating this forces users to hunt for a way back
- **Shopping cart icon → checkout**: recognised globally across languages and cultures
- **Hamburger menu → hidden navigation**: established on mobile despite early friction
- **Search icon (magnifying glass) → search field**: universal; even non-technical users recognise it
- **X to close**: applies to modals, tooltips, notifications, drawers
- **Blue underlined text → link**: weakening but still active in text-heavy contexts

## The Cost of Departing From Convention

Every time you deviate, users must:
1. Discover that the familiar pattern does not apply
2. Work out the new pattern
3. Hold both patterns in memory until the new one is learned

This cost is paid on every visit until the pattern is learned — which requires repetition and motivation. The benefit of the new approach must outweigh this cumulative cost across your entire user base.

## When Deviation Is Justified

Departure from convention is justified when:
- The conventional approach fails at something your use case requires
- Your user base has a domain-specific convention that supersedes the general one (keyboard shortcuts in professional tools, for example)
- Testing shows the conventional approach performs measurably worse for your specific task
- You are establishing a genuinely new interaction category where no strong convention exists

Departure is not justified by:
- Wanting to feel differentiated
- Aesthetic preference in isolation
- Internally developed conventions that have not been tested against real users

## Applying It in Practice

- **Audit competitors before designing**: how do 3–5 comparable products handle this interaction?
- **Weight by task frequency**: high-frequency interactions must follow conventions; low-frequency ones have more latitude
- **Name the convention before departing from it**: if you cannot articulate the existing user expectation, you have not researched it
- **Test with users who know the category**: they hold the strongest prior expectations and will surface violations fastest

## Best Practices

- Start new design work by cataloguing dominant conventions in the category, not from a blank canvas
- Flag every departure from convention in design reviews as a deliberate, reasoned choice — not a default
- Reserve creative divergence for low-stakes or infrequent interactions; keep high-frequency, high-stakes interactions conventional
- Onboarding cannot substitute for convention — teaching users a custom pattern is expensive and fragile
- Return to convention when a novel pattern tests poorly; the default is almost always more efficient than the invention
design-critiqueSkill

Facilitate a structured team critique — framing, feedback rules, and actionable outcomes. Use when running a session with people in the room. For a solo expert review, use `heuristic-evaluation` (prototyping-testing).

design-debt-auditSkill

Inventory and prioritise accumulated design inconsistencies across a product. Use when drift has built up over time. For token coverage specifically use `design-token-audit` (designer-toolkit); for WCAG gaps use `accessibility-audit` (design-systems).

design-impact-reportingSkill

Communicate design's contribution to business and user outcomes in stakeholder language. Use when reporting results upward. For choosing the metrics in the first place, use `metrics-definition` (ux-strategy).

design-qa-checklistSkill

Build a QA checklist for verifying that a build matches the design. Use at implementation review. For the spec engineers build from, use `handoff-spec`.

design-review-processSkill

Establish review gates — criteria, checkpoints, and approval flow. Use when work ships without consistent review. For running one individual session, use `design-critique`.

design-sprint-planSkill

Plan and facilitate a design sprint from challenge framing through prototype testing. Use when compressing discovery into days. For ongoing team cadence, use `team-workflow`.

handoff-specSkill

Write the implementation handoff — measurements, behaviours, assets, states, and edge cases. Use when engineering picks up the work. For verifying the result afterwards use `design-qa-checklist`; for reusable library components use `component-spec` (design-systems).

team-workflowSkill

Design the team's operating rhythm — task management, collaboration rituals, and tooling. Use when the day-to-day cadence needs structure. For a time-boxed sprint, use `design-sprint-plan`.