threejs-testing — скилл для Claude Code: что делает и как установить
Скилл threejs-testing для Claude Code задаёт правила визуального и интеграционного тестирования сцен Three.js в браузере. Включается при создании автотестов графики и скриншотных проверок.
MIT 681 установок ★ 26 обновлён 2026-09-10
npx skills add cesartevisual/threejs-skills --skill threejs-testing -a claude-codeЧто делает threejs-testing
Инструктирует агента тестировать Three.js через запуск продакшен-сборки и браузерные фикстуры, а не только через моки рендерера. Мок не доказывает корректность вывода пикселей на GPU. Скилл предписывает делать графические тесты детерминированными: фиксировать сид генератора случайных чисел, положение камеры, вьюпорт, devicePixelRatio и останавливать анимацию на заданном таймстемпе.
Агент ждёт смыслового сигнала готовности ассетов и кадра вместо случайных пауз sleep. Для пикселей GPU применяются толерантные сравнения, поскольку рендеринг зависит от драйверов видеокарты. Тесты также проверяют утечки при уничтожении объектов, поведение при изменении вьюпорта, тач-события и ошибки в консоли браузера.
Какие задачи решает
- настроить воспроизводимые скриншотные тесты сцен Three.js
- проверить корректность освобождения ресурсов и teardown сцены
- протестировать рендеринг при смене вьюпорта и ресайзе
- зафиксировать консольные и сетевые ошибки при загрузке 3D-ассетов
Примеры запросов агенту
- Напиши скриншотный тест для Three.js сцены с фиксированным положением камеры и сидом
- Проверь очистку памяти и вызовы teardown после удаления 3D-компонента
- Настрой проверку рендеринга в Playwright с допустимой погрешностью пикселей
Как установить threejs-testing
1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-testing -a claude-code2Вручную: положить файлы
~/.claude/skills/threejs-testing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/threejs-testing/
1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-testing -a codex2Вручную: положить файлы
.agents/skills/threejs-testing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-testing -a cursor2Вручную: положить файлы
.cursor/skills/threejs-testing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cesartevisual/threejs-skills skills/threejs-testing2Вручную: положить файлы
.github/skills/threejs-testing/SKILL.md1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-testing -a gemini-cli2Командой платформы
gemini skills install https://github.com/cesartevisual/threejs-skills --path skills/threejs-testingВручную: положить файлы
.devin/skills/threejs-testing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-testing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о threejs-testing
Как установить threejs-testing в Claude Code?
Выполните команду npx skills add cesartevisual/threejs-skills --skill threejs-testing -a claude-code или добавьте файл по пути ~/.claude/skills/threejs-testing/SKILL.md.
Что делает threejs-testing?
Скилл описывает правила интеграционного и визуального QA для Three.js: настройку фикстур, фиксацию случайных значений, скриншотные проверки и тестирование жизненного цикла сцены.
Зачем запускать тесты в браузере, а не с моком рендерера?
Мокированный рендерер не проверяет фактический вывод пикселей видеокартой. Для проверки работы с GPU скилл требует запускать собранный проект в реальном браузере.
Исходный текст
SKILL.md · MIT
--- name: threejs-testing description: "Test Three.js features with browser checks, deterministic visual fixtures, lifecycle tests, and device-specific evidence." --- # 3D Testing and Visual QA Use the project's installed versions and existing architecture. These instructions supplement the user's task; they do not authorize unrelated changes or external actions. Translate the requested behavior into observable checks: visible subject, correct framing, interaction outcomes, load failure/retry, resize, teardown, and any explicit performance target. Keep test scope proportional to the change. Use unit tests for pure coordinate transforms, selection mapping, timestep policies, and reducers where these are meaningful. A mocked renderer cannot prove pixels render correctly. Run the production build and a browser fixture for GPU integration. Make visual fixtures reproducible: seed randomness, fix camera/viewport/pixel ratio, stop or seek animation to a known time, and wait for asset readiness plus a rendered frame. Use a semantic readiness signal, not an arbitrary sleep. Capture console and network failures along with screenshots. Use tolerant comparisons for GPU-dependent pixels; avoid treating exact image equality across unrelated drivers as a portable contract. Inspect screenshots for cropping, contrast, shadow defects, text/overlay occlusion, and loading remnants. Scope browser feature expectations to the tested backend. Exercise repeated navigation, rapid asset changes, hidden-to-visible sizing, touch interaction, reduced motion, unsupported rendering, and the relevant real device/browser. Headless software rendering is not a mobile GPU benchmark. Report checks as passed, failed, or not run with reasons. Do not claim performance, XR hardware support, or assistive-technology behavior from compilation alone. ## API reference Consult the [official documentation](https://playwright.dev/docs/test-snapshots) for exact signatures and revision-specific behavior. If documentation access is unavailable, inspect installed types/source and state any remaining uncertainty.
© cesartevisual · MIT · cesartevisual/threejs-skills