Skip to main content
skill CX Codex

ux-flow-plan — Claude Code skill: what it does, how to install

ux-flow-plan builds UX-first architecture plans as tree diagrams before mapping them to files and functions. Useful when designing features without jumping straight into code.

no license 147 installs ★ 107 updated 2026-10-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jnsahaj/skills --skill ux-flow-plan -a claude-code
Open on GitHub

What ux-flow-plan does

The skill forces the agent to step back from line edits and think through user interactions first. It begins by phrasing the feature goal in everyday product terms, then drafts two distinct tree diagrams showing the current flow alongside the target flow. Each branch tracks human inputs, system reactions, affected architectural layers, and file anchors.

Once the flow tree is established, the assistant identifies system boundaries: where events get caught, which layer manages side effects, and how state changes persist. Only after clarifying these boundaries does it list concrete functions, target paths, and test cases. Attempting to generate code before defining the UX flow violates the skill rules.

What it helps with

  • map user journeys into flow trees before touching project code
  • compare current and target system behaviors side by side
  • isolate state mutations and side effects across architectural layers
  • link test coverage and function anchors directly to user steps

Example prompts for the agent

  • Create a UX flow plan for adding two-factor authentication to the login screen.
  • Map out the checkout redesign as flow trees before changing any handlers.
  • Outline the current and desired user paths for password recovery.

How to install ux-flow-plan

1Skills CLI (Vercel)

npx skills add jnsahaj/skills --skill ux-flow-plan -a claude-code

2Manually: put the files in place

~/.claude/skills/ux-flow-plan/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ux-flow-plan/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ux-flow-plan

How to install ux-flow-plan in Claude Code?

Run npx skills add jnsahaj/skills --skill ux-flow-plan -a claude-code. Alternatively, copy the skill definition file to ~/.claude/skills/ux-flow-plan/SKILL.md.

What does the ux-flow-plan skill do?

It guides the assistant to structure architectural plans from user experience downward, organizing flows into trees before attaching concrete functions and files.

What components are included in the generated plan?

The output includes a product goal, current and desired flow trees, boundary responsibilities, concrete code anchors, test paths, and rejected alternatives.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set6

Project sponsors

Companies that keep this analytics open