Acerca de
Esta habilidad realiza revisiones exhaustivas de UX/UI utilizando las heurísticas de Nielsen, auditorías de accesibilidad WCAG 2.1 y análisis de flujos de usuario. Está diseñada para verificaciones de usabilidad previas al lanzamiento, comprobación de cumplimiento de accesibilidad y evaluaciones heurísticas de interfaces. Los desarrolladores deben utilizarla al evaluar diseños en cuanto a eficiencia, carga cognitiva y usabilidad de formularios antes de su implementación.
Instalación rápida
Claude Code
Recomendadonpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/review-ux-uiCopia y pega este comando en Claude Code para instalar esta habilidad
Documentación
察介
評介之用、達、效也。
用
- 釋前察用→用
- WCAG 2.1 達合→用
- 流之效→用
- 表設→用
- 啟發評既介→用
入
- 必：所察之介（URL、原型、源碼）
- 必：標用述（職、技、境）
- 可：研果（訪、問、析）
- 可：WCAG 標（A、AA、AAA）
- 可：所察之流
- 可：助技（讀屏、開關）
行
一：啟發評（Nielsen 十則）
逐則察介：
| # | 則 | 問 |
|---|---|---|
| 1 | 狀顯 | 系恆告用所事乎？ |
| 2 | 介合實 | 用熟語熟念乎？ |
| 3 | 用控自由 | 易撤、復、退乎？ |
| 4 | 一致規範 | 同元同行乎？ |
| 5 | 防誤 | 設防誤先發乎？ |
| 6 | 識勝憶 | 選、行、訊皆顯乎？ |
| 7 | 靈效 | 有捷徑而不亂初乎？ |
| 8 | 簡美 | 元皆有用乎？無冗乎？ |
| 9 | 助識診復誤 | 誤訊明、具、建乎？ |
| 10 | 助文 | 助易尋乎？ |
各則評重：
| 級 | 述 |
|---|---|
| 0 | 非問題 |
| 1 | 飾 — 暇修 |
| 2 | 微 — 低先 |
| 3 | 大 — 必修 |
| 4 | 災 — 釋前必修 |
## Heuristic Evaluation Findings
| # | Heuristic | Severity | Finding | Location |
|---|-----------|----------|---------|----------|
| 1 | System status | 3 | No loading indicator during data fetch — users click repeatedly | Dashboard page |
| 3 | User control | 2 | No undo for item deletion — only a confirmation dialog | Item list |
| 5 | Error prevention | 3 | Date field accepts invalid dates (Feb 30) | Booking form |
| 9 | Error recovery | 4 | Form submission error clears all fields | Registration |
得：十則皆評，各有具體發現與重級。
敗：時迫→重 1、3、5、9。
二：達察（WCAG 2.1）
可知
- 1.1.1 非文容：圖皆有 alt（飾圖
alt=""） - 1.3.1 訊關：用語意 HTML
- 1.3.2 序意：DOM 序合視序
- 1.4.1 色用：色非唯傳訊
- 1.4.3 對比：文 ≥ 4.5:1（常）、≥ 3:1（大）
- 1.4.4 縮文：可縮 200% 不失功
- 1.4.11 非文對：UI 元 ≥ 3:1
- 1.4.12 文距：增距仍可用
可操
- 2.1.1 鍵：諸功皆鍵可操
- 2.1.2 無鍵困：焦不困
- 2.4.1 跳鏈：有跳導鏈
- 2.4.3 焦序：Tab 序合理
- 2.4.7 焦顯：焦印明顯
- 2.4.11 焦不蔽：焦元不藏
- 2.5.5 標尺：互動 ≥ 24x24px
可解
- 3.1.1 頁語：
<html>設lang - 3.2.1 焦時：焦不引意外
- 3.2.2 入時：入不引意外
- 3.3.1 誤識：誤明述於文
- 3.3.2 標令：表入有顯標
- 3.3.3 誤建：誤訊建修法
健
- 4.1.1 解析：HTML 有效
- 4.1.2 名色值：自定元有 ARIA
- 4.1.3 狀訊：動容變宣告
得：WCAG 2.1 AA 系察、各條過/敗。
敗：先用 axe-core、Lighthouse 自動掃，後人評需判者。
三：鍵與讀屏察
鍵導測
僅用 Tab、Shift+Tab、Enter、Space、箭、Esc：
## Keyboard Navigation Audit
| Task | Completable? | Issues |
|------|-------------|--------|
| Navigate to main content | Yes — skip link works | None |
| Open dropdown menu | Yes | Arrow keys don't work within menu |
| Submit a form | Yes | Tab order skips the submit button |
| Close a modal | No | Escape doesn't close, no visible close button in tab order |
| Use date picker | No | Custom date picker not keyboard accessible |
讀屏測
NVDA、VoiceOver、TalkBack 測：
## Screen Reader Audit
| Element | Announced As | Expected | Issue |
|---------|-------------|----------|-------|
| Logo link | "link, image" | "Home, link" | Missing alt text on logo |
| Search input | "edit, search" | "Search products, edit" | Missing label association |
| Nav menu | "navigation, main" | Correct | None |
| Error message | (not announced) | "Error: email is required" | Missing live region |
| Loading spinner | (not announced) | "Loading, please wait" | Missing aria-live or role="status" |
得：全流以鍵獨、讀屏皆測。
敗：無讀屏→察 ARIA 與語意 HTML 為代。
四：流析
繪要流：
## User Flow: Complete a Purchase
### Steps
1. Browse products → 2. View product → 3. Add to cart → 4. View cart →
5. Enter shipping → 6. Enter payment → 7. Review order → 8. Confirm
得：要流繪、摩擦點識別評級。
敗：無分析→按複雜與步數評。
五：認負察
- 訊密：屏訊量適乎？
- 漸顯：複訊漸顯乎？
- 塊：相關視覺成組乎？
- 識勝憶：見而非憶乎？
- 一致式：同務同式乎？
- 決疲：選過多乎？
- 工憶：跨步需憶乎？
得：認負察、過載/不足區明。
敗：難客評→「眯測」（眯眼察結構顯否）。
六：表用察
各表：
- 標：每入有顯關標
- 占文：僅作例非標
- 入型：HTML 入型正
- 驗時：失焦或提交時誤
- 誤訊：具非泛
- 必欄：明標
- 欄組：相關視覺組
- 自完：
autocomplete設 - Tab 序：合視覺
- 多步表：進度顯
- 持：離返保
得：每表察、具體問題錄。
敗：表多→重高量者（註冊、結算、聯）。
七：書察報
## UX/UI Review Report
### Executive Summary
[2-3 sentences]
### Top 5 Improvements (Prioritised)
1. **[Issue]** — Severity: [N] — [Specific recommendation]
得：察給優先可行建、附重級。
敗：問題過多→分「必修」（3-4）「宜修」（1-2）。
驗
- 十則皆評
- WCAG 2.1 至少 1.1.1、1.4.3、2.1.1、2.4.7、3.3.1、4.1.2 察
- 鍵導要流測
- 讀屏測（或 ARIA/語意 HTML 代）
- 至少一要流析摩擦
- 認負察
- 表用察
- 發現按重排可行建
忌
- 混 UX 與視設：UX 為何運、視為何貌。美而 UX 劣可有
- 僅測順路：誤、空、載、邊例為 UX 問題藏處
- 忽真機：瀏覽器代之。真機觸、性、視口問題
- 達為後思：晚發貴修。早續察
- 私好為 UX 反：「吾偏好…」非 UX 反。引則、研、規
參
review-web-designscaffold-nextjs-appsetup-tailwind-typescript
Repositorio GitHub
Frequently asked questions
What is the review-ux-ui skill?
review-ux-ui is a Claude Skill by pjt222. Skills package instructions and resources that Claude loads on demand, so Claude can perform review-ux-ui-related tasks without extra prompting.
How do I install review-ux-ui?
Use the install commands on this page: add review-ux-ui to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.
What category does review-ux-ui belong to?
review-ux-ui is in the Design category, tagged design.
Is review-ux-ui free to use?
Yes. review-ux-ui is listed on AIMCP and free to install. It runs inside Claude, so no separate service account is required to use the skill itself.
Habilidades relacionadas
Utilice la habilidad executing-plans cuando tenga un plan de implementación completo para ejecutar en lotes controlados con puntos de revisión. Esta habilidad carga y revisa críticamente el plan, luego ejecuta tareas en pequeños lotes (por defecto 3 tareas) mientras reporta el progreso entre cada lote para la revisión del arquitecto. Esto asegura una implementación sistemática con puntos de control de calidad integrados.
Esta habilidad despacha un subagente revisor de código para analizar los cambios en el código frente a los requisitos antes de proceder. Debe usarse después de completar tareas, implementar funciones principales o antes de fusionar con la rama principal. La revisión ayuda a detectar problemas de forma temprana al comparar la implementación actual con el plan original.
Esta habilidad proporciona una guía integral para que los desarrolladores conecten servidores MCP a Claude Code mediante transportes HTTP, stdio o SSE. Cubre la instalación, configuración, autenticación y seguridad para integrar servicios externos como GitHub, Notion y APIs personalizadas. Úsala al configurar integraciones MCP, al configurar herramientas externas o al trabajar con el Protocolo de Contexto del Modelo de Claude.
Esta habilidad ayuda a los desarrolladores a elegir entre las interfaces web y CLI de Claude Code mediante el análisis de tareas, y luego permite la teletransportación fluida de sesiones entre estos entornos. Optimiza el flujo de trabajo gestionando el estado y el contexto de la sesión al cambiar entre web, CLI o móvil. Úsala para proyectos complejos que requieren diferentes herramientas en varias etapas.