SkillAgentSearch skills...

jakobs-law

Apply Jakob's Law — users expect your product to work like the others they already use

Install / Use

npx skills add Owl-Listener/designer-skills --skill jakobs-law

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

80/100

Supported Platforms

Universal

Our assessment of jakobs-law

jakobs-law scores 80/100 on our quality scale, 3629th of 4,698 Development & Engineering skills we index.

Its SKILL.md is 3.9 KB long, well organised into 8 sections and no code examples: a solid amount of guidance for an agent.

With 2,736 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
13/20
Description
12/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so jakobs-law is actively maintained.
  • Our last check on 2026-11-08 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

jakobs-law compared with similar skills

All 4 of these similar skills score higher than jakobs-law; compare them before choosing.

SkillScoreStarsUpdatedFormat
jakobs-law (this skill)by Owl-Listener802.7k2mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md

Frequently asked questions

How do I install jakobs-law?
Run npx skills add Owl-Listener/designer-skills --skill jakobs-law. The install tabs above show the steps for each supported agent.
Which AI agents does jakobs-law work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is jakobs-law safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is jakobs-law still maintained?
The repository was last updated about 2 months ago, so jakobs-law is actively maintained.

name: jakobs-law description: 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).

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

Related Skills

View on GitHub
GitHub Stars2.7k
CategoryDevelopment
Updated2mo ago
Forks388

Languages

Markdown

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions