From bc0fd83e142371d977cf10a4011e61f8cfa0fc12 Mon Sep 17 00:00:00 2001 From: Julian Lechner Date: Thu, 24 Sep 2026 19:12:11 +0200 Subject: [PATCH] docs(skill): clarify UI UX review triggers --- shared/skills/reviews/ui-ux-review/SKILL.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/shared/skills/reviews/ui-ux-review/SKILL.md b/shared/skills/reviews/ui-ux-review/SKILL.md index df7fcb9..fb386f6 100644 --- a/shared/skills/reviews/ui-ux-review/SKILL.md +++ b/shared/skills/reviews/ui-ux-review/SKILL.md @@ -1,10 +1,19 @@ --- name: ui-ux-review -description: Review user interface changes for usability and consistency. +description: Use when reviewing a user-facing screen or interaction for task clarity, accessibility, validation, error recovery, responsive behavior, and consistency. --- # UI UX Review -Inspect states, feedback, accessibility basics, consistency, and error handling. +Use when reviewing a user-facing screen or interaction for usability, clarity, accessibility, or consistency. -Return concrete findings with affected user flows. Keep detailed design standards for future customization. +## Review + +1. Identify the user's goal and walk through the normal flow, including loading, empty, success, error, and recovery states that apply. +2. Check whether labels, instructions, defaults, and feedback make the next action and system state clear. +3. Review keyboard access, focus order and visibility, semantic controls, readable contrast, and accessible names for interactive elements. +4. Check validation timing and placement, preservation of entered data, prevention of accidental destructive actions, and clear recovery from errors. +5. Compare navigation and interaction patterns with nearby screens. Consider narrow layouts and long or localized content where relevant. +6. Distinguish a usability defect from a stylistic preference and tie each finding to a specific user task. + +Report the affected flow, user impact, evidence, and a focused improvement. Do not redesign unrelated parts of the interface.