hermes

Run a heuristic evaluation

Evaluates a flow step by step against Nielsen's ten usability heuristics and returns located issues with severity ratings and concrete fixes. Use for a fast expert review before or between user tests.

context

A heuristic evaluation is an expert walking through an interface with a goal in mind and naming where it breaks recognised usability principles. Done badly it becomes a checklist exercise: one vague comment forced under each heuristic, no location, no severity, no fix. Done well it is a ranked list of specific problems, each tied to a step in the flow and a principle, that a designer can act on the same day.

task

Evaluate this flowOnly if [PLATFORM] is given: on :

flow

Nielsen's ten heuristics: H1 Visibility of system status. H2 Match between the system and the real world. H3 User control and freedom. H4 Consistency and standards. H5 Error prevention. H6 Recognition rather than recall. H7 Flexibility and efficiency of use. H8 Aesthetic and minimalist design. H9 Help users recognise, diagnose and recover from errors. H10 Help and documentation.

  1. State the user's goal and the steps you will walk. If the goal is not given, infer it and say so.
  2. Walk the flow one step at a time as that user. At each step ask: do I know where I am and what just happened, what I can do next, how to undo it, and what the words mean?
  3. Record each problem with its location (step and element), the heuristic or heuristics it violates, what goes wrong for the user, and a concrete fix.
  4. Rate severity on Nielsen's 0 to 4 scale: 0 not a problem, 1 cosmetic, 2 minor, 3 major (important to fix), 4 catastrophe (must fix before release). Weigh how often it occurs, how much it hurts when it does, and whether users can get past it once they know.
  5. Apply the platform's conventions under H4 (Apple Human Interface Guidelines for iOS and macOS, Material Design for Android, common web patterns) when the platform is known.
  6. Note states the input does not show (errors, empty, loading, slow network) as gaps to check, not as found problems.
  7. If the input is too sparse to evaluate (a single screen name, no description of content or actions), ask for screenshots or a fuller description and stop.
constraints
  • Report only real problems. Do not force a finding under every heuristic; an empty heuristic is fine.
  • One finding per problem. If one problem violates two heuristics, list both on one row.
  • Describe what you can see or what the description states. Mark anything inferred from a description rather than seen as "inferred".
  • Accessibility problems you notice can be reported, but say that a heuristic evaluation is not an accessibility audit.
  • Separate what you verified from what you inferred. Mark inferences as such.
  • When you do not know, say "I don't know" once and state what would settle it.
output format

Scope

Goal, platform, steps walked, assumptions.

Findings

| # | Step / element | Heuristic(s) | Problem for the user | Severity (0-4) | Fix | Sorted by severity, highest first.

Coverage

Count of findings per heuristic, and states not shown that still need checking.

Top fixes

The 3 changes that would remove the most severe problems, in order.

Limitations

One evaluator finds only part of the problems (a third is typical); recommend 3 to 5 evaluators and a usability test to confirm severity.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Design
category
UX research
level
Intermediate
made for
Product / UX / UI designer, UX researcher, Product manager
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-02
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install run-heuristic-evaluation --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill run-heuristic-evaluation -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the design plugin
claude plugin install hodios-design@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of UX research
PromptUX research

Write a usability test plan

Writes a usability test plan with scenario tasks, success metrics, participant criteria, a screener and a moderator script, tied to the research questions. Use before running a usability study.

write-usability-test-plan
PromptUI design

Critique a UI screen

Critiques one interface screen for hierarchy, layout, consistency, clarity and accessibility against its goal, and returns prioritised, concrete fixes. Use when reviewing a mockup or live screen.

critique-ui-screen
PersonaUX research

UX researcher

UX researcher who matches the method to the question, separates what people did from what it means, and protects participants. Use as a partner for planning, running and synthesising research.

ux-researcher
PersonaUI design

Product designer

Product designer who frames the problem before the pixels, explores several options, designs every state and defends decisions with user evidence. Use as a design partner or reviewer.

product-designer
PromptUX research

Analyse session recordings and heatmaps

Synthesises notes from session recordings and heatmaps into usability issues with frequency, severity and evidence, keeping observation apart from interpretation, and plans follow-ups.

analyze-session-recordings
PromptUX research

Build a user journey map from research

Builds an evidence-based journey map with stages, actions, thoughts, emotions, pain points and opportunities, marking every assumption. Use after interviews or studies about one segment.

build-user-journey-map