ux-audit
A UX audit by Nielsen’s 10 heuristics and a cognitive walkthrough, with evidence for every finding.
A finding like “the onboarding feels clunky” cannot be checked. Each one here names a heuristic, a severity and the screenshot or step it was seen on, so a team can verify it and rank it.
- 2026
- Claude Code
- A browser tool, web search
- MIT
View on GitHub (opens in a new tab)
git clone https://github.com/VladPolyakov-art/ux-audit ~/.claude/skills/ux-auditWhat it writes
Fixed file names, so the other skills in the kit find them without asking. Each file also gets a row in research/INDEX.md.
- research/ux-audit/<product>/audit_report.md
- Walkthrough, a verdict on each of the 10 heuristics, the problem table, top 5 recommendations.
- research/ux-audit/<product>/user_flow.md
- The steps that were walked.
- research/ux-audit/<product>/screenshots/
- Numbered evidence.
- research/ux-audit/summary.md
- A comparison across products, when there is more than one.
How it works
- Evidence or nothingEvery finding points to a captured page or a screenshot you supplied. No evidence, no finding.
- Says how it lookedEach product is marked verified or assumed. Findings from docs or old screenshots are never presented as observed.
- Safe by defaultPublic part only: no sign-up, no logging in, no form submission. A sign-up wall is itself a finding.
What the agent does
- ScopeWhat is audited, which scenario to walk, which persona. A first-time user by default.
- CaptureWalks the live flow with a browser tool, or puts your screenshots in order.
- WalkthroughPer step: will the user know what to do, find the control, connect it to the action, see that it worked.
- HeuristicsEach screen against Nielsen’s 10, plus a quick accessibility glance.
- SeverityFrom 0 to 4, by how often it hits, how hard it is to get past and whether it repeats.
- ReportProblems split into design, unfinished and sensitive, top 5 recommendations for your product.
Works with the kit
None of these is required. With an empty research/ folder it works from what you give it, and when a sibling’s file is there, it reuses it instead of redoing the work.
Reads
- competitive-researchThe products and URLs to audit.
- proto-personasThe persona for the walkthrough.
- simulated-interviewThe persona’s expectations, as hints only.
- feature-researchBackground on a feature under audit.
Read by
- proto-personasUsability pains in current solutions.
- feature-researchCurrent-state problems around the feature.
- simulated-interviewConcrete friction for past-behaviour questions.
- competitive-researchObserved UX of a competitor.
Part of the Product research kit: six skills, one research/ folder and one set of evidence tags.