user-flow
Create a user flow with structured process, quality checks, and system integration
SKILL.md.claude/skills/design/user-flow/SKILL.md
GitHubUser Flow
Purpose
Create a comprehensive user flow that delivers actionable, measurable results. This skill provides a structured process with quality validation, ensuring professional-grade output every time.
Category: Design & Creative
Inputs
Required
- Objective: What you want to achieve with this deliverable
- Context: Relevant background information
Optional
- Constraints: Any limitations or requirements to consider
- Existing Work: Previous documents or data to build on
System Context
Before starting:
- Read
memory.mdfor current project context and priorities - Check
knowledge-base.mdfor relevant learned rules or constraints - Review any existing related documents in the project
- Note any active tasks in
Task Board.mdthat relate to this deliverable
Process
Step 1: Context & Research
- Review any existing user flow documents in the project
- Check knowledge-base.md for relevant learned rules or constraints
- Check memory.md for current project context and priorities
- Identify key stakeholders and their requirements
- Select the most appropriate framework: Design Thinking (5 stages), Double Diamond, Atomic Design
Step 2: Analysis & Framework Application
- Apply the selected framework to structure the user flow
- Identify gaps, opportunities, and risks
- Define success metrics: Task Completion Rate, Time on Task, Error Rate, System Usability Scale (SUS)
- Document assumptions and dependencies
- Validate approach against industry best practices
Step 3: Build the Deliverable
- Structure the user flow using the output format below
- Include specific, actionable recommendations — not generic advice
- Add concrete numbers, timelines, and benchmarks where applicable
- Cross-reference with existing project documents for consistency
- Ensure every section adds value — remove filler
Step 4: Quality Validation
- All required inputs have been addressed
- Recommendations are specific and actionable (not vague)
- Numbers and benchmarks are realistic and sourced
- Output format matches the specification below
- No contradictions with knowledge-base rules
- Follows best practice: Start with user research, not aesthetics
Output Format
# User Flow
## Executive Summary
[2-3 sentence overview of the deliverable and key recommendations]
## Context & Objectives
- **Objective**: [What this achieves]
- **Audience**: [Who this is for]
- **Timeline**: [When this applies]
## Analysis
[Structured analysis using the selected framework]
## Recommendations
1. [Specific, actionable recommendation with expected impact]
2. [Specific, actionable recommendation with expected impact]
3. [Specific, actionable recommendation with expected impact]
## Implementation
| Action | Owner | Timeline | Priority |
|--------|-------|----------|----------|
| [Action item] | [Who] | [When] | [High/Medium/Low] |
## Success Metrics
| Metric | Current | Target | Measurement Method |
|--------|---------|--------|-------------------|
| [KPI] | [Baseline] | [Goal] | [How to measure] |
## Risks & Mitigations
| Risk | Likelihood | Impact | Mitigation |
|------|-----------|--------|------------|
| [Risk] | [H/M/L] | [H/M/L] | [Action] |
## Next Steps
- [ ] [Immediate next action]
- [ ] [Follow-up action]
- [ ] [Review date]
Applicable Frameworks
- Design Thinking (5 stages)
- Double Diamond
- Atomic Design
- Design Sprint
- Material Design / Human Interface Guidelines
- WCAG 2.1 AA
Key Metrics
- Task Completion Rate
- Time on Task
- Error Rate
- System Usability Scale (SUS)
- Accessibility Score
- Design System Adoption Rate
Best Practices
- Start with user research, not aesthetics
- Maintain a living design system
- Test with 5 users to find 85% of usability issues
- Accessibility is not optional — design for it from day one
- Document design decisions and rationale
After Completion
- Update
memory.mdif this deliverable changes project context or priorities - Add any reusable learnings to
knowledge-nominations.md - If follow-up actions were identified, add them to
Task Board.md - Recommend related skills if additional work is needed