ux-heuristics
Skill0 starsChanged 37 days agoMITView on GitHub
Inspect a screen, flow or dashboard against Jakob Nielsen's ten usability heuristics and report the violations by severity. Use when someone asks for a heuristic evaluation or a usability review, says "run the heuristics", "check this against Nielsen", "what is wrong with this screen", or when the jobs-quote-ux skill needs a systematic pass over a real interface. Needs a rendered interface to look at; with none, it says so and stops.
13 other projects use a version of this.
Adopted by
Most recently taken up by
- alexj11324/Mikkatheir own version, first seen Nov 15, 2026
- Design-of-Man/claude-skillstheir own version, first seen Oct 30, 2026
- ne11nn/cantos-plugintheir own version, first seen Oct 20, 2026
- davidanthonyn/claude-skillstheir own version, first seen Oct 20, 2026
- robinbril/claude-code-harnesstheir own version, first seen Oct 19, 2026
- NinjaSln-labs/agent-skillstheir own version, first seen Oct 2, 2026
Other versions13 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 13
- wondelai/skills★ 2.6ksame name
- alexj11324/Mikka★ 87same name
- YehudaFrankel/clankbrain★ 16same name
- robinbril/claude-code-harness★ 3same name
- Adhamxon/claude-code-skills★ 2same name
- sanmidable/skills★ 2same name
- sanmidable/ux-heuristics★ 2same name
- ne11nn/cantos-plugin★ 1same name
- NinjaSln-labs/agent-skills★ 1same name
- andresladino-design/simetrik-design-studio★ 0same name
3 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository5 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- analyze-data-qualitySkill
- closed-loop-visual-feedbackSkill
- inverse-set-kondoSkill
- jobs-quote-uxSkill
The file
We split this skill into the rules it gives an agent
4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 12 edited versions we read keep these.
4
Distinctive
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 46
Aesthetic and minimalist design: Every element on screen competes with the ones that matter.
- Distinctive: line 48
Help users recognize, diagnose and recover from errors: When it goes wrong, say what happened in plain words and what to do next.
- Distinctive: line 70
Do not force a finding for every heuristic.
- Distinctive: line 71
If the screen passes all ten, say so plainly and stop.
“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Usability heuristics
Jakob Nielsen's ten heuristics are the standard checklist for finding usability problems without running a user test. They are rules of thumb, not laws: each one names a way that interfaces commonly fail people.
Where this sits
jobs-quote-uxcomes first. It names the person and what they are trying to do. A heuristic pass with no person in mind produces a list of nitpicks. If nobody has named the person yet, do that before anything below.closed-loop-visual-feedbacksupplies the evidence. Inspect the rendered interface, at the size and on the device the person will use. Reading the source is not an inspection.inverse-set-kondois the eighth heuristic turned on everything else. Aesthetic and minimalist design, asked of rules, checks, config, and code instead of the screen.
The ten
Walk them in order, once per screen or per step of a flow.
- Visibility of system status. The person can always tell what is happening. A dashboard says how fresh its data is. A filter that is on looks on. A load that takes more than a second shows that it is working.
- Match between the system and the real world. It speaks the person's language, in
the order they think. "Late trips" rather than
dq_flag_3. Dates the way the audience writes them. - User control and freedom. There is an obvious way back out of anything. Clear all filters. Undo. Close the drill-down and land where you were.
- Consistency and standards. The same thing looks and behaves the same everywhere, and follows conventions the person already knows. One colour means one thing across every chart. Red is not "good" on one tab and "bad" on the next.
- Error prevention. The design makes the mistake hard to make, which beats a good error message. A date picker that cannot select an end before the start.
- Recognition rather than recall. Nothing has to be remembered from another screen. Chart titles carry the active filters. Legends sit next to what they explain.
- Flexibility and efficiency of use. A newcomer can get through it, and a regular is not slowed down by the newcomer's path. Sensible defaults, shareable URLs, the last view remembered.
- Aesthetic and minimalist design. Every element on screen competes with the ones that matter. Cut the KPI nobody acts on, the gridlines, the third decimal place.
- Help users recognize, diagnose and recover from errors. When it goes wrong, say what happened in plain words and what to do next. "No trips match these filters. Clear the borough filter?" rather than an empty chart.
- Help and documentation. Best if none is needed. Where it is, it sits at the point of need: a one-line definition on the metric, not a manual somewhere else.
Rating what you find
Give each finding a severity, so the list can be acted on in order:
- 4, blocker: the person cannot finish the task, or leaves believing something false.
- 3, major: they finish, but slowly or only after a wrong turn. Fix before sharing.
- 2, minor: a stumble they recover from alone. Fix when convenient.
- 1, cosmetic: fix only if time allows.
A wrong number that looks right is always a 4. On a dashboard, being trusted is the task.
Output
For each finding: the heuristic by number and name, where on the screen it is, what the person experiences, the severity, and the smallest fix. Order by severity, highest first.
Do not force a finding for every heuristic. Say which ones the screen passes and move on. If the screen passes all ten, say so plainly and stop.
Created by Exagrow AI Consulting. Provided under the MIT License.
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.

