ux-heuristics-audit

ux-heuristics-audit is a skill for Claude Code from Uxcel-Lab/product-skills. It costs 68 tokens per session (2,664 once invoked), scanned A, original, MIT.

A usability review based on Nielsen’s 10 heuristics, which are widely used principles for making interfaces easier to understand and use. It produces prioritized findings with a severity level, the related principle, and a specific fix.

In plain words
What is it for?
Use it to audit a screen, user flow, or interface component for usability issues, or to validate newly designed UI.
Why use it?
It replaces vague design feedback with a consistent way to identify problems that may waste users’ time, reduce confidence, or prevent task completion.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the uxcel plugin — 58 skills shipped together

Good fit Use it to audit a screen, user flow, or interface component for usability issues, or to validate newly designed UI.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/uxcel-lab/product-skills/heuristics
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Uxcel-Lab/product-skills --skill heuristics
Clone the repo
git clone --depth 1 https://github.com/Uxcel-Lab/product-skills

Made for: Claude Code.

Or install uxcel, the plugin that ships this one along with the rest of its 58 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ux-heuristics-audit

README.md
[![agentmods](https://agentmods.dev/badge/skills/uxcel-lab/product-skills/heuristics/github.svg)](https://agentmods.dev/skills/uxcel-lab/product-skills/heuristics)
Your own site
<a href="https://agentmods.dev/skills/uxcel-lab/product-skills/heuristics"><img src="https://agentmods.dev/badge/skills/uxcel-lab/product-skills/heuristics/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ux-heuristics-audit

Your own site · 80×15
<a href="https://agentmods.dev/skills/uxcel-lab/product-skills/heuristics"><img src="https://agentmods.dev/badge/skills/uxcel-lab/product-skills/heuristics.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 68 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,664 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00068 $0.02664
Opus 5 $0.00034 $0.01332
Sonnet 5 $0.00014 $0.00533
Haiku 4.5 $0.00007 $0.00266

Measured 11d ago against content hash cd0b83010b18, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

ux-heuristics-audit scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

ux/audits/heuristics/SKILL.md · 193 lines

How it starts

The opening of the file, as written. The whole thing — 193 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Usability Heuristics Audit Skill

What this skill changes vs. default behavior

Without this skill, a usability review tends to produce a flat list of generic suggestions ("make it cleaner", "improve the CTA") with no framework, no severity, and no link to why something is a problem. This skill forces four things:

  1. Every finding names the heuristic it violates — not a vague opinion.
  2. Every finding gets a severity rating based on frequency × impact × persistence — so the list is prioritized, not equal-weighted.
  3. Every finding has a concrete, specific fix — not "consider improving."
  4. The audit resists over-flagging. Heuristics are principles, not a checklist to max out. A finding only earns a place if it plausibly costs a real user time, confidence, or task completion.

Scope discipline. When invoked directly (the user named this audit), review only this concern — don't pull in sibling audits. It runs alongside other lenses only when an orchestrator (ux-design-review) or a generative skill calls it under docs/orchestration-policy.md, where it sits in Tier A — always-relevant, auto-runs. Explicit scope always wins.


The 10 heuristics — what to check and what a violation looks like

Work through each. For every issue, capture: violated heuristic, severity, what's wrong, fix.

1. Visibility of system status

The system should always keep users informed about what's happening through timely feedback. A good interface answers: What just happened? Where am I? What's happening now? What's next?

Flag when: an action produces no feedback (button click with no state change, form submits with no confirmation); loading/processing has no indicator; the user's current location in a flow is unclear; background operations (saving, syncing, uploading) are silent.

  • ❌ User taps "Save" and nothing visibly changes — did it work?
  • ✅ "Save" shows a spinner, then a checkmark + "Saved" with a timestamp.

2. Match between the system and the real world

Speak the user's language — familiar words, phrases, concepts — not system or developer jargon. Follow real-world conventions and expected ordering.

Read the full file on GitHub · 193 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 193 lines · 68 tokens per session scan A cd0b83010b18

Subscribe to this mod's changes

ux-heuristics-audit is a skill published in the GitHub repository Uxcel-Lab/product-skills (10 stars, last pushed 2mo ago), licensed MIT. It adds 68 tokens to every session and 2,664 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

pm-brand-motion

A guided process for defining a brand's motion style and making a logo animation demonstration.

konglong87/superPM · 77 tokens

pm-proto

A product-prototyping workflow for planning how an application should work and what its screens should contain. It connects product requirements to interface layouts and interactions.

konglong87/superPM · 55 tokens

diagram-design

Create branded architecture, IT current-state, flowchart, sequence, state machine, ER/data model, timeline, swimlane, quadrant, radar/spider, polar chart (polar/radial lollipop), loop/flywheel, nested, tree, org chart, layer stack, Venn, pyramid/funnel, treemap, bar, line, Gantt and scatter charts, high-level…

aiskillstore/marketplace · 188 tokens

design-mobile-apps

Use when the user wants to design a mobile app or UI screens, when they mention their Sleek (sleek.design) projects, or when implementing Sleek designs in code (HTML, React Native, SwiftUI).

aiskillstore/marketplace · 49 tokens

dengguang-zhaoming-bikeng-zhinan

A Chinese-language knowledge guide about home lighting, including ceiling lights, light strips, color temperature, color rendering, and room zoning.

aiskillstore/marketplace · 99 tokens

appllama-app-design-skill

Build native-feeling, benchmark-quality mobile app screens (Expo / React Native). Use when designing or implementing any mobile UI — screens, flows, onboarding, paywalls, tab bars, sheets, settings, empty states — or when polishing motion, navigation, typography, dark mode, or perceived performance. Enforces Apple HIG…

aiskillstore/marketplace · 184 tokens