Agent-Skills.md

Agent Skills: UX Flow Skill

Define user flows, state matrices, edge cases, and UX acceptance criteria for a UI feature before implementation.

UncategorizedID: LaizyIO/WorkflowSkills/ux-flow

Repository

LaizyIO/WorkflowSkills
LaizyIO

Install this agent skill to your local

pnpm dlx add-skill https://github.com/LaizyIO/WorkflowSkills/tree/HEAD/ux-flow

Skill Files

Browse the full folder contents for ux-flow.

Download Skill

Loading file tree…

ux-flow/SKILL.md

Skill Metadata

Name
ux-flow
Description
Define user flows, state matrices, edge cases, and UX acceptance criteria for a UI feature before implementation.

UX Flow Skill

WorkflowSkills Project Context

Before acting, resolve project documentation roots:

  1. Look for a [DOC]-* directory at project root.
  2. If found, set DOC_ROOT to that directory and UX_DOCS_ROOT to [DOC]-*/11-UX-DesignOps.
  3. If [DOC]-* is absent, stop and ask to initialize project documentation first; never write persistent UX documentation to docs/obsidian.
  4. If UX docs do not exist inside [DOC]-*, run or follow ux-bootstrap.
  5. Read DESIGN.md, CDC, FEAT, ADR, and related UX docs before writing.
  6. All persistent documentation must be in French and include YAML frontmatter.

Goal

Turn a UI feature request into a clear flow document usable by feature-specification, feature-research, and implementation-planner.

Process

  1. Identify user goal, entry point, primary task, secondary tasks, and exit point.
  2. Map happy path, alternative paths, blocked paths, and recovery paths.
  3. Define required states: loading, empty, error, success, permission, disabled, offline or network if relevant.
  4. Define responsive behavior for desktop and mobile.
  5. Define keyboard and focus requirements.
  6. Define UX acceptance criteria and test implications.
  7. Save the output under UX_DOCS_ROOT/06-Flows/.

Output

Create or update UX_DOCS_ROOT/06-Flows/[flow].md with frontmatter:

---
title: UX Flow - Nom flow
type: ux-flow
status: draft
created: YYYY-MM-DD
updated: YYYY-MM-DD
feature:
tags:
  - ux
  - flow
---

Rules

  • Do not implement UI in this skill.
  • Do not invent product rules absent from CDC or FEAT docs.
  • If product rules are missing, list open questions explicitly.
  • Update DOC_ROOT/00-MOC/MOC-UX.md.