archflow-agent-ux-designer

Generates user flows, wireframes, and design tokens from the project's chosen design system.

28|4|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/AZidan/archflow --skill archflow-agent-ux-designer-azidan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archflow-agent-ux-designer
Source: https://github.com/AZidan/archflow/tree/main/adapters/generic/.agents/skills/archflow-agent-ux-designer
Command: npx skills add https://github.com/AZidan/archflow --skill archflow-agent-ux-designer-azidan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designing consistent user experiences is hard when AI-generated UI drifts from the project's design system, invents components, or ignores platform conventions. This Skill enforces a structured UX design workflow where every flow, wireframe, and theme token derives from the project's declared design system rather than being improvised. ## Core Features & Use Cases - User Journey & Flow Design: Produces Mermaid flowcharts with decision points, screen inventory YAML, navigation maps, and error-state documentation. - Design Token Systems: Builds complete theme.yaml files covering colors, typography, spacing, shadows, borders, and animations with WCAG 2.1 AA accessibility compliance. - Design System Enforcement: Reads .archflow/design-system.yaml and the referenced design system guide before any UI output, uses only its component vocabulary, and logs genuine gaps in design-artifacts/component-gaps.md instead of inventing components. - Use Case: During Archflow Phase 2, delegate a new story to this role to produce wireframes and a screen inventory grounded in the project's design system, then hand the accepted artifacts to the ui-engineer for implementation. ## Quick Start Ask the ux-designer role to create the user flow, screen inventory, and theme tokens for the current story using the project's configured design system.

Frequently Asked Questions about archflow-agent-ux-designer

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

FAQPage Schema
How do I generate user flows and wireframes with an AI agent?

Delegate the story to the ux-designer role, which produces Mermaid flowcharts, a screen inventory YAML, and wireframes under design-artifacts/. All output uses the component vocabulary from the project's configured design system rather than invented components.

What is a design token theme.yaml and how is it created?

A theme.yaml defines colors, typography, spacing, shadows, borders, and animation tokens with semantic naming. The ux-designer builds it from the project's design system, validates WCAG 2.1 AA contrast, and keeps tokens platform-neutral so they translate to web or mobile.

What happens if the design system configuration is missing?

If .archflow/design-system.yaml is missing and the project has a UI, the role stops and instructs the user to run $archflow-design. It never guesses or invents a design system on its own.

Does the ux-designer choose the UI framework for implementation?

No. The role never names a UI framework in flows, wireframes, or themes. It reads project_type and stack only for input model, navigation conventions, and viewport implications; framework selection is left to the ui-engineer.

How are components missing from the design system handled?

A genuinely missing component is composed from the system's primitives and logged in design-artifacts/component-gaps.md with the reason. Components are never silently invented outside the system's vocabulary.