
user-flows-and-guided-paths
Guided multi-step paths and wizards. Use when designing onboarding, checkout, setup sequences or any multi-step journey.
- Installs
- 892
- Last 24h
- +9
- Trending rank
- #9158
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/dembrandt/dembrandt-skills --skill user-flows-and-guided-paths- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads user-flows-and-guided-paths automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
User Flows and Guided Paths
Related features that belong together should be experienced as a single coherent journey — not as separate screens the user has to navigate between manually. A well-designed flow feels inevitable: each step leads naturally to the next, the user always knows where they are and what comes next, and the path fits the product's information hierarchy.
When to Guide vs. When to Let Users Explore
| Scenario | Pattern |
|---|---|
| Linear process with a clear end goal (checkout, signup, setup) | Guided step-by-step flow or wizard |
| Complex task that benefits from breaking into stages | Wizard with progress indicator |
| Feature discovery across an existing product | Contextual tooltips or coach marks |
| User returning to complete something they started | Resume prompt with clear re-entry point |
| Open-ended exploration (dashboard, settings) | Free navigation — do not force a flow |
Only guide when the task genuinely has a natural order. Forcing a wizard onto a non-sequential task frustrates users who already know what they want.
The Wizard Pattern
Use a wizard when:
- The task has 3 or more sequential steps
- Later steps depend on decisions made in earlier steps
- Doing all steps on one screen would overwhelm the user
Wizard anatomy
[Step indicator: 1 of 4]
Step title
[Form content for this step]
[Back] [Continue →]
Step indicator: Always show the user where they are in the sequence and how many steps remain. A progress bar or numbered steps both work — numbered steps are clearer when step names are meaningful.
Back navigation: Always available. Users must be able to go back and change earlier decisions without losing their progress on later steps.
Forward navigation: Disabled until the current step is complete. Validate on Continue, not on Submit at the end.
Exit path: Make it clear how to abandon the flow without losing partial progress. Autosave drafts where possible.
Step design principles
- One primary decision or input group per step — don't overfill steps
- Step titles should describe the user's goal, not the system's: "Your delivery address" not "Address input"
- Optional steps should be clearly marked and skippable
- The final step should show a summary before committing
Purchase and Conversion Flows
Purchase flows have an additional constraint: every unnecessary step reduces conversion. Design for the shortest path to completion.
- Collect only what is required at each stage — defer optional information
- Show a persistent order summary so the user always sees what they are buying
- Surface trust signals near payment steps (security badges, return policy)
- Confirmation step before payment: show total, delivery, items — one last review
- Post-purchase: immediate confirmation with clear next steps ("Your order is confirmed. We'll email you when it ships.")
Fitting Flows into the Product Hierarchy
A guided path should feel like it belongs to the product — not like it has opened a separate experience.
- The visual style, typography, and components inside a flow should match the rest of the product
- Navigation chrome (sidebar, top nav) can be hidden during a flow to reduce distraction, but the brand header should remain visible
- After completing a flow, return the user to a meaningful place in the hierarchy — not to a generic home screen
- Deep-linking into a flow should work: a user who arrives at step 3 via email link should see step 3, not step 1
Review Checklist
- Does the flow have a clear start, a logical step order, and a definite end?
- Is a progress indicator visible at every step?
- Can the user go back to any previous step without losing later progress?
- Is each step focused on one decision or input group?
- Are step titles written in user language, describing their goal?
- Does the final step show a summary before the irreversible action?
- After completion, does the user land somewhere meaningful in the product?
- Does the flow visual style match the rest of the product?
FAQ
What does the user-flows-and-guided-paths skill do?
Guided multi-step paths and wizards. Use when designing onboarding, checkout, setup sequences or any multi-step journey.
How do I install user-flows-and-guided-paths?
Run npx skills add https://github.com/dembrandt/dembrandt-skills --skill user-flows-and-guided-paths in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/user-flows-and-guided-paths/ (personal) or .claude/skills/user-flows-and-guided-paths/ (project).
Which AI agents can use user-flows-and-guided-paths?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is user-flows-and-guided-paths safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains user-flows-and-guided-paths?
It is published by dembrandt in dembrandt/dembrandt-skills. It has 892 recorded installs.
More from dembrandt/dembrandt-skills
nielsen-usability-heuristics
dembrandt/dembrandt-skills
Nielsen's 10 usability heuristics. Use when auditing an interface, designing interaction flows, writing error messages or reviewing usability.
performance-and-web-vitals
dembrandt/dembrandt-skills
Lighthouse audits and Core Web Vitals — LCP, CLS, INP. Use when optimising page load, layout shift, input delay, images, fonts or render-blocking resources.
color-mode-and-theme
dembrandt/dembrandt-skills
Light, dark or both, and when a theme selector is worth it. Use when defining a base palette or deciding on dark mode support.
ui-density
dembrandt/dembrandt-skills
Match information density to platform and user type. Use when designing data tables, dashboards or toolbars, or adapting a desktop product for mobile.
form-design
dembrandt/dembrandt-skills
Helper text, placeholders, validation and submit behaviour. Use when designing or reviewing a form, input field or data entry UI.
brand-visual-language
dembrandt/dembrandt-skills
Shape language across type, radius and icons carries brand personality. Use when starting a design system, picking icons or radius tokens, or reviewing visual consistency.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.