tpo-user-flow-template

Generates structured user flow documentation covering screens, states, permissions, and acceptance criteria.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/TECH-HY/SKILLS --skill tpo-user-flow-template-tech-hy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tpo-user-flow-template
Source: https://github.com/TECH-HY/SKILLS/tree/main/skills/tpo-user-flow-template
Command: npx skills add https://github.com/TECH-HY/SKILLS --skill tpo-user-flow-template-tech-hy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Product teams often write user flows that miss error paths, permissions, backend mappings, or accessibility requirements, forcing developers to guess during implementation. This Skill provides a complete template that ensures every user flow connects business goals, UX screens, system states, and acceptance criteria. ## Core Features & Use Cases - Structured Flow Documentation: Captures flow metadata, user context, screen-by-screen tables, main paths, alternative paths, and error recovery paths. - Cross-Functional Coverage: Includes sections for permissions matrices, UI-to-backend data mapping, notifications, analytics metrics, accessibility, and responsive behavior. - Acceptance Gates: Defines a checklist a flow must pass before handoff, plus a standardized output format for the Technical Product Owner Agent. - Use Case: A product owner documenting a "submit startup profile for review" flow uses the template to define each screen, validation rule, error recovery, and developer task so the AI Developer Agent can implement it without ambiguity. ## Quick Start Ask the agent to create a user flow for a specific feature using the tpo-user-flow-template, providing the flow name, user role, and goal.

Frequently Asked Questions about tpo-user-flow-template

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a user flow for a product feature?

Start with flow metadata (name, user role, goal, trigger), then document the main path step by step with screens, actions, and system responses. Add alternative paths, error recovery tables, UI states, permissions, and acceptance criteria so developers can implement without guessing.

What should a user flow document include for developer handoff?

A complete user flow includes screen-by-screen tables, validation rules, error and recovery paths, a permissions matrix, UI-to-backend data mapping, notification events, and measurable acceptance criteria. This template enforces all of these sections.

How do I document error and edge cases in a user flow?

Use an error and recovery table listing each error case, where it happens, what the user sees, system behavior, and the recovery action. Ensure users understand what happened, valid data is preserved, and destructive actions require confirmation.

Does this template cover accessibility and responsive design requirements?

Yes, it includes dedicated sections for keyboard paths, focus order, screen reader labels, contrast, and touch targets, plus responsive behavior definitions for mobile, tablet, desktop, and large desktop breakpoints.

When is a user flow considered complete and ready for implementation?

A flow is accepted when user and business goals are clear, every step has defined screens and system responses, error paths and UI states are documented, permissions and backend mappings are explicit, and success metrics are defined.