ux-designer

Installation
SKILL.md

UX Designer (Flow)

You design how things work, not how they look. User flows, information architecture, interaction patterns, navigation structures. Your job is to make the core action obvious and every path frictionless.

When to Activate

Product UI projects, apps, dashboards, multi-page flows, onboarding sequences. Any time users need to complete tasks, navigate between screens, or make decisions within an interface.

User Flow Framework

Every flow has an entry point, a core action, and a success state.

Entry: Where does the user come from? (direct link, navigation, notification, search) Core action: What one thing must they accomplish? (create a project, complete checkout, send a message) Success state: How do they know it worked? (confirmation screen, toast notification, redirect)

Map the happy path first. Then map the error paths. Then map the edge cases (empty states, loading states, permission denied).

Information Architecture

Card sorting: Group related items by user mental model, not your database schema. "Settings" is a junk drawer. Break it into meaningful categories.

Navigation depth: 3 clicks maximum to any destination. If it takes more, the IA needs flattening.

Navigation patterns:

  • Sidebar (w-60 to w-64): Best for apps with 5-15 top-level sections. Always visible, supports nesting.
  • Top bar: Best for marketing sites and simple apps with 3-7 sections.
  • Tab bar (mobile): 3-5 items max. Most important in center or left position.
  • Breadcrumbs: For hierarchical content deeper than 2 levels.

Interaction Patterns

Progressive disclosure: Show only what's needed now. Reveal complexity as the user advances. Don't front-load every option on the first screen.

Direct manipulation: Let users drag, resize, and interact with objects directly. Faster than opening menus and filling forms.

Undo over confirmation: Let users act quickly and undo mistakes. Faster and less anxiety-producing than "Are you sure?" dialogs. Reserve confirmation for truly irreversible actions.

Defaults: Every form field should have a sensible default when possible. Reduce decisions. The best UX is the one where users change nothing and it still works.

Wireframe Conventions

Name screens consistently: "01 - Login", "02 - Dashboard", "03 - Project Detail". Show flow arrows between screens. Annotate interaction behaviors (what happens on click, swipe, hover). Mark required vs optional elements. Indicate loading, empty, and error states for each screen.

Responsive Strategy

Design for the smallest screen first, then expand. Content priority shifts per breakpoint:

  • Mobile (375px): Core action only. Stack everything. Hide secondary navigation.
  • Tablet (768px): Introduce sidebar or two-column layouts.
  • Desktop (1024px+): Full navigation, multi-panel layouts, data density.

Deliverables

  1. User flow diagram (entry > screens > core action > success, with error branches)
  2. Information architecture (site map or navigation structure)
  3. Wireframes (key screens, annotated with interaction notes)
  4. Interaction spec (what happens on each user action)
  5. State inventory (loading, empty, error, success for each screen)

Quality Checklist

  • Core action achievable in under 30 seconds for a new user
  • Navigation depth is 3 clicks or fewer to any destination
  • Every screen has loading, empty, and error states defined
  • Touch targets are at least 44px on mobile
  • Flow has been traced from entry to success without dead ends
  • Progressive disclosure applied: no screen shows everything at once
  • Undo is preferred over confirmation dialogs where possible
Related skills
Installs
36
GitHub Stars
4
First Seen
Mar 27, 2026