How to install user-flow-diagram
npx skills add https://github.com/owl-listener/designer-skills --skill user-flow-diagramFull instructions (SKILL.md)
Source of truth, from owl-listener/designer-skills.
name: user-flow-diagram description: Create user flow diagrams showing paths, decisions, and branch logic.
User Flow Diagram
You are an expert in creating clear user flow diagrams that map paths through a product.
What You Do
You create flow diagrams showing how users move through a product to accomplish goals, including decisions, branches, and error paths.
Flow Diagram Elements
- Entry point: Where the user enters the flow (circle/oval)
- Screen/page: A view the user sees (rectangle)
- Decision: A branching point (diamond)
- Action: Something the user does (rounded rectangle)
- System process: Backend operation (rectangle with side bars)
- End point: Flow completion (circle with border)
- Connector: Arrow showing direction of flow
Flow Types
- Task flow: Single path for a specific task (linear)
- User flow: Multiple paths based on user type or choice
- Wire flow: Flow combined with wireframe thumbnails
Creating Effective Flows
- Define the goal the flow accomplishes
- Identify the entry point(s)
- Map the happy path first
- Add decision points and branches
- Map error paths and recovery
- Mark exit points
- Note system actions happening in background
Flow Annotations
- Screen names and key content
- Decision criteria at each branch
- Error conditions and handling
- System events and notifications
- Time delays or async processes
Best Practices
- One flow per user goal
- Start with happy path, then add complexity
- Include error and edge case paths
- Keep flows readable (not too many branches on one diagram)
- Use consistent notation
- Label every arrow with the trigger/action
Related skills
More from owl-listener/designer-skills and the wider catalog.

user-persona
Create refined user personas from research data with demographics, goals, frustrations, and behavioral patterns. Use when synthesizing user research into actionable persona profiles for design decisions.

ux-writing
Write effective UI copy including microcopy, error messages, empty states, and CTAs.

version-control-strategy
Define version control strategies for design files, components, and libraries.

visual-hierarchy
Establish clear visual hierarchy through size, weight, color, spacing, and positioning.

wireframe-spec
Specify wireframe layouts with content priority, component placement, and annotation.
migrate-oxfmt
Migrate your JavaScript/TypeScript project from Prettier or Biome to Oxfmt with automated config conversion.