MCPInstall

nielsen-usability-heuristics

Nielsen's 10 usability heuristics. Use when auditing an interface, designing interaction flows, writing error messages or reviewing usability.

Installs
989
Last 24h
+9
Trending rank
#9098
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/dembrandt/dembrandt-skills --skill nielsen-usability-heuristics
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads nielsen-usability-heuristics automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

#HeuristicCheck
1System statusEvery action gives visible feedback within 1s
2Real-world languageNo jargon, terminology matches user vocabulary
3User controlUndo available, exit paths always visible
4ConsistencySame action = same label and behaviour everywhere
5Error preventionIrreversible actions have confirmation or undo
6Recognition over recallOptions visible in context, no hidden commands
7FlexibilityPower users have faster paths to frequent tasks
8Minimalist designEvery element earns its place
9Error recoveryError messages are plain, specific, and actionable
10Help and docsHelp is contextual and available at point of need

FAQ

What does the nielsen-usability-heuristics skill do?

Nielsen's 10 usability heuristics. Use when auditing an interface, designing interaction flows, writing error messages or reviewing usability.

How do I install nielsen-usability-heuristics?

Run npx skills add https://github.com/dembrandt/dembrandt-skills --skill nielsen-usability-heuristics in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/nielsen-usability-heuristics/ (personal) or .claude/skills/nielsen-usability-heuristics/ (project).

Which AI agents can use nielsen-usability-heuristics?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is nielsen-usability-heuristics safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains nielsen-usability-heuristics?

It is published by dembrandt in dembrandt/dembrandt-skills. It has 989 recorded installs.

More from dembrandt/dembrandt-skills

View all →

performance-and-web-vitals

dembrandt/dembrandt-skills

Lighthouse audits and Core Web Vitals — LCP, CLS, INP. Use when optimising page load, layout shift, input delay, images, fonts or render-blocking resources.

color-mode-and-theme

dembrandt/dembrandt-skills

Light, dark or both, and when a theme selector is worth it. Use when defining a base palette or deciding on dark mode support.

Frontend & Design940 installs

ui-density

dembrandt/dembrandt-skills

Match information density to platform and user type. Use when designing data tables, dashboards or toolbars, or adapting a desktop product for mobile.

Frontend & Design927 installs

form-design

dembrandt/dembrandt-skills

Helper text, placeholders, validation and submit behaviour. Use when designing or reviewing a form, input field or data entry UI.

Frontend & Design925 installs

brand-visual-language

dembrandt/dembrandt-skills

Shape language across type, radius and icons carries brand personality. Use when starting a design system, picking icons or radius tokens, or reviewing visual consistency.

Marketing & SEO915 installs

semantic-html-and-seo

dembrandt/dembrandt-skills

Semantic HTML5, SEO basics, alt text, progressive enhancement and SPA concerns. Use when building web UI, reviewing markup or optimising for search.

Frontend & Design909 installs

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs