К основному содержанию
скилл CX Codex

ux-review · nickcrew — скилл для Claude Code: что делает и как установить

Скилл ux-review проверяет компонент или поток с трёх сторон: удобство, доступность по WCAG 2.1 AA и поведение интерфейса. Отдаёт отчёт с находками по приоритетам.

MIT 119 установок ★ 71 обновлён 2026-06-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add NickCrew/Claude-Cortex --skill ux-review -a claude-code
Открыть на GitHub

Что делает ux-review

Скилл ведёт агента по пяти шагам. Сначала тот выясняет, какую задачу решает пользователь и какова роль компонента в общем потоке. Потом прогон по десяти эвристикам Нильсена: видимость состояния, свобода действий, предотвращение ошибок и остальные. Дальше один и тот же экран смотрят с трёх сторон: удобство, доступность по WCAG 2.1 AA, взаимодействие.

Флаг --focus сужает проверку. Вариант --focus=ux оставляет поток задач и восстановление после ошибок, --focus=a11y берёт клавиатуру, контраст и управление фокусом, --focus=interaction смотрит на состояния загрузки, пустоты и ошибки. Находки делятся на Critical, High, Enhancement и Future, отчёт собирается таблицами по категориям. Для чисто визуальной критики скилл не подходит: он отсылает к ui-design-aesthetics.

Всё лежит в одном SKILL.md: таблица эвристик, шаблон отчёта, разбор по фокусам.

Какие задачи решает

  • прогнать новый компонент по эвристикам Нильсена до релиза
  • проверить форму на соответствие WCAG 2.1 AA
  • разобрать поток оформления заказа и найти в нём тупики
  • разложить замечания по критичности перед текущим спринтом
  • проверить состояния загрузки, пустого списка и ошибки

Примеры запросов агенту

  • Сделай UX-ревью компонента CheckoutForm.tsx: эвристики, доступность и состояния.
  • Проверь поток регистрации на клавиатурную навигацию и управление фокусом, --focus=a11y.
  • Оцени диалог удаления аккаунта и разложи замечания по серьёзности.

Как установить ux-review

1Через Skills CLI (Vercel)

npx skills add NickCrew/Claude-Cortex --skill ux-review -a claude-code

2Вручную: положить файлы

~/.claude/skills/ux-review/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ux-review/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об ux-review

Как установить ux-review в Claude Code?

Выполните npx skills add NickCrew/Claude-Cortex --skill ux-review -a claude-code. Файл скилла окажется по пути ~/.claude/skills/ux-review/SKILL.md.

Что делает ux-review?

Разбирает компонент или сценарий по эвристикам юзабилити, проверяет доступность по WCAG 2.1 AA и смотрит, как устроены состояния и обратная связь. На выходе отчёт в markdown с находками по приоритетам.

Можно ли ограничиться проверкой доступности?

Да, с --focus=a11y скилл смотрит клавиатуру, контраст, работу со скринридером и управление фокусом. Другие области задаются как --focus=ux и --focus=interaction.

Исходный текст

SKILL.md · MIT
---
name: ux-review
description: Multi-perspective UX review combining usability heuristics, WCAG accessibility checks, and interaction design analysis. Use when reviewing UI components before release, evaluating user flows for usability issues, conducting design critiques, or auditing accessibility compliance.
tags:
  - ux
  - usability
  - accessibility
  - design-review
  - heuristics
triggers:
  - ux review
  - usability review
  - design critique
  - user experience analysis
  - heuristic evaluation
keywords:
  - UX review
  - usability review
  - accessibility audit
  - review
---

# UX Review

Comprehensive user experience review that coordinates usability, accessibility, and interaction design perspectives for thorough analysis of components, flows, or features.

## When to Use This Skill

- Reviewing new components or features before release
- Evaluating existing flows for usability issues
- PR reviews that touch UI/UX code
- Design system component reviews
- Onboarding flow or checkout flow optimization
- Avoid using for purely visual/aesthetic reviews — use `ui-design-aesthetics` instead

## Workflow

