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

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

Скилл ui-review для Claude Code, проводящий ревью интерфейсов, прототипов и текущих сборок. Выполняет проверку доступности, находит ошибки в верстке и ранжирует их по критичности.

MIT 564 установок ★ 616 обновлён 2026-11-16

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

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

Скилл анализирует интерфейсы, проверяя доступность, фокус, поведение при загрузке и ошибки. Работает на основе критериев из references/criteria.md. Инструмент захватывает экраны при разных разрешениях и фиксирует результаты проверок.

Для расширенного захвата данных рекомендуется использовать build-design-system, иначе применяется встроенный инструмент браузера. Отчёты сохраняются в папку .ui-review/ с указанием блокирующих проблем, исправлений и вердикта о готовности к релизу.

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

  • Проверить доступность элементов интерфейса
  • найти ошибки верстки при разном разрешении
  • составить список критических багов перед релизом

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

  • Проверь этот экран на ошибки
  • готов ли этот флоу к релизу
  • найди проблемы доступности на странице настроек

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

1Через Skills CLI (Vercel)

npx skills add arla6ka/design.how --skill ui-review -a claude-code

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

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

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

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

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

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

Выполните npx skills add arla6ka/design.how --skill ui-review -a claude-code в терминале проекта, затем проверьте файл ~/.claude/skills/ui-review/SKILL.md.

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

Он анализирует экраны и прототипы, выявляя баги верстки, проблемы доступности и ошибки взаимодействия.

Что нужно для работы ui-review?

Необходим файл references/criteria.md с описанием правил проверки. Для автоматизированных скриншотов полезно установить build-design-system.

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

SKILL.md · MIT
---
name: ui-review
description: Use to critique a screen, flow, prototype or running build, accessibility included, and rank what is broken, such as "check this page before I ship", "is this flow ready", "is it accessible", keyboard or screen-reader checks, "it feels off on my phone" or "it feels janky". Not for token compliance, which is token-mapping.
metadata:
  summary: Reviews a screen
---

# UI review

The render is the evidence. A description, DOM text or source code only supports it. Severity, the 13 criteria and the edge cases are in `references/criteria.md`. An installed design system's own rules come first and count as agreed criteria.

## Steps

