agentleFS
schudarinschudarin/chudarin-figma-skills/skills/plan-user-flows/SKILL.md

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

  • Other versions1 project uses a version of this.

    Word for word · 1

    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.

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
  1. Distinctive:

    If yes: [Screen N]

    line 47
  2. Distinctive:

    If no: [Screen X]

    line 48
  3. Distinctive:

    When the map goes on the canvas as blocks and arrows:

    line 74
  4. Distinctive:

    If the user gives an example board, read it through the API — sizes, colours, text styles, connector ends — not from a screenshot, and ask …

    line 75
  5. Distinctive:

    Place blocks on one grid, left to right in the order of the path.

    line 77
  6. Distinctive:

    Before showing, walk the connector graph: every block except an entry has an incoming connector, every block except a final exit has an …

    line 79

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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 nameTypeTriggered byNotes
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]

StateTriggerVisual changeAction available
DefaultPage load[Description][What user can do]
LoadingUser taps actionSkeleton/spinnerNone
ErrorAPI failureError messageRetry/Go back
EmptyNo dataEmpty 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
- Handoff

6. 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.

RoleDefaultUsed for
Accent#3a88f5text, other paths, key block fill, outlines
Tint#dfecfdblock fill
Grid#daf0ffcanvas grid lines
Main path#ff62b2the 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.