Skill

nw-ux-principles

Core UX principles for product owners. Load when evaluating interface designs, writing acceptance criteria with UX requirements, or reviewing wireframes and mockups.

From nw
Install
1
Run in your terminal
$
npx claudepluginhub nwave-ai/nwave --plugin nw
Tool Access

This skill uses the workspace's default tool permissions.

Skill Content

UX Principles

Evidence-based UX fundamentals for guiding interface design during requirements gathering. Use to evaluate designs, write better AC, and ask the right questions during discovery.

Nielsen's 10 Usability Heuristics

Apply when reviewing any interface design or writing AC.

#HeuristicProduct Owner Action
1Visibility of system statusRequire feedback for every action within 100ms. Status indicators for all async ops.
2Match system and real worldBan internal jargon from UI. Use domain language from user research.
3User control and freedomEvery destructive action needs undo or confirmation. Navigation always allows going back.
4Consistency and standardsRequire design system. Audit for inconsistent terminology across features.
5Error preventionRequire input validation, constraints, confirmation for irreversible actions.
6Recognition over recallPrefer dropdowns over free text when options known. Show recent items. Contextual help.
7Flexibility and efficiencyRequire keyboard shortcuts for frequent actions. Support mouse and keyboard workflows.
8Aesthetic and minimalist designChallenge every UI element: does it serve current task? Remove decorative clutter.
9Help with errorsError messages state what happened, why, and what to do next. No raw error codes.
10Help and documentationRequire contextual help (tooltips, inline guidance). Documentation by task, not feature.

Heuristic Evaluation Questions

For each screen or workflow under review:

  1. Is system status visible? (loading, saving, errors, success)
  2. Does language match user's vocabulary?
  3. Can users undo or escape from any state?
  4. Are similar things named and behaving consistently?
  5. Are error-prone situations prevented or confirmed?
  6. Are options visible rather than requiring recall?
  7. Are there shortcuts for frequent actions?
  8. Is every visible element necessary for current task?
  9. Do error messages explain problem and solution?
  10. Is contextual help available?

Score each 0 (no problem) to 4 (usability catastrophe). Fix 3s and 4s before launch.

Don Norman's Design Principles

Six principles explaining why some interfaces feel intuitive.

Affordances: What actions an object allows. Digital affordances must be made visible since screens lack physical properties. Button affords clicking; slider affords dragging.

Signifiers: Visual indicators communicating where and how to act. Blue underlined word signifies "clickable." Affordances define possibility; signifiers make it discoverable.

Mapping: Relationship between controls and effects. Natural mapping uses spatial correspondence (volume slider up = increase). Poor mapping forces memorization.

Feedback: Every action must produce perceptible feedback. Silence after action is most common source of confusion. Must be immediate, informative, proportional.

Constraints: Limitations guiding correct action. Graying out unavailable options (logical) | red means stop (cultural) | USB plug fits one way (physical).

Conceptual Models: Mental image users form about system behavior. When user's model matches system model, interface feels intuitive. Build accurate models through visible structure and consistent behavior.

Applying Norman's Principles in Requirements

  • For every interactive element: what does it afford? How is that signified?
  • For every control: is mapping between action and effect natural?
  • For every action: what feedback confirms it worked?
  • For every error path: what constraints could prevent the error?

Cognitive Load Laws

Fitts's Law

Time to reach a target depends on distance and size.

  • Make primary action buttons large and close to cursor's likely position
  • Place destructive actions away from constructive ones
  • Screen edges are easy targets (infinite edge) -- use for important controls
  • Minimum touch targets: 44x44px (Apple) or 48x48dp (Material Design)

Hick's Law

Decision time increases with number and complexity of choices.

  • Limit primary navigation to 5-7 items
  • Use progressive disclosure to hide advanced options
  • Break complex decisions into smaller sequential steps
  • Highlight recommended options to reduce decision paralysis

Miller's Law

Working memory holds approximately 7 (plus or minus 2) items.

  • Chunk information into groups of 3-5 items
  • Use visual grouping (cards, sections, whitespace) to aid scanning
  • Do not require remembering info across pages
  • Display codes/numbers in chunks (phone numbers, credit cards)

Progressive Disclosure

Resolves tension between simplicity for novices and power for experts.

Core rule: Show most important options first. Reveal specialized options on request.

Two success factors: 1. Correctly splitting features between initial and secondary views (requires user research) | 2. Making path to advanced features obvious through visible, well-labeled controls

Design limits: Most interfaces work best with max two disclosure levels. Three or more causes disorientation.

Distinct from wizards: Progressive disclosure uses hierarchical navigation (return to initial view). Wizards use linear sequences.

Accessibility Essentials (WCAG 2.2 AA)

Four principles (POUR) -- the minimum a product owner must require.

PrincipleKey Requirements
PerceivableText alternatives for images
OperableFull keyboard operation
UnderstandableReadable text
RobustValid semantic HTML

Product Owner Minimums

  • 4.5:1 contrast ratio for normal text, 3:1 for large text
  • All functionality accessible via keyboard
  • Focus indicators visible on all interactive elements
  • Minimum target size 24x24 CSS pixels
  • Form inputs have associated labels
  • Error messages identify field and suggest correction
  • Page has descriptive title

UX Review Checklist

Use when reviewing designs or writing AC.

Visibility and Feedback

  • Every action produces visible feedback within 100ms
  • Loading states shown for operations >1 second
  • Success confirmations for state-changing actions
  • Error states with recovery guidance

Navigation and Orientation

  • User can answer: Where am I? Where can I go? How do I get back?
  • Primary navigation has 7 or fewer items

Cognitive Load

  • Choices per decision point <= 7
  • Information chunked into scannable groups
  • Progressive disclosure hides advanced options
  • No requirement to remember info across pages

Accessibility

  • Contrast ratio >= 4.5:1 for text
  • All functionality accessible via keyboard
  • Focus indicators visible
  • Touch/click targets >= 24x24px
  • Form fields have associated labels

Consistency

  • Same action looks and behaves the same everywhere
  • Terminology consistent throughout
  • Platform conventions followed
Stats
Parent Repo Stars299
Parent Repo Forks37
Last CommitMar 20, 2026