1. **Scope.** What the caller names, else the branch's changed screens, else the five top routes.
2. **Lint.** Run the project's own lint on the scoped files. Record the command and exit code.
3. **Capture** each screen at each width (the app's narrowest and widest, 390 and 1280 by default) in the states that matter, one fresh navigation per width. With `build-design-system` installed, `build-design-system/scripts/capture.mjs` does this behind a guard that blocks every write and saves each capture's accessibility tree. It needs `--writes <file>` listing the app's writes, or `--no-backend`, and writes only to its `--out` folder (keep that under `.ui-review/`). Otherwise use the host's browser tool and save the tree yourself. Run the project's accessibility scanner too when it has one.
4. **Fix the purpose** of each screen in one line. Mark it assumed when the caller did not give it.
5. **Probe the traps** each screen has, on a local build only: keyboard path, focus after close, loading and error states, a throttled tab, reduced motion, and a touch width. Each probe gets a measured result or a reason it did not run. Measure press feedback with the Event Timing API (a `PerformanceObserver` on `event` entries, each `duration` under 100 ms). Do not click anything that writes to shared data.
6. **Walk the criteria** at each width. Cite each finding by number and name, or by the installed rule's ID.
7. **Sort.** With more than one reviewer available (a panel), give each the same prompt and no persona, read only. The coordinator then sorts every finding into `blocking`, `should-fix`, `note` or `dismissed`, naming who raised it and giving one line of reason. A finding raised by two reviewers on their own is the strongest signal. Dismiss nitpicks, hypotheticals nobody traced to a real call site, and "I would have done it differently". Within a bucket, put surfaces that write data first, then order by places hit. Without a panel, do the same alone.
8. **Walk the edge cases** and mark each shown or not shown.
9. **Write the verdict last.**

## Rules

- A finding has a criterion, a findable location (the element by role and name, with its capture, as in `button 'Save changes' (settings-1280.png)`), the width, and the evidence. A finding that rests on taste is dropped to Left out.
- Wrong: "The spacing feels tight." Right: "Label sits 24 px from its own field and 8 px from the next one (criterion 4, settings-390.png)."
- An inferred finding is written as the check that settles it. An inferred `blocking` finding makes the verdict `no, pending <the check>`.
- A claim that something works or is fixed names a command or capture from this session.
- Contrast, target size and keyboard problems are ranked. A change to the accessibility tree that only adds semantics is ranked. One that removes or restructures semantics goes to a person.
- A finding or pass on responsiveness to input (criterion 13) from a screenshot is invalid. It needs a measured probe. A focus ring is the reverse. Reach the control with real Tab presses and judge the ring from the capture, because a container that draws it through `:has(:focus-visible)` leaves the focused element reporting no outline.
- Product decisions behind a fix go to For a person to decide. Keeping the user's input is never one.

## Output

The first line answers the ask in plain words. The ship line follows: `Ready to ship: no. Enter in Email cancels the invite (blocking 1, should-fix 2, 3 questions for a person).` Any `blocking` finding makes the verdict `no`, an inferred one `no, pending <the check>`, `should-fix` alone `yes, with fixes`, only notes `yes`.

Then, in order:

1. **Review record.** Source, tool, widths, date, criteria file, the purpose marked given or assumed, every assumption and gap.
2. **Findings** by bucket, each with who raised it, what was seen, where, criterion, why it matters here, evidence, and the fix as a check that fails on the current build (`Fix Enter in Email so that it sends 1 POST`).
3. **Edge cases not shown.** One line each.
4. **For a person to decide.**
5. **Dismissed and left out.** Each with who raised it and the reason.

Run on its own, save the report to `.ui-review/<date>-<flow>.md` with captures beside it. When a coordinator asks for captures only, return the capture paths, widths and `Coverage:` line, and no findings. The chat reply gives the answer and ship lines, each command with its exit code, and one prompt the person can paste to take the next step.

## Done

Every finding has a criterion, a location, evidence and only the widths where it shows. Every probe has a result or a reason. The first line, the ship line and the summary agree. The last line reads `Coverage:` with the routes, widths, themes and probes measured, then what was not.

© arla6ka · MIT · arla6ka/design.how

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

Все скиллы по теме «Фронтенд и UI» →
ui-regression fcakyon Скилл ui-regression проверяет интерфейсы веб-приложений и браузерных расширений на локальном сервере, стейджинге или проде: сценарии, локализацию, ошибки и вёрстку. CX Codex +1 ★ 1 216звёзд репо codebase-review-swarm ZaxbyHub Скилл codebase-review-swarm проводит глубокий аудит репозитория с привязкой выводов к исходному коду. Подходит для проверки безопасности, QA, доступности и других выбранных направлений. CX Codex +1 ★ 539звёзд репо ui-ux-tester VoltAgent Community Субагент ui-ux-tester проходит по документированным пользовательским сценариям в браузере или десктопе и собирает отчёт о дефектах с доказательствами. CX Codex ★ 26 718звёзд репо email-render-builder aaron-he-zhu Скилл email-render-builder для агентов, который собирает адаптивный HTML email-письма из готового креатива и проверяет рендер в Gmail, Outlook, Apple Mail и на мобильных. Текст письма он не пишет — это задача email-creative-builder. CX Codex +1 1 200установок visual-qa-testing spencerpauly Скилл visual-qa-testing для Claude Code открывает встроенный браузер, делает скриншот страницы и проверяет консоль на ошибки после изменений интерфейса. CX Codex +1 714установок workflow-progress-screenshots MengTo Скилл workflow-progress-screenshots обязывает агента присылать реальные скриншоты интерфейса по ходу работы, а не в конце задачи. Пригодится при правках фронтенда, анимаций, 3D-сцен и вёрстки. CX Codex +1 682установок

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

build-design-system Скилл build-design-system для Claude Code собирает систему дизайна из интерфейса приложения. Запускается для выделения токенов, доработки компонентов или начала такой системы. CX Codex +1 603установок token-mapping Скилл token-mapping для Claude Code сопоставляет жёстко заданные значения стилей с токенами проекта. Запускается для аудита страницы, файла или diff перед миграцией на токены. CX Codex +1 586установок design-system-boss Скилл design-system-boss для Claude Code координирует работу с дизайн-системами в приложениях с готовым пользовательским интерфейсом. CX Codex +1 583установок component-docs Скилл component-docs для Claude Code пишет документацию одного UI-компонента по коду, stories и реальным вызовам. Запускается по просьбам документировать компонент или его состояния. CX Codex +1 582установок migrate-design-system Скилл migrate-design-system для Claude Code переносит кодовую базу на готовую дизайн-систему через пошаговый аудит, замеры базового состояния и проверку экранов отдельным верификатором. CX Codex +1 577установок

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

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