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

site-check — скилл для Claude Code: проверка 3D-страниц

Скилл site-check для Claude Code проверяет 3D- и анимированные веб-страницы в браузерах Chromium и WebKit. Запускается после изменений, чтобы найти ошибки, проблемы мобильной вёрстки и просадки производительности до публикации.

MIT ★ 448 обновлён 2026-11-09

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Moh4696/open-3d-skills
/plugin install open-3d-skills@open-3d-skills
Открыть на GitHub

Что делает site-check

Скилл делает снимки страницы в разных состояниях, размерах экрана и позициях прокрутки. Проверяет ошибки страницы и запросов, пустой WebGL-холст, горизонтальную прокрутку и режим reduced motion; измеряет время кадра, вызовы отрисовки и число треугольников. Результат — отчёт report.json и лист sheet.jpg со снимками, на которых проблемы отмечены красным.

Проверка запускается скриптом scripts/check.py через Playwright; для анализа счётчиков three.js страница должна предоставлять рендерер в window.__app.renderer. Нужны Python 3.9+, пакеты playwright и pillow, установленные браузеры Chromium и WebKit, а также HTTP-сервер. В комплекте есть scripts/serve.py, который поддерживает Range-запросы; python3 -m http.server для поиска по видео не подходит. Проверка не заменяет ручной осмотр швов анимации, взаимодействий и длительных сессий.

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

  • найти пустой WebGL-холст и ошибки загрузки ресурсов
  • сравнить отображение страницы в Chromium и WebKit
  • проверить вёрстку на телефоне и планшете
  • заметить горизонтальную прокрутку и проблемы reduced motion
  • измерить время кадра и нагрузку на отрисовку

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

  • Проверь эту 3D-страницу в Chromium и Safari на телефоне и планшете.
  • Сделай снимки всех состояний view и light, собери лист и отчёт.
  • Проверь анимацию при прокрутке и найди ошибки запросов.

Как установить site-check

1Через маркетплейс плагинов

/plugin marketplace add Moh4696/open-3d-skills
/plugin install open-3d-skills@open-3d-skills

Команда ставит плагин open-3d-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add Moh4696/open-3d-skills --skill site-check -a claude-code

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

~/.claude/skills/site-check/SKILL.md

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

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

Вопросы о site-check

Как установить site-check в Claude Code?

Добавь маркетплейс командой /plugin marketplace add Moh4696/open-3d-skills, затем установи скилл: /plugin install open-3d-skills@open-3d-skills.

Что делает site-check?

Проверяет 3D- и анимированные страницы в Chromium и WebKit на разных размерах экрана и состояниях. Сохраняет снимки, отчёт с метриками и контактный лист.

Что нужно для работы site-check?

Нужны Python 3.9+, пакеты playwright и pillow, установленные сборки Chromium и WebKit из Playwright и HTTP-сервер. Для счётчиков three.js страница должна открыть рендерер через window.__app.renderer.

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

SKILL.md · MIT
---
name: site-check
description: Verifies a 3D or animated web page in real headless browsers before anyone else sees it. Shoots every view, light state and scroll position at desktop, tablet and phone widths in Chromium and WebKit (Safari), measures frame time, draw calls and triangles, catches page errors, failed requests, blank WebGL canvases, horizontal overflow and reduced-motion behaviour, and builds one contact sheet. Use after building or changing any three.js, WebGL, canvas, scroll-driven or animated page, before publishing or recording it, or when someone asks "does it work", "check it on mobile", "why is it slow" or "test it in Safari".
---

# Site check

An animated page can look perfect in the one browser tab it was built in and fail everywhere else: a blank canvas in Safari, a crop on phones, a seam in a scroll film, a 40 ms frame on a laptop. This skill looks at the page the way visitors will, in several real browsers at several sizes, and reports what broke with pictures.

## Tool

`scripts/check.py` drives headless Chromium (on the real GPU) and WebKit through Playwright.

```bash
python3 scripts/check.py http://127.0.0.1:8000/ --out shots \
  --widths 1440,768,390 --browser both \
  --query "view=front" "view=aerial&light=night" \
  --scroll-steps 6 --ready "window.__ready === true"
```

