# ux-flow-plan

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 147 installs · ★ 107 repo stars
- Author: jnsahaj
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jnsahaj/skills/tree/HEAD/skills/ux-flow-plan/SKILL.md
- Updated: 2026-10-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ux-flow-plan

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add jnsahaj/skills --skill ux-flow-plan -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ux-flow-plan/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ux-flow-plan/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add jnsahaj/skills --skill ux-flow-plan -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ux-flow-plan/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add jnsahaj/skills --skill ux-flow-plan -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ux-flow-plan/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jnsahaj/skills skills/ux-flow-plan
```

2. **Manually: put the files in place**
- File: `.github/skills/ux-flow-plan/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add jnsahaj/skills --skill ux-flow-plan -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/jnsahaj/skills --path skills/ux-flow-plan
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ux-flow-plan/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add jnsahaj/skills --skill ux-flow-plan -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/jnsahaj/skills/tree/HEAD/skills/ux-flow-plan/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [flow-next-plan](https://affpapa.org/en/nevibecode/skills/flow-next-plan.md) — skill · ★ 730 repo stars
- [plan-design-review](https://affpapa.org/en/nevibecode/skills/garrytan-plan-design-review.md) — skill · 543 installs
- [speckit-plan](https://affpapa.org/en/nevibecode/skills/speckit-plan.md) — skill · 2600 installs
- [omc-plan](https://affpapa.org/en/nevibecode/skills/omc-plan.md) — skill · 838 installs
- [html-plan](https://affpapa.org/en/nevibecode/skills/thariq-shihipar-html-plan.md) — skill · ★ 4931 repo stars
- [rpi-plan](https://affpapa.org/en/nevibecode/skills/rpi-plan.md) — skill · ★ 1627 repo stars

From the same set: [jnsahaj/skills](https://affpapa.org/en/nevibecode/by/jnsahaj/skills.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
