web-design-guidelines · tech-leads-club — скилл для Claude Code: что делает и установка
Скилл web-design-guidelines проверяет интерфейсный код на соответствие Web Interface Guidelines. Помогает найти ошибки доступности, проблемные формы и сбои гидратации.
MIT ★ 7 191 обновлён 2026-10-24
npx skills add tech-leads-club/agent-skills --skill web-design-guidelines -a claude-codeЧто делает web-design-guidelines
Скилл анализирует указанные файлы интерфейса по правилам из встроенного руководства references/guideline.md. Проверка затрагивает семантический HTML, разметку ARIA, навигацию с клавиатуры и состояния фокуса. В список правил входят безопасность гидратации, поддержка тёмной темы, адаптация к prefers-reduced-motion и задержки нажатий на тач-экранах.
Отчёт формируется кратко, в формате file:line, по которому удобно кликать в VS Code. Скилл указывает файл, номер строки и суть найденной проблемы. Разъяснения даются только тогда, когда способ исправления неочевиден.
Инструмент рассчитан исключительно на визуальный дизайн и паттерны взаимодействия. Для проверки SEO или замера показателей Core Web Vitals он не подходит: автор прямо советует отдельные скиллы для этих направлений.
Какие задачи решает
- найти пропущенные атрибуты ARIA и ошибки клавиатурной навигации
- выявить риски сбоев гидратации в клиентских компонентах
- проверить корректность автозаполнения и подписей в формах
- обнаружить проблемы с отступами и зонами нажатия на смартфонах
Примеры запросов агенту
- Проверь доступность и вёрстку в src/components/Header.tsx
- Сделай дизайн-аудит формы в components/CheckoutForm.tsx
- Проверь файлы по паттерну src/ui/**/*.tsx на соответствие гайдлайнам
Как установить web-design-guidelines
1Через Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill web-design-guidelines -a claude-code2Вручную: положить файлы
~/.claude/skills/web-design-guidelines/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/web-design-guidelines/
1Через Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill web-design-guidelines -a codex2Вручную: положить файлы
.agents/skills/web-design-guidelines/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill web-design-guidelines -a cursor2Вручную: положить файлы
.cursor/skills/web-design-guidelines/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install tech-leads-club/agent-skills 'packages/skills-catalog/skills/(design)/web-design-guidelines'2Вручную: положить файлы
.github/skills/web-design-guidelines/SKILL.md1Через Skills CLI (Vercel)
npx skills add tech-leads-club/agent-skills --skill web-design-guidelines -a gemini-cli2Командой платформы
gemini skills install https://github.com/tech-leads-club/agent-skills --path 'packages/skills-catalog/skills/(design)/web-design-guidelines'Вручную: положить файлы
.devin/skills/web-design-guidelines/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о web-design-guidelines
Как установить web-design-guidelines в Claude Code?
Выполните команду npx skills add tech-leads-club/agent-skills --skill web-design-guidelines -a claude-code. Также можно вручную поместить файл скилла в ~/.claude/skills/web-design-guidelines/SKILL.md.
Что проверяет скилл web-design-guidelines?
Он ищет нарушения в разметке компонентов: неверный фокус, отсутствие меток у полей, некорректные размеры картинок, проблемы интернационализации и отсутствие поддержки системной анимации.
Заменяет ли этот скилл проверку SEO и производительности?
Нет. Скилл сфокусирован только на визуальных интерфейсах и взаимодействии. Для аудита скорости страницы и поисковой оптимизации требуются отдельные инструменты вроде core-web-vitals и seo.
Исходный текст
SKILL.md · MIT
--- name: web-design-guidelines description: Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices". Focuses on visual design and interaction patterns. Do NOT use for performance audits (use core-web-vitals), SEO (use seo), or comprehensive site audits (use web-quality-audit). metadata: author: vercel version: '1.0.0' argument-hint: <file-or-pattern> --- # Web Interface Guidelines Review files for compliance with Web Interface Guidelines. ## How It Works 1. Read the guidelines from `#[[file:references/guideline.md]]` 2. Read the specified files (or prompt user for files/pattern) 3. Check against all rules in the guidelines 4. Output findings in the terse `file:line` format ## Guidelines Reference All rules and output format instructions are in: ``` #[[file:references/guideline.md]] ``` The guidelines cover: - Accessibility (ARIA, semantic HTML, keyboard navigation) - Focus states and keyboard interaction - Forms (autocomplete, validation, labels) - Animation (reduced motion, performance) - Typography (proper characters, number formatting) - Content handling (overflow, empty states) - Images (dimensions, lazy loading) - Performance (virtualization, DOM reads) - Navigation & state (URL sync, deep linking) - Touch & interaction (tap delays, safe areas) - Dark mode & theming - Locale & i18n - Hydration safety - Common anti-patterns to flag ## Usage When a user provides a file or pattern argument: 1. Read the guidelines from `references/guideline.md` 2. Read the specified files 3. Apply all rules from the guidelines 4. Output findings using the format specified in the guidelines If no files specified, ask the user which files to review. ## Output Format Follow the format in the guidelines: - Group findings by file - Use `file:line` format (VS Code clickable) - Terse, high signal-to-noise - State issue + location - Skip explanation unless fix is non-obvious
© vercel · MIT · tech-leads-club/agent-skills
Похожие скиллы
Все скиллы по теме «Фронтенд и UI» →Сначала — web-design-guidelines от других авторов.