| Option | Meaning |
| --- | --- |
| `--query` | Query strings appended to the URL, each shot at every width. Give pages deep links (`?view=`, `?light=`, `?step=`) so every state is reachable |
| `--widths` | 1440 (laptop), 768 (tablet), 390 (phone, emulated with touch and DPR 2) |
| `--browser` | `chromium`, `webkit` (Safari's engine) or `both` |
| `--scroll-steps N` | Also shoots N evenly spaced scroll positions, for scroll-driven pages |
| `--ready` | JS expression that is true once the page has rendered for real |
| `--wait` | Seconds to let things settle before measuring |

Output: one PNG per shot, `report.json`, and `sheet.jpg` with every shot labelled; problem shots are labelled in red. The script exits 1 if any shot had a page error, a failed or 4xx/5xx request, a blank canvas or horizontal overflow. Each shot also gets a reduced-motion pass at the widest width.

Needs Python 3.9+, `pip install playwright pillow`, and `python3 -m playwright install chromium webkit`. Serve the page over HTTP (ES modules and video seeking need it) with `scripts/serve.py DIR --port 8000`; it answers Range requests, which `python3 -m http.server` does not.

## Reading the report

- **ms per frame** is measured over 60 real frames. Under 16.7 is 60 fps; headless on a laptop GPU should sit near 16.7 (vsync), so a higher number means real cost. Compare runs with each other. If the report says the renderer is SwiftShader or llvmpipe, the GPU was not used and frame times mean nothing.
- **calls / triangles** come from `window.__app.renderer` (three.js), counted for a whole frame including every post-processing pass. Expose the renderer there so the check can see it.
- **ready_s** is how long the page took to set its ready flag. Over 3 s on a fast machine means the loader is visible for too long on a phone.
- **blank canvas** means a visible canvas was one flat colour: a WebGL context that failed, a shader that did not compile in that browser, or a frame drawn before assets loaded.

## Then look

The numbers catch breakage; your eyes catch ugliness. Open `sheet.jpg` and check each shot for:

- The subject cropped or tiny on the phone shot. 3D scenes should widen their vertical field of view on portrait screens; layouts should restack.
- Text over busy imagery without contrast.
- UI covering the subject, or sitting under the phone's home indicator.
- Lighting states that crush to black or clip to white.
- WebKit shots that differ from Chromium: colour (Safari ignores some colour-space hints), missing transparency (VP9 alpha video does not play in Safari), fonts.

## Checks the script cannot do alone

Run these by hand or with `frame-capture` at a low frame rate (`--fps 8`), which is fast and exact:

- **Seams and loops.** Scrub every scroll film up and down fast; watch each join and the wrap of every loop. `scroll-film/scripts/prep.py seams` scores joins numerically.
- **Pins release.** At the end of every pinned section the page must scroll on without a jump.
- **Long sessions.** Leave the page running for a minute, switch light presets back and forth, resize the window a few times; frame time should not creep up (leaked geometries and textures show in `report.json` as rising counts).
- **Throttled first load.** With network throttling, the first paint should be the hero's poster or first frame, not a blank page.
- **Interaction.** Orbit, zoom, hover states, keyboard focus on every control, and touch on a phone.

## Environment traps

- An embedded browser preview that is hidden, or a background tab, throttles or freezes `requestAnimationFrame`. A page that "does not animate" there may be fine. Headless browsers do not have this problem.
- `python3 -m http.server` ignores Range requests, so videos cannot seek and scroll-scrubbed video freezes. Use a server that answers them.
- A missing Playwright browser build after an upgrade: the script falls back to any Chromium in the Playwright cache; `CHROME_PATH` overrides it.

## Report back

Lead with what is broken, ranked by how many visitors it hits: errors and blank canvases first, then phone layout, then Safari differences, then performance, then polish. Attach the contact sheet. Say what was not checked (no real phone, no Windows GPU, no slow network) rather than implying it was.

© exploraX · MIT · Moh4696/open-3d-skills

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

Все скиллы по теме «Браузер и парсинг» →
charles-3d-explainers LemonFace0309 Скилл charles-3d-explainers для Claude Code создаёт 3D-ролики и вставки, синхронизированные с озвучкой. Запускается для объясняющих видео, 3D-анимации и замены фрагментов видео с говорящей головой. CX Codex +1 ★ 237звёзд репо agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок anti-detect-browser antibrow Скилл anti-detect-browser для Claude Code запускает Chromium с подлинным отпечатком устройства через Playwright API. Профиль сохраняется между запусками для тестирования, скрейпинга и многоаккаунтной работы. CX Codex +1 168 800установок browser-fingerprint-audit liarjsdev Скилл browser-fingerprint-audit находит нестыковки в отпечатке браузера через liarjs CLI. Пригодится при проверке профилей на маскировку и тестировании стабильности WebGL. CX Codex +1 132 900установок fingerprint-ci-gate liarjsdev Скилл fingerprint-ci-gate останавливает сборку в CI при деградации браузерного отпечатка Chromium. Сравнивает текущий прогон с эталонным снимком или проверяет минимальный порог очков. CX Codex +1 132 800установок web-perf cloudflare Скилл web-perf для Claude Code проводит аудит Core Web Vitals, диагностирует медленную загрузку и находит блокирующие скрипты в терминале. CX Codex +1 129 400установок

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

exploded-view Скилл exploded-view для Claude Code собирает интерактивные 3D-разборки машин и продуктов в three.js. Двигает детали по этапам, показывает внутренности корпуса и подписывает части модели. CX Codex +1 ★ 448звёзд репо motion-assets Скилл motion-assets для Claude Code планирует и создаёт изображения и видеоклипы для анимированных сайтов. Он включается при запросах сгенерировать графику, зациклить фон или анимировать изображение. CX Codex +1 ★ 448звёзд репо cursor-rig Скилл cursor-rig для Claude Code собирает из иллюстрации портрет, который поворачивает голову вслед за курсором. Он включается для анимированного героя страницы без 3D-модели и отслеживания лица. CX Codex +1 ★ 448звёзд репо alpha-cutout Скилл alpha-cutout для Claude Code удаляет фон у видеоклипа и готовит прозрачную анимацию для веб-страницы. Запускается по просьбе убрать фон или добавить видео с альфа-каналом поверх контента. CX Codex +1 ★ 448звёзд репо frame-capture Скилл frame-capture для Claude Code записывает веб-страницы в MP4 с покадровым управлением временем. Запускается для записи анимаций и прокрутки или сравнения двух клипов. CX Codex +1 ★ 448звёзд репо scroll-film Скилл scroll-film для Claude Code собирает кинематографичную анимацию, привязанную к прокрутке страницы. Помогает соединить видеоклипы, настроить паузы для подписей и загрузку кадров. CX Codex +1 ★ 448звёзд репо threejs-scene Скилл threejs-scene для Claude Code создаёт интерактивные 3D-сцены на three.js из кода, без файлов моделей. Включается для 3D-сайтов, WebGL-заставок и сцен реальных объектов. CX Codex +1 ★ 448звёзд репо open-3d-skills Плагин open-3d-skills для Claude Code помогает собирать 3D-сцены и анимированные сайты. Восемь скиллов охватывают сцены на three.js, видео с прокруткой и проверку в браузерах. CX Codex ★ 448звёзд репо

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

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