---
name: ux-patterns
description: Use before generating or reviewing UI. Select source-backed UX patterns, required states, interaction contracts, accessibility checks, and anti-pattern risks from UX Patterns Guide.
metadata:
  source: https://uxpatternsguide.com
  version: "1.0.0"
---

Use this skill when designing, generating, implementing, or reviewing UI/UX behavior.

## Workflow

1. Identify the user job, platform, consequence severity, reversibility, interruption cost, and recovery needs.
2. Load the compact index from https://uxpatternsguide.com/agent/index.json.
3. Select 2-5 candidate patterns by problem fit. Do not choose by component name alone.
4. Load only the relevant pattern contracts from https://uxpatternsguide.com/agent/patterns/{id}.md.
5. If nearby alternatives overlap, load the relevant comparison pack from https://uxpatternsguide.com/agent/comparisons/{id}.md.
6. Before final output, apply https://uxpatternsguide.com/agent/anti-pattern-checklist.md.
7. State the selected pattern, rejected alternatives, required states, interaction contract, and review questions in the final implementation notes.

## References

- Retrieval details: https://uxpatternsguide.com/agent/skills/ux-patterns/references/retrieval.md
- Review workflow: https://uxpatternsguide.com/agent/skills/ux-patterns/references/review-checklist.md
- Decision guide: https://uxpatternsguide.com/agent/decision-guide.md
