ux-audit

Installation
SKILL.md

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.

Hard gates

These auto-fail the audit. They cannot be downgraded.

Installs
1.7K
GitHub Stars
853
First Seen
Feb 18, 2026
ux-audit — jezweb/claude-skills