screenshot-ui-analyzer — субагент для Claude Code: разбор UI
Субагент разбирает скриншот интерфейса на компоненты, структуру и паттерны дизайна. Пригодится, когда есть картинка, а макета или кода под рукой нет.
npx claude-code-templates@latest --agent ui-analysis/screenshot-ui-analyzerЧто делает screenshot-ui-analyzer
Субагент работает как UI/UX-аналитик: смотрит на скриншот и выписывает всё, что на нём видно. Навигация, формы, таблицы, карточки, модалки, тосты, иконки и аватары — каждая находка получает тип, расположение и описание. Отдельно разбирается структура страницы: где шапка, где сайдбар, как устроена сетка, что в визуальной иерархии выходит на первый план.
На выходе — JSON с полями page_type, layout, components, design_patterns и visual_hierarchy. В components попадают состояние элементов: активный, выключенный, загрузка, ошибка, пустой экран. Ещё субагент отмечает признаки готовой библиотеки вроде Material или Ant Design и общие приёмы оформления — цвета, типографику, систему иконок.
Инструменты у него скромные: Read и TodoWrite. Значит, картинку он читает, а правки в проект не вносит — только отчёт. Если нужен разбор живого интерфейса, а не картинки, этот субагент не подойдёт.
Какие задачи решает
- разобрать чужой интерфейс по скриншоту, когда нет доступа к коду
- составить список компонентов страницы перед вёрсткой
- определить, на какой библиотеке собран чужой UI
- описать состояния элементов: загрузка, ошибка, пустой список
- сравнить визуальную иерархию двух экранов
Примеры запросов агенту
- проанализируй скриншот
dashboard.pngи верни JSON с компонентами и структурой - посмотри на этот скриншот формы и перечисли все поля и кнопки с их состояниями
- разбери
settings-page.png: какая библиотека компонентов и как устроена сетка
Как установить screenshot-ui-analyzer
1Через claude-code-templates
npx claude-code-templates@latest --agent ui-analysis/screenshot-ui-analyzer2Вручную: положить файлы
.claude/agents/screenshot-ui-analyzer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/screenshot-ui-analyzer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/screenshot-ui-analyzer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о screenshot-ui-analyzer
Как установить screenshot-ui-analyzer в Claude?
Через шаблоны: npx claude-code-templates@latest --agent ui-analysis/screenshot-ui-analyzer. Файл субагента появится по пути .claude/agents/screenshot-ui-analyzer.md.
Что делает screenshot-ui-analyzer?
Читает скриншот интерфейса и возвращает JSON: тип страницы, структуру разделов, список видимых компонентов с состояниями, признаки библиотеки компонентов и описание визуальной иерархии.
Может ли он править код по результатам разбора?
Нет. Из инструментов у него только Read и TodoWrite, поэтому он выдаёт текстовый отчёт в JSON и ничего не меняет в проекте.
