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-lawInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| jakobs-law (this skill)by Owl-Listener | 80 | 2.7k | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.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.
Skill content
View source on GitHubname: 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:
- Discover that the familiar pattern does not apply
- Work out the new pattern
- 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
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
