跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

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 · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add YuqingNicole/variant-design-skill --skill variant-ux

技能说明


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 saysActionLoad
"ux review" / "heuristic review" / "usability audit"Full heuristic evaluation against Nielsen's 10ux-heuristics.md + ux-psychology.md
"review this design" / "what's wrong with this UI"Heuristic scan → findings list with severityux-heuristics.md
"check usability" / "is this good UX"Walk through flow, flag violationsux-heuristics.md + ux-psychology.md
"cognitive load" / "too complex?"Cognitive load analysis → reduction suggestionsux-psychology.md
"why do users get confused here"Mental model analysis → mismatch diagnosisux-psychology.md
"affordances" / "does this look clickable"Affordance/signifier auditux-psychology.md
"dark patterns" / "is this ethical"Dark pattern scanux-psychology.md
"navigation" / "can't find" / "information architecture" / "IA"IA audit — labels, hierarchy, findabilityux-information-architecture.md
"site structure" / "how to organize" / "card sort" / "tree test"IA design or validationux-information-architecture.md
"accessibility" / "a11y" / "screen reader" / "keyboard navigation"Accessibility audit against WCAG 2.1 AAux-accessibility.md
"WCAG" / "alt text" / "aria" / "focus"Specific accessibility checkux-accessibility.md
"user testing" / "how to test this" / "usability test"Research method recommendation + test planux-research-methods.md
"what do users think" / "how do I get feedback"Research method selectionux-research-methods.md
"NPS" / "SUS" / "survey" / "interview users"Measurement framework or interview guidanceux-research-methods.md
"transition feels wrong" / "animation timing" / "state choreography" / "loading feels laggy"Component transition auditux-interaction-transitions.md
"touch target" / "thumb zone" / "mobile gesture" / "iOS vs Android"Mobile interaction auditux-mobile-patterns.md
"onboarding" / "empty state" / "first use" / "aha moment" / "activation"Onboarding flow reviewux-onboarding.md
"chart" / "dashboard" / "data viz" / "KPI card" / "which chart"Data visualization audit or recommendationux-data-visualization.md
"content model" / "taxonomy" / "multilingual" / "RTL" / "localization"Content structure reviewux-content-strategy.md
"design tokens" / "token naming" / "theming" / "dark mode architecture"Token architecture reviewux-design-tokens.md
"component spec" / "button states" / "modal behavior" / "ARIA"Component spec reviewux-component-specs.md
"design critique" / "feedback on design" / "design review meeting"Critique framework guidanceux-design-critique.md
"conversion" / "landing page" / "trust signals" / "CTA copy" / "pricing page"Conversion UX auditux-conversion-patterns.md
"error message" / "error state" / "form error" / "validation" / "recovery path" / "prevent errors"Error design audit — classification, messaging, preventionux-error-design.md
"empty state" / "no data" / "blank state" / "nothing here" / "zero state"Empty state design — all 4 typesux-empty-states.md
"notification" / "toast" / "banner" / "badge" / "push notification" / "alert priority"Notification system design and priority rulesux-notifications.md
"table" / "data table" / "sorting" / "filtering" / "pagination" / "bulk select" / "row actions"Table and list interaction designux-tables-lists.md
"search" / "autocomplete" / "search results" / "search bar" / "faceted search" / "command palette"Search pattern design — input, suggestions, resultsux-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\
阅读完整来源 ↗