К основному содержанию
скилл CX Codex

viewports — скилл для Claude Code: проверка адаптивности

Скилл viewports для Claude Code проверяет страницу на переполнение и проблемы с элементами интерфейса. Запускается после изменений вёрстки или по запросу проверить конкретный телефон или ширину.

MIT 180 установок ★ 69 обновлён 2026-11-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add raphaelsalaja/skills --skill viewports -a claude-code
Открыть на GitHub

Что делает viewports

Скилл рендерит страницу на заданных ширинах, у границ брейкпоинтов, в коротком альбомном окне и с увеличенным до 200% текстом. Он проверяет горизонтальную прокрутку, обрезанные надписи, мелкие области нажатия и элементы, доступные только при наведении. Для каждого размера создаётся скриншот, а найденные проблемы привязываются к ширине и правилу проверки.

Скилл читает брейкпоинты из CSS, конфигурации Tailwind или токенов, а overflow.js запускает через вызов evaluate в браузере. Результаты скрипта считаются кандидатами, пока их не подтверждает фрагмент скриншота. Браузер должен поддерживать эмуляцию устройства и касаний: без рендера конкретной ширины проверка получает статус Not verified. В отчёте идут находки по ширине, сводка по серьёзности и решение Block или Approve.

Какие задачи решает

  • найти горизонтальную прокрутку на узком экране
  • проверить вёрстку по обе стороны брейкпоинта
  • обнаружить обрезанные надписи и перекрытия при увеличении текста
  • выявить элементы управления, доступные только при наведении
  • проверить доступность действий в коротком окне и на сенсорном экране

Примеры запросов агенту

  • Проверь эту страницу на ширинах из набора и у границ брейкпоинтов.
  • Найди обрезанный текст и горизонтальную прокрутку на телефоне.
  • Проверь диалоги в альбомной ориентации и при масштабе текста 200%.

Как установить viewports

1Через Skills CLI (Vercel)

npx skills add raphaelsalaja/skills --skill viewports -a claude-code

2Вручную: положить файлы

~/.claude/skills/viewports/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/viewports/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о viewports

Как установить viewports в Claude Code?

Выполни npx skills add raphaelsalaja/skills --skill viewports -a claude-code. Файл скилла появится по пути ~/.claude/skills/viewports/SKILL.md.

Что делает viewports?

Скилл снимает страницу на разных ширинах и проверяет переполнение, обрезанный текст и элементы управления. В отчёте он указывает ширину каждой находки.

Что проверяет viewports на сенсорных экранах?

Он эмулирует касания и ищет действия, которые доступны только при наведении. Также проверяет диалоги и меню в коротком альбомном окне.

Исходный текст

SKILL.md · MIT
---
name: viewports
description: Renders a page at every width, each breakpoint edge, a short landscape phone and 200% text, then reports what overflows, clips or hides.
---

# Viewports

This skill renders one page at a fixed set of widths and heights. It measures each render for sideways scroll, clipped text, small targets and controls that only hover reveals.

## Every width rendered, none inferred

The widths are exact: 320, 375, 768, 1024 and 1440, plus 1px either side of each project breakpoint. A width reasoned from the media queries is a finding. Run it after any layout change and whenever the user names a phone or a width.

Opening the result belongs to `verify`. Alignment inside one render belongs to `alignment`. Safe areas, hit areas and dynamic viewport units belong to `defaults`, and a failure there cites its id.

## 1. Read the breakpoints

Read the breakpoints from the CSS, the Tailwind config or the tokens. Add 1px below and 1px above each one to the fixed widths. A sweep that skips the edges of a breakpoint is `viewports-cross-each-breakpoint`.

## 2. Render each width

Set the viewport through device emulation at each width. Use 320×568, 375×812, 768×1024, 1024×768 and 1440×900. Breakpoint edges render 800px tall. Emulate touch at every width under 1024. Take a full-page screenshot of each. A layout judged from the code is `viewports-render-every-width`.

## 3. Measure each render

Run [overflow.js](overflow.js) through the browser's evaluate call at each width. Treat each result as a candidate until a crop of that width shows it.

The page never scrolls sideways, though a box may scroll inside itself. A 40px sideways scroll at 320 is `viewports-no-sideways-scroll`.

Text is never cut by its box without an ellipsis or a clamp. A button label cut in half at 375 is `viewports-no-clipped-text`. A target under 24px cites `defaults-hit-area`.

## 4. Tap at touch widths

Tap through the page with touch emulated. Row actions, copy buttons and menus that appear on hover need another way to appear. A delete button that shows only on row hover is `viewports-no-hover-only-controls`.

## 5. Shorten the height

Render 812×375, a phone held sideways. Open each dialog, sheet and menu at that size. Content scrolls inside the overlay and its actions stay reachable. A dialog whose `Save` sits below the screen with no scroll is `viewports-short-heights`.

## 6. Double the text

At 1024 wide, set the root font size to 200% and render again. Text wraps and its boxes grow, with nothing overlapping. Labels overlapping their icons at 200% is `viewports-text-zoom`. A layout that cannot grow because sizes are set in `px` gets the same id.

