threejs-debugging — скилл для Claude Code: диагностика Three.js
Скилл threejs-debugging для Claude Code помогает находить причины сбоев рендеринга в Three.js. Запускается при чёрном холсте, пропавших мешах, мерцании, ошибках выбора объектов или потере контекста.
MIT 658 установок ★ 26 обновлён 2026-09-10
npx skills add cesartevisual/threejs-skills --skill threejs-debugging -a claude-codeЧто делает threejs-debugging
Скилл разбирает симптомы Three.js и помогает локализовать причину: от пустого холста и неверных цветов до ошибок загрузки ассетов и потери контекста. Он предлагает собрать ошибки консоли, неудачные запросы и минимальное воспроизведение, а затем свериться с деревом диагностики в references/diagnostics.md.
Для проверки сцены скилл предлагает по очереди исследовать размеры холста, цикл рендеринга, камеру, материалы, координаты выбора и другие возможные источники сбоя. Он также просит проверять исходное действие после исправления и соседние состояния с общим кодом. Диагностика опирается на установленные версии и архитектуру проекта; посторонние обновления зависимостей не входят в задачу.
Какие задачи решает
- найти причину чёрного холста или пропавших мешей
- разобраться с неверными цветами и мерцанием
- проверить выбор объектов по щелчку
- локализовать потерю графического контекста
Примеры запросов агенту
- Найди причину чёрного холста в сцене Three.js и объясни, какие проверки провести.
- Разбери, почему меш мерцает и отображается не тем цветом.
- Проверь, почему выбор объекта по щелчку не совпадает с его положением.
Как установить threejs-debugging
1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-debugging -a claude-code2Вручную: положить файлы
~/.claude/skills/threejs-debugging/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/threejs-debugging/
1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-debugging -a codex2Вручную: положить файлы
.agents/skills/threejs-debugging/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-debugging -a cursor2Вручную: положить файлы
.cursor/skills/threejs-debugging/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cesartevisual/threejs-skills skills/threejs-debugging2Вручную: положить файлы
.github/skills/threejs-debugging/SKILL.md1Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-debugging -a gemini-cli2Командой платформы
gemini skills install https://github.com/cesartevisual/threejs-skills --path skills/threejs-debuggingВручную: положить файлы
.devin/skills/threejs-debugging/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-debugging -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о threejs-debugging
Как установить threejs-debugging в Claude Code?
Выполни npx skills add cesartevisual/threejs-skills --skill threejs-debugging -a claude-code. Файл скилла находится по пути ~/.claude/skills/threejs-debugging/SKILL.md.
Что делает threejs-debugging?
Скилл помогает диагностировать сбои рендеринга Three.js: например, пустой холст, проблемы с мешами, цветом, мерцанием или выбором объектов. Он предлагает собрать симптомы и сузить круг причин проверками сцены.
Как скилл ищет причину чёрного холста?
Он предлагает проверить размеры холста, цикл рендеринга, создание рендерера, камеру, видимость объектов и преобразования. Замена материала объекта на диагностический помогает отделить проблему освещения от проблемы геометрии.
Исходный текст
SKILL.md · MIT
--- name: threejs-debugging description: "Diagnose Three.js black canvases, missing meshes, wrong colors, flicker, picking bugs, and context loss." --- # Rendering Diagnostics 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. Capture the visible symptom, console errors, failed requests, installed versions, backend, and a minimal reproduction before editing. Use [the symptom tree](references/diagnostics.md) to narrow likely causes. For a blank canvas, first verify nonzero container/drawing dimensions, a live render loop, successful renderer creation, camera projection/framing, object visibility/layers, and valid finite transforms. Replace only the subject material with an unlit diagnostic material to distinguish lighting from geometry problems. For asset failures inspect HTTP status, response content, CORS, decoder paths, and build base path. An HTML fallback response with status 200 is not a valid GLB. For color, trace texture classification through lighting, tone mapping, and output conversion. For flicker inspect coplanar geometry, near/far precision, transparency sorting, duplicate render loops, and competing transform writers. For picking verify canvas/view-relative coordinates, matrices, layers, instancing, and shader deformation mismatch. Reduce the failing scene one feature at a time while preserving evidence. Avoid unrelated dependency upgrades or disabling all error checks to make symptoms disappear. When context/device loss occurs, provide a clear recovery path rather than an unbounded renderer recreation loop. Verify the original failing action after the fix and check adjacent states that share the same code. Explain the cause and evidence, not just the changed line. ## API reference Consult the [official documentation](https://threejs.org/docs/) 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