interface-auditor — скилл для Claude Code: аудит UX-антипаттернов
Разбирает описание интерфейса на UX-антипаттерны: находит проблемы, ставит серьёзность и выдаёт шаги исправления в JSON.
npx skills add uxuiprinciples/agent-skills --skill interface-auditor -a claude-codeЧто делает interface-auditor
Скилл берёт текстовое описание экрана или формы и ищет в нём «запахи» из таксономии uxuiprinciples. Всего их 8 и они разложены по 6 категориям: efficiency, error-prevention, feedback, learnability, accessibility, consistency. Потом каждый сигнал из описания сопоставляется с симптомами, и скилл решает, что найдено точно, а что только подозревается.
Результат отдаётся строгим JSON без прозы. В нём список найденных запахов, совпавшие симптомы и серьёзность по трём уровням: critical, warning, suggestion. Порог срабатывания тоже прописан: запах считается обнаруженным, если совпали два симптома и больше. Ответ всегда в одной структуре, поэтому его удобно читать скриптом.
Полные рецепты исправления, оценки времени и связанные коды принципов тянутся через curl из API uxuiprinciples.com. Для этого нужен ключ UXUI_API_KEY в окружении. Без ключа скилл работает на внутреннем знании таксономии и ставит в ответе api_enriched: false. Про сами шаги ремонта тогда речи нет, так что на голом скилле вы получите только диагноз.
Какие задачи решает
- проверить описание формы до того, как её начнут верстать
- найти причину высокой доли отказов на экране
- собрать из описания макета список UX-проблем
- отделить критичные дефекты интерфейса от косметических
- получить JSON с находками для своего пайплайна
Примеры запросов агенту
- Проверь на UX-запахи описание экрана регистрации: десять полей, одна кнопка
Продолжить, ошибки показываются только после отправки - Прогони по таксономии категорию feedback для вот этого описания пустого состояния
- Что не так с навигацией в этом описании интерфейса? Отдай результат в JSON
Как установить interface-auditor
1Через Skills CLI (Vercel)
npx skills add uxuiprinciples/agent-skills --skill interface-auditor -a claude-code2Вручную: положить файлы
~/.claude/skills/interface-auditor/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/interface-auditor/
1Через Skills CLI (Vercel)
npx skills add uxuiprinciples/agent-skills --skill interface-auditor -a codex2Вручную: положить файлы
.agents/skills/interface-auditor/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add uxuiprinciples/agent-skills --skill interface-auditor -a cursor2Вручную: положить файлы
.cursor/skills/interface-auditor/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install uxuiprinciples/agent-skills interface-auditor2Вручную: положить файлы
.github/skills/interface-auditor/SKILL.md1Через Skills CLI (Vercel)
npx skills add uxuiprinciples/agent-skills --skill interface-auditor -a gemini-cli2Командой платформы
gemini skills install https://github.com/uxuiprinciples/agent-skills --path interface-auditorВручную: положить файлы
.devin/skills/interface-auditor/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add uxuiprinciples/agent-skills --skill interface-auditor -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о interface-auditor
Как установить interface-auditor в Claude Code?
Выполните npx skills add uxuiprinciples/agent-skills --skill interface-auditor -a claude-code, после установки скилл лежит в ~/.claude/skills/interface-auditor/SKILL.md.
Что делает interface-auditor?
Сопоставляет описание интерфейса с таксономией UX-запахов и возвращает JSON с находками, симптомами и уровнем серьёзности. Полные рецепты исправления подтягиваются из API, если задан UXUI_API_KEY.
Нужен ли ключ API для работы скилла?
Нет, он необязательный. Без UXUI_API_KEY скилл опирается на собственное знание таксономии и помечает ответ как необогащённый через API, но рецепты исправления и оценки времени тогда не выдаёт.
