critique-affordance — скилл для Claude Code: суть и установка
Анализирует готовый экран на понятность интерфейса: проверяет кликабельность элементов, видимость состояний и читаемость главного CTA.
npx skills add Owl-Listener/designer-skills --skill critique-affordance -a claude-codeЧто делает critique-affordance
Скилл разбирает готовый макет или свёрстанный интерфейс по четырём направлениям: сигналы кликабельности, видимость состояний, ясность CTA и обнаруживаемость действий. По каждому направлению ассистент выдаёт наблюдение, найденную проблему с обоснованием, конкретный вариант исправления и оценку: pass, minor issue или major issue.
В проверку входят мобильные ограничения: сенсорные зоны должны быть не меньше 44×44px, а действия вроде редактирования нельзя прятать за ховер. Скилл сразу находит подавленные фокус-ринги с outline: none, призрачные кнопки с невидимой рамкой и экраны, где несколько залитых кнопок борются за внимание пользователя.
Этот инструмент рассчитан только на аудит готовых экранов; для расчёта размеров и позиций кнопок в новом дизайне автор прямо рекомендует брать fitts-law.
Какие задачи решает
- найти интерактивные элементы, которые маскируются под статичный контент
- выявить скрытые за ховером действия, недоступные на сенсорных экранах
- обнаружить подавленные индикаторы фокуса и неочевидные заблокированные кнопки
- устранить конкуренцию между несколькими главными кнопками на одном экране
Примеры запросов агенту
- Проанализируй этот свёрстанный экран через critique-affordance и проверь кликабельность кнопок
- Проверь видимость состояний и читаемость CTA на этой странице с помощью critique-affordance
- Оцени доступность действий на форме оформления заказа через critique-affordance
Как установить critique-affordance
1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill critique-affordance -a claude-code2Вручную: положить файлы
~/.claude/skills/critique-affordance/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/critique-affordance/
1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill critique-affordance -a codex2Вручную: положить файлы
.agents/skills/critique-affordance/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill critique-affordance -a cursor2Вручную: положить файлы
.cursor/skills/critique-affordance/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Owl-Listener/designer-skills critique-affordance2Вручную: положить файлы
.github/skills/critique-affordance/SKILL.md1Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill critique-affordance -a gemini-cli2Командой платформы
gemini skills install https://github.com/Owl-Listener/designer-skills --path visual-critique/skills/critique-affordanceВручную: положить файлы
.devin/skills/critique-affordance/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill critique-affordance -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о critique-affordance
Как установить critique-affordance в Claude Code?
Выполните команду npx skills add Owl-Listener/designer-skills --skill critique-affordance -a claude-code.
Что делает critique-affordance?
Он оценивает кликабельность элементов, доступность действий без наведения курсора, читаемость главного CTA и наглядность состояний интерфейса вроде фокуса или блокировки.
В чём разница между critique-affordance и fitts-law?
Скилл critique-affordance нужен для ревью уже существующего свёрстанного экрана, тогда как fitts-law используется для расчёта размеров и размещения элементов при проектировании нового интерфейса.
Исходный текст
SKILL.md · MIT
---
name: critique-affordance
description: Critique a rendered screen's affordances — what looks clickable, state visibility, CTA clarity, and action discoverability. Use when reviewing an existing screen. For sizing and positioning targets in new work, use `fitts-law` (interaction-design).
---
# Critique Affordance
You are an expert in interaction design and the visual communication of interactivity.
## What You Do
You analyse a screen to identify whether interactive elements are visually distinguishable, whether states are communicated clearly, and whether the primary action is obvious. You flag affordance failures and propose specific fixes.
## Critique Dimensions
### Clickability Signals
Evaluate whether interactive elements look interactive.
- Do buttons, links, and controls look distinct from static content through colour, shape, underline, or elevation?
- Are there elements that look interactive but are not (false affordances)?
- Are there elements that are interactive but look static (missing affordances)?
- Is the interactive area large enough — touch targets should be at least 44×44px on mobile.
### State Visibility
Evaluate whether element states are visually communicated.
- Are default, hover, active, focus, disabled, and selected states visually distinct?
- Is the focus state visible and high-contrast (not just the browser default ring on a coloured background)?
- Are loading and skeleton states present where async content is expected?
- Are disabled states clearly communicated without relying on colour alone?
### CTA Clarity
Evaluate whether the primary action on screen is immediately obvious.
- Is there a single dominant CTA per view, or are multiple actions competing at the same visual weight?
- Does the primary CTA use filled/solid style while secondary actions use ghost or text variants?
- Is the CTA label specific and action-oriented ("Save changes", not "OK")?
- Is the CTA positioned where users expect it — bottom-right on forms, inline after content blocks?
### Action Discoverability
Evaluate whether all available actions can be found without instruction.
- Are actions hidden behind hover states or tooltips that mobile users can't access?
- Are contextual actions (edit, delete, share) visible or indicated — not completely hidden until hover?
- Are empty states actionable — do they tell the user what to do next?
- Are destructive actions (delete, remove) visually distinguished from constructive ones?
## Output Format
For each dimension — Clickability Signals, State Visibility, CTA Clarity, Action Discoverability — provide:
1. **Observation** — what you see (neutral, factual)
2. **Problem** — what is broken and why it matters
3. **Fix** — a specific, actionable change
Rate each dimension: `pass` / `minor issue` / `major issue`.
## Common Failure Patterns
- Ghost buttons in low-contrast contexts where the border becomes invisible
- Focus rings suppressed with `outline: none` and no replacement state
- Multiple filled CTAs on one screen, leaving users unsure which to press
- Edit and delete actions hidden behind hover — inaccessible on touch and invisible until discovered by accident
- Empty states that explain nothing and offer no path forward
© Owl-Listener · MIT · Owl-Listener/designer-skills