Ux Audit

This is dogfooding as code. It spins up a browser, walks your app like an actual user (typing, clicking, watching console), and won't let you skip interactions or fake timestamps. Hard gates on console errors, 5xx responses, layout collapse, and accessibility violations mean no wiggle room on the stuff that breaks production. The interaction manifest tracks every click with timestamps, and there's an audit-the-audit meta-check that rejects rushed reports where timings look implausible. Runs eleven stress scenarios, tests responsive breakpoints, and produces a ranked findings list with reproduction steps. Use it before deploy when you need confidence that real usage patterns won't explode, not just that the DOM looks okay in a static pass.

skills.sh installs: 3K
GitHub stars: 1.1K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add jezweb/claude-skills --skill ux-audit --agent claude-code

Installs into .claude/skills of the current project.

Files

UX Audit

Walk through a live web app AS a real user. The audit is interaction-first — typing, clicking, sending, watching, screenshotting. A static DOM sweep cannot produce a verdict.

Verdict states

The audit ends in exactly one of:

Pass — Critical = 0, High = 0, all hard gates green, Interaction Manifest complete.
Conditional Pass — Critical = 0, High = 0, all hard gates green, but Medium/Low present.
Fail — at least one Critical or High finding, OR a hard gate red.
Incomplete — Interaction Manifest missing required entries, a phase wasn't run, OR the audit-the-audit meta-check fires (manifest timestamps clustered < 0.5s apart, screenshots fewer than 2 × routes, console reads fewer than 1 × routes, Phase 3 took < 1m for an exhaustive audit). Not legal to upgrade to Pass even if everything observed looked fine.

If the work doesn't include a complete Interaction Manifest, the only legal verdict is Incomplete. "It looked OK" is not Pass. A clean Pass with implausible timings is rejected — the agent must redo the audit with real interaction.