plan-user-flows
Skill4 starsChanged 19 days agoMITView on GitHub
Plan user flows and screen states for a Figma design before any designing starts. Use when asked to plan a user flow, map out screens for a feature, define screen states, plan a Figma file structure, or work out what needs to be designed before opening Figma. Produces a complete flow map with all screens, states, entry/exit points, and a suggested Figma page structure.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- schudarin/chudarin-design-skillsword for word, first seen Oct 26, 2026
Other versions1 project uses a version of this.
Word for word · 1
- schudarin/chudarin-design-skills★ 4100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository6 other files it gives its agents.
- audit-design-systemSkill
- design-screensSkill
- design-slidesSkill
- figma-fix-variable-bindingsSkill
- figma-plugin-api-rulesSkill
- writing-textsSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 47
If yes: [Screen N]
- Distinctive: line 48
If no: [Screen X]
- Distinctive: line 74
When the map goes on the canvas as blocks and arrows:
- Distinctive: line 75
If the user gives an example board, read it through the API — sizes, colours, text styles, connector ends — not from a screenshot, and ask …
- Distinctive: line 77
Place blocks on one grid, left to right in the order of the path.
- Distinctive: line 79
Before showing, walk the connector graph: every block except an entry has an incoming connector, every block except a final exit has an …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Figma Plan User Flows
Plans what needs to be designed before a pixel is touched — mapping all screens, states, entry points, and edge cases so designers do not discover missing states mid-build.
Required Inputs
- Feature or task being designed
- User type (who performs this flow?)
- Platform (iOS / Android / Web / Multi-platform)
- Starting point (where does the user begin?)
- Known edge cases (optional)
Output Structure
1. Flow Overview
Feature, user, goal, entry points, success exit, failure exits.
A flow that puts the user into a mode — a queue walk, a wizard, a guided pass — also maps three paths: where each exit lands, by screen; what an outside event does mid-mode (a new message, opening another item) and what the user sees next; how the user gets back in, and whether progress is kept. Each is a row in the screen map, not a note.
2. Screen Map
| # | Screen name | Type | Triggered by | Notes |
| 1 | [Screen] | New/Modal/Drawer/Toast | [What triggers] | [Considerations] |
Screen types to cover: entry, happy path, loading, success, error (network/validation/permission), empty, first-time/onboarding, edge cases.
3. State Matrix
[Screen name]
| State | Trigger | Visual change | Action available |
| Default | Page load | [Description] | [What user can do] |
| Loading | User taps action | Skeleton/spinner | None |
| Error | API failure | Error message | Retry/Go back |
| Empty | No data | Empty state | [CTA] |
4. Decision Points
Decision: [Name]
- If yes: [Screen N]
- If no: [Screen X]
5. Suggested Figma File Structure
Feature name/
- Cover
- Flow Map
- Happy Path
- Error States
- Empty States
- Edge Cases
- Handoff6. What Not to Design Yet
[Explicit out-of-scope items — prevents scope creep]
Quality Checks
- Loading, error and empty are covered for what this feature adds; states that reused components already handle are listed by component name, not mapped as new screens; every state traces to a source or is marked as a question
- All decision points mapped with both branches
- Entry points include all realistic user paths
- Out-of-scope section is explicit
- Figma file structure matches screen map
Drawing the map in Figma
When the map goes on the canvas as blocks and arrows:
- If the user gives an example board, read it through the API — sizes, colours, text styles, connector ends — not from a screenshot, and ask what each colour or mark means. Without an example, use the default style below; do not invent one.
- Build inside the frame the user prepared for the map, not in new frames next to it.
- Place blocks on one grid, left to right in the order of the path.
- End every connector on a block, never on the frame that holds the scheme.
- Before showing, walk the connector graph: every block except an entry has an incoming connector, every block except a final exit has an outgoing one. Fix or list the ones that fail.
Default style. Four colour roles; when the file has colour variables, map each role to the closest one, otherwise use the values given.
| Role | Default | Used for |
| Accent | #3a88f5 | text, other paths, key block fill, outlines |
| Tint | #dfecfd | block fill |
| Grid | #daf0ff | canvas grid lines |
| Main path | #ff62b2 | the main path's connectors, marks |
- Font: the file's main sans family; Inter when the file has none. Only Bold and Medium are used — check both styles exist before the first text write.
- Canvas: white frame with a 1 px grid in the Grid colour.
- Step: 394 wide, Tint fill, radius 35, vertical auto-layout, padding 40, gap 24; title Bold 36 and description Medium 18 in Accent.
- Entry or short block: horizontal, height 127, padding 40, width hugs the title; title only.
- Key block (the finish): Accent fill, white text.
- Mark on a block: pill 42 high, radius 999, padding 8/16, white Bold 20 on Main path.
- Connectors: elbowed, 2 px, arrow at the end; the main path in Main path, every other path in Accent; a two-way transition has arrows at both ends. In a Design file connectors cannot be created, only cloned — see the connectors file of
figma-plugin-api-rules. - A sub-scheme sits in an outline: 4 px Accent at 48 %, radius 144.
- Header: Bold 144, subtitle Bold 46, in Accent.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

