variant-ux
UX Review mode — heuristic evaluation (Nielsen's 10), cognitive load analysis, mental model diagnosis, affordance audit, dark pattern detection — grounded in NNG research. Load references/ux-heuristics.md and references/ux-psychology.md. Triggers on: ux review, heuristic evaluation, usability audit, cognitive load, mental models, affordances, dark patterns, review this design, check usability, is this good UX
YuqingNicole · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add YuqingNicole/variant-design-skill --skill variant-uxAbout this skill
name: variant-ux description: UX Review mode — heuristic evaluation (Nielsen's 10), cognitive load analysis, mental model diagnosis, affordance audit, dark pattern detection — grounded in NNG research. Load references/ux-heuristics.md and references/ux-psychology.md. Triggers on: ux review, heuristic evaluation, usability audit, cognitive load, mental models, affordances, dark patterns, review this design, check usability, is this good UX
UX Review Mode
When the user wants to evaluate usability rather than generate visuals, switch to UX Review mode. Load references/ux-heuristics.md and references/ux-psychology.md. Load additional references as the review scope demands (see "When to Load Which Reference" below).
Triggers
| User says | Action | Load |
|---|---|---|
| "ux review" / "heuristic review" / "usability audit" | Full heuristic evaluation against Nielsen's 10 | ux-heuristics.md + ux-psychology.md |
| "review this design" / "what's wrong with this UI" | Heuristic scan → findings list with severity | ux-heuristics.md |
| "check usability" / "is this good UX" | Walk through flow, flag violations | ux-heuristics.md + ux-psychology.md |
| "cognitive load" / "too complex?" | Cognitive load analysis → reduction suggestions | ux-psychology.md |
| "why do users get confused here" | Mental model analysis → mismatch diagnosis | ux-psychology.md |
| "affordances" / "does this look clickable" | Affordance/signifier audit | ux-psychology.md |
| "dark patterns" / "is this ethical" | Dark pattern scan | ux-psychology.md |
| "navigation" / "can't find" / "information architecture" / "IA" | IA audit — labels, hierarchy, findability | ux-information-architecture.md |
| "site structure" / "how to organize" / "card sort" / "tree test" | IA design or validation | ux-information-architecture.md |
| "accessibility" / "a11y" / "screen reader" / "keyboard navigation" | Accessibility audit against WCAG 2.1 AA | ux-accessibility.md |
| "WCAG" / "alt text" / "aria" / "focus" | Specific accessibility check | ux-accessibility.md |
| "user testing" / "how to test this" / "usability test" | Research method recommendation + test plan | ux-research-methods.md |
| "what do users think" / "how do I get feedback" | Research method selection | ux-research-methods.md |
| "NPS" / "SUS" / "survey" / "interview users" | Measurement framework or interview guidance | ux-research-methods.md |
| "transition feels wrong" / "animation timing" / "state choreography" / "loading feels laggy" | Component transition audit | ux-interaction-transitions.md |
| "touch target" / "thumb zone" / "mobile gesture" / "iOS vs Android" | Mobile interaction audit | ux-mobile-patterns.md |
| "onboarding" / "empty state" / "first use" / "aha moment" / "activation" | Onboarding flow review | ux-onboarding.md |
| "chart" / "dashboard" / "data viz" / "KPI card" / "which chart" | Data visualization audit or recommendation | ux-data-visualization.md |
| "content model" / "taxonomy" / "multilingual" / "RTL" / "localization" | Content structure review | ux-content-strategy.md |
| "design tokens" / "token naming" / "theming" / "dark mode architecture" | Token architecture review | ux-design-tokens.md |
| "component spec" / "button states" / "modal behavior" / "ARIA" | Component spec review | ux-component-specs.md |
| "design critique" / "feedback on design" / "design review meeting" | Critique framework guidance | ux-design-critique.md |
| "conversion" / "landing page" / "trust signals" / "CTA copy" / "pricing page" | Conversion UX audit | ux-conversion-patterns.md |
| "error message" / "error state" / "form error" / "validation" / "recovery path" / "prevent errors" | Error design audit — classification, messaging, prevention | ux-error-design.md |
| "empty state" / "no data" / "blank state" / "nothing here" / "zero state" | Empty state design — all 4 types | ux-empty-states.md |
| "notification" / "toast" / "banner" / "badge" / "push notification" / "alert priority" | Notification system design and priority rules | ux-notifications.md |
| "table" / "data table" / "sorting" / "filtering" / "pagination" / "bulk select" / "row actions" | Table and list interaction design | ux-tables-lists.md |
| "search" / "autocomplete" / "search results" / "search bar" / "faceted search" / "command palette" | Search pattern design — input, suggestions, results | ux-search-patterns.md |
UX Review Workflow
Two paths depending on what's available:
- Code in cwd → run Code Scan (Steps 1a–1b) first, then layer conceptual analysis
- No code / screenshots / description only → skip to Step 2
Step 1a: Auto-detect project files
# Find component files in cwd (skip node_modules, .git, dist)
find . \( -name "*.tsx" -o -name "*.jsx" -o -name "*.vue" -o -name "*.svelte" -o -name "*.html" \) \
-not -path "*/node_modules/*" -not -path "*/.git/*" -not -path "*/dist/*" | head -30
If files found, proceed to Step 1b. Otherwise skip to Step 2.
Step 1b: Code-level heuristic scan
Run these greps against the found files. Each maps to a specific heuristic:
# H9 — Generic error messages (critical pattern)
grep -rn "error occurred\|something went wrong\|invalid input\|please try again\|An error\|Unknown error" \
--include="*.tsx" --include="*.jsx" --include="*.vue" --include="*.html" \
--exclude-dir=node_modules --exclude-dir=dist . 2>/dev/null
# H1 — Missing loading states: async handlers without loading flag
grep -rn "onClick\|onSubmit\|handleSubmit" \
--include="*.tsx" --include="*.jsx" --exclude-dir=node_modules . 2>/dev/null | head -20
# (then read those files to check if loading/disabled state is managed)
# H3 — Destructive actions: delete/remove calls without confirmation guard
grep -rn "delete\|remove\|destroy\|clearAll\|reset" \
--include="*.tsx" --include="*.jsx" -i --exclude-dir=node_modules . 2>/dev/null | \
grep -iv "confirm\|modal\|dialog\|undo\
Read the complete source ↗