visual-qa-evaluator — скилл для Claude Code
Скилл visual-qa-evaluator для Claude Code готовит артефакты для оценки изменений интерфейса и поиска визуальных регрессий. Работает при сравнении скриншотов до и после правок.
MIT ★ 529 обновлён 2026-11-17
npx skills add ShuaiMXu/happyhands --skill visual-qa-evaluator -a claude-codeЧто делает visual-qa-evaluator
Этот скилл формирует структурированные данные для визуального контроля, анализируя иерархию элементов, контрастность и порядок чтения. Он автоматизирует подготовку доказательной базы, требуя для работы скриншоты десктопной и мобильной версий, а также описание дизайн-замысла.
Инструмент не выносит вердикт самостоятельно — он подготавливает данные для независимой оценки. При нехватке исходных материалов скилл требует дозагрузки доказательств. В процессе работы используется общая рубрика дизайн-языка, что позволяет сохранять верность исходному стилю проекта при анализе найденных отклонений.
Какие задачи решает
- Сравнить визуальные отличия до и после правок
- Выявить регрессии в иерархии элементов
- Подготовить данные для профессионального QA
- Проверить соответствие верстки дизайн-системе
Примеры запросов агенту
- visual-qa-evaluator: подготовь отчёт о визуальных изменениях для десктопа
- visual-qa-evaluator: проверь иерархию на основе приложенных скриншотов
- visual-qa-evaluator: сформируй список ограничений для этого редизайна
Как установить visual-qa-evaluator
1Через Skills CLI (Vercel)
npx skills add ShuaiMXu/happyhands --skill visual-qa-evaluator -a claude-code2Вручную: положить файлы
~/.claude/skills/visual-qa-evaluator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/visual-qa-evaluator/
1Через Skills CLI (Vercel)
npx skills add ShuaiMXu/happyhands --skill visual-qa-evaluator -a codex2Вручную: положить файлы
.agents/skills/visual-qa-evaluator/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ShuaiMXu/happyhands --skill visual-qa-evaluator -a cursor2Вручную: положить файлы
.cursor/skills/visual-qa-evaluator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ShuaiMXu/happyhands skills/product-design/visual-qa-evaluator2Вручную: положить файлы
.github/skills/visual-qa-evaluator/SKILL.md1Через Skills CLI (Vercel)
npx skills add ShuaiMXu/happyhands --skill visual-qa-evaluator -a gemini-cli2Командой платформы
gemini skills install https://github.com/ShuaiMXu/happyhands --path skills/product-design/visual-qa-evaluatorВручную: положить файлы
.devin/skills/visual-qa-evaluator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о visual-qa-evaluator
Как установить visual-qa-evaluator в Claude Code?
Выполните команду npx skills add ShuaiMXu/happyhands --skill visual-qa-evaluator -a claude-code.
Что делает visual-qa-evaluator?
Он сопоставляет пары скриншотов, структурирует найденные отличия и подготавливает материал для экспертной проверки дизайна.
Что нужно для работы visual-qa-evaluator?
Для анализа необходимы скриншоты десктопной и мобильной версий, критическая задача и зафиксированные требования к дизайну.
Исходный текст
SKILL.md · MIT
--- name: visual-qa-evaluator description: "Compare matched before and after renders for task clarity and visual regressions after a product change." --- # Visual QA Evaluator Prepare an independent visual decision from matched evidence. ## Required evidence - same-state desktop and mobile captures - critical task - declared design intent ## Decisions - Compare hierarchy, grouping, contrast and reading order - Report regressions separately - State uncertainty rather than inventing a score ## Boundary The deterministic handler only prepares matched artifacts; screenshot-aware review is required. Return structured evidence, findings, proposed updates and limitations. Use `needs-evidence` when required inputs or professional review are missing. Never invent an Experience Score or promote a project observation into a universal rule. ## Design language continuity Read [the shared design-language rubric](../visual-hierarchy-reviewer/rubric.json). Apply it to the confirmed change and introduced regressions, preserving supplied brand choices. Put the visible element, task/brand conflict and minimal remedy in each finding's observation. Existing out-of-scope opportunities belong in limitations, not automatic failure of a narrow fix. The Workbench's independent AI review receives this same versioned rubric and foundation context. ## Bundled OJO methodology Use the [Harness OJO adapter](../../vendor/ojo/ADAPTER.md), then its linked original Skill and relevant references. The runtime records a verified guidance snapshot in this result; design execution and independent QA receive the same pinned source with mode-specific reading routes. Preserve the existing evidence and approval boundaries. ## Execution contract The bounded handler prepares source-bound matched originals and a review brief; it does not view the images or execute an independent visual judgment. Keep missing states and mismatched configurations visible. Use the existing independent ai-review/attest record for actual task, hierarchy, interaction, design-system and regression conclusions. A successful evidence pairing cannot stand in for an independent review or final acceptance.
© ShuaiMXu · MIT · ShuaiMXu/happyhands