### Step 1: Gather Context

Answer these questions before reviewing:

1. What is the user trying to accomplish?
2. What is this component's role in the larger flow?
3. Who are the target users (personas, skill level)?
4. What are the success criteria?

### Step 2: Run Heuristic Scan (Nielsen's 10)

Evaluate the interface against each heuristic:

| Heuristic | Check |
|-----------|-------|
| Visibility of system status | Does the user always know what's happening? |
| Match with real world | Does it use familiar language and concepts? |
| User control and freedom | Can users undo, go back, escape? |
| Consistency and standards | Does it follow platform conventions? |
| Error prevention | Are mistakes prevented before they happen? |
| Recognition over recall | Is information visible rather than memorized? |
| Flexibility and efficiency | Are there shortcuts for expert users? |
| Aesthetic and minimalist design | Is every element necessary? |
| Error recovery | Are error messages helpful and actionable? |
| Help and documentation | Is guidance available when needed? |

### Step 3: Multi-Perspective Analysis

#### Usability Perspective

- **User flow**: Is the path to completion clear and efficient?
- **Information architecture**: Is content organized logically?
- **Cognitive load**: Is the interface overwhelming?
- **Mental models**: Does it work like users expect?

#### Accessibility Perspective (WCAG 2.1 AA)

- **Keyboard navigation**: Can everything be done without a mouse?
- **Screen reader**: Is the experience equivalent for assistive tech users?
- **Color contrast**: Do all text/UI elements meet 4.5:1 ratio?
- **Focus management**: Is focus order logical, visible, and never trapped?

```html
<!-- Example: Accessible button with proper ARIA -->
<button aria-label="Close dialog" aria-describedby="close-hint">
  <svg aria-hidden="true"><!-- icon --></svg>
</button>
<span id="close-hint" class="sr-only">Press Escape to close</span>
```

#### Interaction Design Perspective

- **State coverage**: Are all states handled (loading, empty, error, success)?
- **Feedback**: Does the user know their action worked?
- **Transitions**: Are animations purposeful and under 300ms?
- **Progressive disclosure**: Is complexity revealed appropriately?

### Step 4: Prioritize Findings

Categorize every finding:

| Priority | Criteria | Action |
|----------|----------|--------|
| **Critical** | Blocks usability or fails WCAG AA | Must fix before release |
| **High** | Significantly degrades experience | Fix in current sprint |
| **Enhancement** | Improves delight and efficiency | Backlog for next iteration |
| **Future** | Long-term improvements | Track in roadmap |

### Step 5: Produce Review Report

```markdown
## UX Review: [Component/Flow Name]

### Summary
[2-3 sentence executive summary]

### Critical Issues
- [ ] Issue 1: [Description, impact, WCAG criterion if applicable]
- [ ] Issue 2: [Description, impact]

### Recommendations by Category

#### Usability
| Finding | Impact | Recommendation |
|---------|--------|----------------|
| [Issue] | High/Med/Low | [Fix] |

#### Accessibility
| Finding | WCAG Criterion | Recommendation |
|---------|----------------|----------------|
| [Issue] | [2.x.x Level] | [Fix] |

#### Interaction Design
| Finding | Impact | Recommendation |
|---------|--------|----------------|
| [Issue] | High/Med/Low | [Fix] |

### Next Steps
1. Create issues for critical findings
2. Add accessibility requirements to acceptance criteria
3. Schedule follow-up review after fixes
```

## Focus Area Deep Dives

Use `--focus` to narrow the review scope:

- **`--focus=ux`**: User flow mapping, task efficiency, error recovery, learnability
- **`--focus=a11y`**: WCAG 2.1 AA audit, keyboard nav, screen reader, contrast, focus management
- **`--focus=interaction`**: State coverage, feedback timing, micro-interactions, animation review

## Best Practices

- **Test with real content** — Lorem ipsum hides information architecture problems
- **Check all states** — Empty, loading, error, success, and edge-case states
- **Verify keyboard flow** — Tab through the entire component without a mouse
- **Use browser dev tools** — Lighthouse accessibility audit catches low-hanging fruit
- **Prioritize ruthlessly** — A focused list of critical fixes beats a wall of suggestions

