user-flow-diagramming

Map user flows from entry points to outcomes with actors and decisions.

1|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/SSiertsema/claude-code-plugins --skill user-flow-diagramming
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-flow-diagramming
Source: https://github.com/SSiertsema/claude-code-plugins/tree/main/user-flow-diagramming/skills/user-flow-diagramming
Command: npx skills add https://github.com/SSiertsema/claude-code-plugins --skill user-flow-diagramming

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagramming user flows helps product and design teams map tasks, decisions, and system responses to prevent gaps, miscommunications, and missed requirements.

Core Features & Use Cases

  • Flow capture: capture task name, entry points, actors, outcomes, and flow types.
  • Phase-driven decomposition: break flows into steps, decisions, and instrumentation points.
  • Documentation for handoffs: produce diagrams and reports for product/design teams to review.

Quick Start

Diagram the user flow for a given task by specifying the task name, entry points, actors, and expected outcomes to generate a complete user-flow diagram.

Frequently Asked Questions about user-flow-diagramming

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Mermaid flowchart for UX journey mapping?

To generate a Mermaid flowchart for UX journey mapping, specify the task name, entry points, actors, and expected outcomes. The Skill decomposes flows into steps, decisions, and instrumentation points, outputting both Mermaid diagrams and a structured table.

What is a user flow diagram and when do I need one for product discovery?

A user flow diagram maps tasks, decisions, and system responses from entry points to outcomes. You need one during product discovery and feature refinement to prevent gaps, miscommunications, and missed requirements across actors and decision points.

Can I map user flows without specifying actor roles and entry points?

No, mapping user flows requires explicit flow types, actor roles, and entry points. Providing these details ensures the phase-driven decomposition accurately captures decisions and instrumentation points down to the final outcomes.

What is the best way to document user flow decisions for design handoffs?

The best way to document user flow decisions for handoffs is using phase-driven decomposition to capture steps, decisions, and instrumentation points. This produces Mermaid diagrams and structured reports for product and design teams to review.

Does this user flow diagramming approach output structured step tables or only visual diagrams?

This user flow diagramming approach outputs both visual Mermaid diagrams and structured step/decision tables. It breaks flows into phases, capturing task names, entry points, actors, and outcomes for comprehensive product and design documentation.