nielsen-usability-heuristics
Skill194 starsChanged 4 months agoMITView on GitHub
Nielsen's 10 usability heuristics. Use when auditing an interface, designing interaction flows, writing error messages or reviewing usability.
In this repository44 other files it gives its agents.
- algorithmic-color-paletteSkill
- app-shellSkill
- authentic-product-representationSkill
- brand-visual-languageSkill
- button-statesSkill
- clone-websiteSkill
- color-mode-and-themeSkill
- component-family-consistencySkill
- coordinated-data-viewsSkill
- data-display-and-selectionSkill
- dembrandtSkill
- domain-expert-configurationSkill
- elevation-and-depthSkill
- extract-designSkill
- form-designSkill
- generate-ui-from-brandSkill
- gestalt-ui-organisationSkill
- global-toolbar-controlsSkill
- information-architectureSkill
- layout-paradigms-and-consistencySkill
- loading-states-and-perceived-performanceSkill
- marketing-vs-product-systemSkill
- micro-interactionsSkill
- modal-and-overlay-patternsSkill
- modular-scale-typographySkill
- motion-and-storytellingSkill
- notifications-and-recoverySkill
- operational-expert-tool-uiSkill
- performance-and-web-vitalsSkill
- real-world-metaphorsSkill
- repeated-component-alignmentSkill
- responsive-paradigmsSkill
- scroll-areasSkill
- semantic-html-and-seoSkill
- sizing-unitsSkill
- status-colors-and-errorsSkill
- sticky-and-fixed-elementsSkill
- surface-separationSkill
- tab-navigationSkill
- ui-context-and-scopeSkill
- ui-densitySkill
- user-flows-and-guided-pathsSkill
- visual-emphasis-and-hierarchySkill
- wcag-accessibilitySkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
17 rules. About 0 are common, 17 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈17
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 62
Never leave a user wondering whether an action was registered
- Distinctive: line 64
Review question: After any user action, is the outcome visible within 1 second?
- Distinctive: line 72
Follow real-world conventions and natural mapping so the interface feels intuitive rather than requiring translation.
- Distinctive: line 75
Use terminology the target audience uses, not what the engineering team uses
- Distinctive: line 78
Avoid exposing internal system concepts (IDs, error codes, process names) to end users
- Distinctive: line 91
Always provide Undo for destructive or irreversible actions
- Distinctive: line 107
Use the same label for the same action across the entire product
- Distinctive: line 108
Follow platform conventions (e.g.
- Distinctive: line 110
Do not rename standard web patterns (e.g.
- Distinctive: line 123
Use constraints to make wrong inputs impossible (e.g.
- Distinctive: line 125
Use input masks, validation, and sensible defaults to guide correct input
- Distinctive: line 141
Use icons with labels — icons alone are ambiguous to many users
- Distinctive: line 171
Remove decorative elements that carry no meaning
- Distinctive: line 173
Avoid showing all features simultaneously — progressive disclosure reveals complexity only when needed
- Distinctive: line 187
Never show raw error codes or stack traces to end users
- Distinctive: line 190
Use appropriate visual treatment: red for errors, but not red for warnings or info
- Distinctive: line 204
Prefer self-explanatory UI over tooltips.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Nielsen's 10 Usability Heuristics
Foundational principles for evaluating and designing usable interfaces. Apply these as a review checklist and as design constraints from the start — not only as a post-hoc audit tool.
1. Visibility of System Status
The design should always keep users informed about what is going on, through appropriate feedback within a reasonable amount of time.
Users cannot make good decisions without knowing the current state of the system. Trust is built through clear, timely feedback.
In practice:
- Show loading states, progress indicators, and completion confirmations
- Indicate where the user is in a multi-step process
- Reflect state changes immediately (optimistic UI or loading spinners)
- Never leave a user wondering whether an action was registered
Review question: After any user action, is the outcome visible within 1 second?
2. Match Between System and Real World
The design should speak the users' language — words, phrases, and concepts familiar to the user, not internal jargon or system terminology.
Follow real-world conventions and natural mapping so the interface feels intuitive rather than requiring translation.
In practice:
- Use terminology the target audience uses, not what the engineering team uses
- Icons should match real-world objects or widely established web conventions
- Spatial metaphors should match real-world expectations (e.g. "trash" for deletion)
- Avoid exposing internal system concepts (IDs, error codes, process names) to end users
Review question: Would a user unfamiliar with this product understand every label and term?
3. User Control and Freedom
Users often perform actions by mistake. They need a clearly marked emergency exit to leave an unwanted state without going through an extended process.
Easy undo and escape paths foster confidence and prevent users from feeling trapped.
In practice:
- Always provide Undo for destructive or irreversible actions
- Modals and dialogs need an obvious close/cancel action
- Multi-step flows need a way to go back
- Destructive actions (delete, publish, send) should be reversible where possible — or require explicit confirmation
Review question: Can the user get out of any state without losing their work or needing to contact support?
4. Consistency and Standards
Users should not have to wonder whether different words, situations, or actions mean the same thing. Follow platform and industry conventions.
Consistency reduces cognitive load by meeting expectations users have built from other products.
In practice:
- Use the same label for the same action across the entire product
- Follow platform conventions (e.g. left-swipe to delete on mobile, Cmd+Z for undo)
- Design system components should look and behave identically everywhere they appear
- Do not rename standard web patterns (e.g. calling a "breadcrumb" a "path trail")
Review question: Does the same action always look and behave the same way throughout the product?
5. Error Prevention
Good error messages matter, but the best designs prevent errors from occurring in the first place.
Prevention addresses both slips (unintentional actions) and mistakes (misunderstanding of design intent).
In practice:
- Use constraints to make wrong inputs impossible (e.g. disable a Submit button until required fields are complete)
- Confirm before destructive or irreversible actions
- Use input masks, validation, and sensible defaults to guide correct input
- Design forms so the happy path is the obvious path
Review question: For every destructive or irreversible action, is there a confirmation step or an undo path?
6. Recognition Rather Than Recall
Minimise the user's memory load by making elements, actions, and options visible. The user should not have to remember information from one part of the interface to another.
Recognition requires less cognitive effort than recall. Visible affordances reduce the work of using the product.
In practice:
- Show relevant options in context rather than requiring users to remember commands
- Display previously entered data when relevant (e.g. pre-fill known fields)
- Use icons with labels — icons alone are ambiguous to many users
- Navigation should be visible at all times, not hidden behind a gesture or hover
Review question: Does a returning user need to remember anything to pick up where they left off?
7. Flexibility and Efficiency of Use
Shortcuts — hidden from novice users — may speed up interaction for expert users. The design should serve both.
Accelerators, customisation, and personalisation let experienced users work faster without adding complexity for beginners.
In practice:
- Provide keyboard shortcuts for frequent actions
- Support both guided flows (for new users) and direct paths (for experts)
- Allow users to customise views, filters, or layouts they use repeatedly
- Surface frequently used actions prominently based on usage patterns
Review question: Can a power user complete their most frequent task significantly faster than a first-time user?
8. Aesthetic and Minimalist Design
Interfaces should not contain information that is irrelevant or rarely needed. Every extra unit of information competes with relevant information and reduces its relative visibility.
Focus content and visual design on the essentials that support primary user goals. Less is more, only when the less is the right less.
In practice:
- Remove decorative elements that carry no meaning
- Secondary and tertiary actions should be visually subordinate to primary ones
- Avoid showing all features simultaneously — progressive disclosure reveals complexity only when needed
- Empty states, error states, and loading states deserve the same design attention as content states
Review question: Does every element on screen earn its place, or is something there "just in case"?
9. Help Users Recognize, Diagnose, and Recover from Errors
Error messages should be expressed in plain language, precisely indicate the problem, and constructively suggest a solution.
Error messages are a UX surface — they deserve the same care as any other UI copy.
In practice:
- Never show raw error codes or stack traces to end users
- State clearly what went wrong in plain language
- Tell the user what to do next, not just what failed
- Use appropriate visual treatment: red for errors, but not red for warnings or info
- Inline validation errors should appear adjacent to the problematic field
Review question: Does every error message tell the user what happened, why, and what to do next?
10. Help and Documentation
It is best if the system does not need any additional explanation. However, it may be necessary to provide documentation to help users complete tasks.
Help should be contextual, searchable, and actionable — not a last resort buried in a footer.
In practice:
- Prefer self-explanatory UI over tooltips; prefer tooltips over documentation
- Inline help (placeholder text, helper text, tooltips) should appear at the point of need
- Documentation should be task-oriented ("How do I…") not feature-oriented ("About the settings panel")
- Empty states are an opportunity for contextual help, not just a blank screen
Review question: Can a confused user find help without leaving the current screen?
Heuristic Review Checklist
| # | Heuristic | Check |
| 1 | System status | Every action gives visible feedback within 1s |
| 2 | Real-world language | No jargon, terminology matches user vocabulary |
| 3 | User control | Undo available, exit paths always visible |
| 4 | Consistency | Same action = same label and behaviour everywhere |
| 5 | Error prevention | Irreversible actions have confirmation or undo |
| 6 | Recognition over recall | Options visible in context, no hidden commands |
| 7 | Flexibility | Power users have faster paths to frequent tasks |
| 8 | Minimalist design | Every element earns its place |
| 9 | Error recovery | Error messages are plain, specific, and actionable |
| 10 | Help and docs | Help is contextual and available at point of need |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