© NickCrew · MIT · NickCrew/Claude-Cortex

Похожие скиллы

Все скиллы по теме «Дизайн» →

Сначала — ux-review от других авторов.

ux-review Donchitos Скилл ux-review для Claude Code проверяет UX-спеки, дизайн HUD и библиотеки паттернов игровых студий перед передачей в разработку. CX Codex +1 722установок ux-heuristics wondelai Скилл ux-heuristics для Claude Code оценивает юзабилити интерфейсов по принципам Nielsen и Krug. Включается при проблемах с навигацией, формами или понятностью интерфейса. CX Codex +1 10 800установок evaluate ghaida Скилл evaluate разбирает интерфейс по эвристикам, расставляет проблемы по серьёзности и говорит, что именно поменять. Пригодится перед запуском или когда непонятно, почему пользователи бросают задачу. CX Codex +1 3 400установок nielsen-usability-heuristics dembrandt Скилл nielsen-usability-heuristics оценивает интерфейсы и текст ошибок по 10 эвристикам Нильсена. Скилл помогает выявить проблемы юзабилити прямо в коде компонентов до релиза. CX Codex +1 1 200установок design-review plugin87 Скилл design-review для Claude Code проводит аудит интерфейса по шести взвешенным метрикам и эвристикам Нильсена. Включается при запросе дизайн-критики, оценки качества экрана или проверки доступности. CX Codex +1 694установок om-ux-review-pr open-mercato Скилл om-ux-review-pr проводит аудит интерфейса в пулл-реквестах или локальных ветках прямо в браузере. Каждая рекомендация содержит доказательства, паттерн, компромиссы и критерии приёмки. CX Codex +1 3 500установок neo-user-journey podo Скилл neo-user-journey для Claude Code строит карты пользовательского пути с фиксацией эмоций и запускает тесты через Playwright. Проверяет сценарии взаимодействия в работающем веб-интерфейсе. CX Codex +1 217установок

Из того же набора21

Весь набор →
typescript-advanced-patterns Скилл typescript-advanced-patterns для Claude Code проектирует сложные типы TypeScript — от брендированных идентификаторов до типобезопасных API. Выражает правила предметной области на уровне типов. CX Codex +1 174установок code-explanation Скилл code-explanation для Claude Code и Codex объясняет код, архитектуру и поведение систем с учётом уровня читателя. Помогает разбирать код, обучаться и передавать знания. CX Codex +1 173установок security-testing-patterns Скилл security-testing-patterns задаёт правила тестирования безопасности: от SAST и SCA до фаззинга, DAST и аудита API по OWASP. Помогает выстроить CI/CD пайплайн и разобрать уязвимости. CX Codex +1 154установок secure-coding-practices Скилл secure-coding-practices для Claude Code помогает применять защитные практики при работе с авторизацией, пользовательским вводом и чувствительными данными. Подключается и для проверки кода на уязвимости. CX Codex +1 134установок event-driven-architecture Скилл event-driven-architecture для Claude Code помогает проектировать системы на событиях: event sourcing, CQRS, саги и обмен сообщениями. Охватывает микросервисы и распределённые транзакции. CX Codex +1 118установок dashboard-designer Скилл dashboard-designer для Claude Code помогает спроектировать дашборд: выбрать KPI, расположить блоки и настроить визуальную иерархию. Запускается на запросы о структуре панели мониторинга или выборе BI-инструмента. CX Codex +1 109установок terraform-best-practices Скилл terraform-best-practices внедряет инженерные стандарты Terraform: разбиение на модули, блокировку стейта, разделение сред и валидацию в CI/CD. CX Codex +1 109установок mermaid-diagramming Скилл mermaid-diagramming учит агента рисовать диаграммы Mermaid: блок-схемы, sequence-диаграммы, ERD, состояния, Gantt и архитектурные виды, отдельно базовую и стилизованную версию. CX Codex +1 105установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой