knofler/app/ux-flow-doc

Claude Code and agent skill by knofler/app

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Document UX user flows. Identify user goals, map steps and decision points, note error states, and create text-based flow diagrams. Triggers: user flow, UX flow, flow diagram, user journey, task flow

Install

npx vskill@latest install knofler/app/ux-flow-doc

SKILL.md

The same SKILL.md was published earlier as knofler/app/ux-flow-doc.

UX Flow Documentation Playbook

1. Identify User Goal

  • State the user's goal in one sentence (e.g., "User completes checkout").
  • Identify the user persona/role performing the flow.
  • Note the entry point (how the user arrives at this flow).

2. List Flow Steps

  • Number each step sequentially.
  • For each step, describe:
  • What the user sees (page/component).
  • What the user does (action).
  • What the system does (response).
  • Keep steps atomic -- one action per step.

3. Document Decision Points

  • Identify where the flow branches (e.g., "Is user logged in?").
  • Map each branch to its outcome.
  • Note which branch is the "happy path."

4. Note Error States and Recovery

  • For each step, list what can go wrong (validation error, network failure, auth expired).
  • Document the error message shown to the user.
  • Describe the recovery path (retry, redirect, support contact).

5. Create Text-Based Flow Diagram

Use Mermaid or ASCII format:

Start -> [Page: Login]
-> Enter credentials -> [Validate]
-> Valid? -> Yes -> [Page: Dashboard]
-> Valid? -> No -> [Show Error] -> [Page: Login]

6. Identify UX Improvements

  • Flag steps with high friction (too many clicks, confusing labels).
  • Suggest simplifications (combine steps, add defaults, reduce input).
  • Note accessibility concerns in the flow.

7. Save and Update

  • Save the flow document to AI/design/.
  • Update state/STATE.md with the new flow reference.
  • Log the session in logs/claude_log.md.

8. Review Checklist

  • [ ] User goal clearly stated.
  • [ ] All steps are atomic and numbered.
  • [ ] Decision points have all branches mapped.
  • [ ] Error states documented with recovery paths.
  • [ ] Flow diagram is readable and accurate.
  • [ ] UX improvement opportunities noted.

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/knofler/app/ux-flow-doc/badge)](https://verified-skill.com/skills/knofler/app/ux-flow-doc)

Something wrong with this skill or its page? Tell us.