## 7. Report by width

Return one screenshot per width with the overlay numbers, then the findings in the same order. A finding with no width named is `viewports-name-the-width`.

## The pair

Every check is a pair. The broken line sits beside the line that replaces it.

| Rule | Broken | Replacement |
| --- | --- | --- |
| `viewports-cross-each-breakpoint` | Checked at 375 and 1440 only | Also at 767 and 768, 1023 and 1024 |
| `viewports-render-every-width` | "The grid collapses at `md`, so mobile is fine" | Screenshots at 320, 375 and 768 |
| `viewports-no-sideways-scroll` | A `width: 400px` card at 320 | `max-width: 100%` on the card |
| `viewports-no-clipped-text` | `overflow: hidden` cutting a label at 375 | The label wraps, or truncates with a way back |
| `viewports-no-hover-only-controls` | Row actions behind `:hover` alone | Shown at all times under `(hover: none)` |
| `viewports-short-heights` | A dialog's `Save` below a 375px screen | `max-height: 100dvh` with the body scrolling |
| `viewports-text-zoom` | `height: 32px` on a button that clips at 200% | `min-height: 2rem` with padding |
| `viewports-name-the-width` | "The header overlaps" | "At 768, the header overlaps the search field" |

## Reporting

**Severity.** `HIGH` is sideways page scroll, a control that hover alone reveals on touch or an action unreachable at a short height. `MEDIUM` is clipped text, overlap at 200% text or a break at a breakpoint edge. `LOW` is a finding that does not name its width.

**Format.** One finding per root cause, naming the width:

```
1. file:line - [rule-id] at 375, what is wrong (measured values)
```

Cite the script's element when the source line is not found. Then a `Rule | Count | Severity` summary. `Block` when any `HIGH` remains, `Approve` otherwise. Mark any width you could not render as `Not verified`.

© raphaelsalaja · MIT · raphaelsalaja/skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
responsive-design Owl-Listener Скилл responsive-design для ИИ-агента, который помогает проектировать макеты и взаимодействия под разные размеры экрана и способы ввода. CX Codex +1 2 700установок mobile-friendly kostja94 Скилл mobile-friendly для Claude Code: разбирает мобильную версию сайта — viewport, шрифты, зоны нажатия, паритет контента с десктопом. Работает там, где Google индексирует мобильную версию. CX Codex +1 1 100установок mobile-first-design aj-geddes Скилл mobile-first-design для Claude Code задаёт порядок работы над интерфейсом: сначала мобильный экран, потом планшет и десктоп. Помогает предотвратить разъезжание вёрстки на телефонах. CX Codex +1 879установок tailwind-responsive-design TheBushidoCollective Скилл tailwind-responsive-design помогает собирать адаптивные интерфейсы на Tailwind CSS: от mobile-first сеток до типографики и скрытия элементов по брейкпоинтам. CX Codex +1 235установок web-design-reviewer официальный github Скилл web-design-reviewer для GitHub Copilot проверяет работающий сайт на проблемы вёрстки, адаптивности и доступности, затем может исправить их в исходном коде. Повторно проверяет результат. CX Codex +1 13 957установок audit aladicf Скилл audit прогоняет код по пяти направлениям: доступность, производительность, темы, адаптивность и анти-паттерны. Выдаёт отчёт со скорингом и планом правок. CX Codex +1 729установок

Из того же набора25

Весь набор →
motion Скилл motion для Claude Code задаёт правила анимации интерфейсов: переходы, жесты, длительность и размытие. Помогает настроить движение элементов и проверить его поведение при взаимодействии. CX Codex +1 259установок gather Скилл gather для Claude Code собирает дизайн-референсы из выбранных источников в одну доску со ссылками. Запускается по просьбе найти вдохновение или улучшить экран. CX Codex +1 187установок alignment Скилл alignment для Claude Code проверяет выравнивание и визуальный баланс работающей страницы. Его запускают для поиска смещений, неровных отступов и несовпадений радиусов. CX Codex +1 183установок deconstruct Скилл deconstruct для Claude Code деконструирует анимации и интерфейсные взаимодействия в машину состояний и покадровый таймлайн. CX Codex +1 182установок color Скилл color для Claude Code проверяет экранный контраст текста и элементов интерфейса, привязывает цвета к ролевым токенам и валидирует тёмную тему. Запускается при вёрстке экранов и дизайн-ревью. CX Codex +1 178установок audit Скилл audit для Claude Code, запускающий сводный аудит изменений по набору правил и формирующий интерактивный отчёт. Оценивает диффы, ветки, сессии или весь репозиторий. CX Codex +1 176установок frames Скилл frames для Claude Code записывает трассу взаимодействия при ограничении CPU и находит причину потерянных кадров или задержки ввода. После исправления он сравнивает новую запись с исходной. CX Codex +1 176установок match Скилл match для Claude Code воссоздаёт названную часть интерфейса по реальному образцу и сравнивает обе версии. Запускается, когда в запросе есть приложение, URL, скриншот или дизайн-референс. CX Codex +1 175установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой