skills/ux-validate-flow/SKILL.md
Step 3.3 of Sketch the Solution. Cross-check flow diagram against user stories to find gaps. Use when asked to 'validate flow', 'test user flow', 'check flow against stories', or 'flow validation'.
npx skillsauth add arndvs/ctrlshft ux-validate-flowInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Output "Read UX Validate Flow skill." to chat to acknowledge you read this file.
Phase: /ux-flow-diagram → Step 3 of 3
Read each user story and trace the path through the flow diagram. Identify missing screens, dead ends, and friction points.
For each user story, trace the user's journey through the flow:
Log each validation:
## Flow Validation Log
### [Avatar]'s Story: [Goal]
- **Entry:** Landing Page
- **Path:** Landing → Login → Dashboard → Content Feed → Search → View Content
- **Goal reached:** ✓ Yes / ✗ No
- **Gaps found:** [e.g., "No comment feature — user expects to reply but no screen supports it"]
- **Friction:** [e.g., "3 clicks to reach content — could be 2"]
Fix gaps — add missing screens or paths to the flow diagram
Identify MVP scope — highlight which screens/paths are essential for V1:
## MVP Scope
| Screen | MVP? | Rationale |
|--------|------|-----------|
| Landing | ✓ | Entry point |
| Login | ✓ | Required |
| Dashboard | ✓ | Core experience |
| Reports | ✗ | V2 — nice to have |
Append to flow-diagram.md: Validation Log, Gap Analysis, and MVP Scope table.
development
Use when implementing UI, checking dark/light mode, or validating animations — adds a visual feedback loop via browser screenshots so frontend changes are verified, not assumed.
development
Use when Claude Code sessions had many manual approval ("press 1") prompts or when auditing hook permissions; identifies which Bash commands required approval.
tools
Use after merging a PR or during periodic cleanup to archive plan-mode files by linking them to merged PRs.
testing
Use when stress-testing a plan against the project's domain model — grills the design, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise.