ux-antipatterns

Installation
SKILL.md

UX Anti-Pattern Detection

Scan frontend code for patterns that cause user frustration.

Core Axioms

Before checking individual rules, internalize these. They are the "why" behind every item below.

# Axiom One-liner
1 Acknowledge every action Every user action must produce visible feedback within 100ms, even if the result takes seconds.
2 Never destroy user input Not on error, not on navigation, not on timeout, not on refresh.
3 State survives the unexpected Refresh, double-clicks or double submits, network loss — code must handle edge cases.
4 Most recent intent wins Stale responses must never overwrite a newer user action.
5 Explain every constraint If it's disabled, say why. If it failed, say how to fix it. If it succeeded, say what happened.
6 Don't fight the platform Browser conventions, OS gestures, native controls, and accessibility APIs encode billions of hours of UX research.

When NOT to Use

Installs
17
GitHub Stars
12
First Seen
Feb 6, 2026