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
npx skills add jnsahaj/skills --skill ux-flow-plan -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/ux-flow-plan/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ux-flow-plan/
1Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill ux-flow-plan -a codex2Manually: put the files in place
.agents/skills/ux-flow-plan/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill ux-flow-plan -a cursor2Manually: put the files in place
.cursor/skills/ux-flow-plan/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jnsahaj/skills skills/ux-flow-plan2Manually: put the files in place
.github/skills/ux-flow-plan/SKILL.md1Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill ux-flow-plan -a gemini-cli2Platform CLI
gemini skills install https://github.com/jnsahaj/skills --path skills/ux-flow-planManually: put the files in place
.devin/skills/ux-flow-plan/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill ux-flow-plan -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.