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

threejs-debugging — скилл для Claude Code: диагностика Three.js

Скилл threejs-debugging для Claude Code помогает находить причины сбоев рендеринга в Three.js. Запускается при чёрном холсте, пропавших мешах, мерцании, ошибках выбора объектов или потере контекста.

MIT 658 установок ★ 26 обновлён 2026-09-10

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

Что делает 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-code

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

~/.claude/skills/threejs-debugging/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
threejs-materials CloudAI-X Скилл threejs-materials для Claude Code, Codex, Cursor и других платформ: подбор и настройка материалов three.js — от базовых до PBR, тун-шейдинга и точечных облаков. CX Codex +1 21 100установок threejs-geometry CloudAI-X Скилл threejs-geometry учит ИИ-агента создавать стандартные и процедурные геометрии three.js, настраивать буферные атрибуты и генерировать 3D-текст. CX Codex +1 20 600установок threejs-scene-setup gamedev-skills Скилл threejs-scene-setup для Claude Code настраивает базовую сцену three.js r187, камеру, рендерер и цикл анимации. Запускается при ошибках импорта модуля three, черном холсте или отсутствии анимации. CX Codex +1 11 100установок threejs-webgl freshtechbro Скилл threejs-webgl для Claude Code учит агента настраивать сцены Three.js, рендереры WebGL и WebGPU, свет, материалы и загрузку glTF-моделей. Описывает настройку Three.js для 3D-визуализаций и конфигураторов. CX Codex +1 5 300установок threejs-aaa-graphics-builder majidmanzarpour Скилл threejs-aaa-graphics-builder переводит браузерную 3D-графику Three.js из прототипа в качественный продакшен: настраивает материалы, свет, шейдеры и проверяет сцену по шкале качества. CX Codex +1 4 300установок threejs nexu-io Помогает ассистенту создавать 3D-сцены, настраивать материалы, камеру и пост-обработку на Three.js прямо в браузере. CX Codex +1 3 600установок

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

Весь набор →
threejs-interaction Скилл threejs-interaction для Claude Code помогает добавлять взаимодействие с объектами Three.js. Агент подключает его для выбора объектов указателем, перетаскивания и настройки управления камерой. CX Codex +1 681установок threejs-assets Скилл threejs-assets для Claude Code помогает загружать и обслуживать glTF-модели, текстуры и пользовательские 3D-файлы. Включается при работе с загрузкой, сжатием и кэшированием ресурсов Three.js. CX Codex +1 676установок threejs-scene Скилл threejs-scene для Claude Code и Codex выстраивает иерархии сцен Three.js, кадрирует камеры и настраивает цикл рендеринга. Предотвращает обрезку широких моделей и утечки памяти при размонтировании. CX Codex +1 671установок threejs-materials Скилл threejs-materials для Claude Code настраивает материалы PBR, текстуры и прозрачность в Three.js. Включается при создании поверхностей и исправлении цвета в 3D-сцене. CX Codex +1 668установок threejs-postprocessing Скилл threejs-postprocessing для Claude Code добавляет и отлаживает постобработку в Three.js. Подключается к задачам с bloom, сглаживанием, ambient occlusion и композицией render targets. CX Codex +1 651установок threejs-particles Скилл threejs-particles для Claude Code настраивает создание систем частиц, облаков точек и симуляций на CPU или GPU в проектах Three.js. CX Codex +1 648установок threejs-accessibility Скилл threejs-accessibility для Claude Code помогает сделать взаимодействия в Three.js доступными с клавиатуры и для вспомогательных технологий. Подключается при работе над доступностью 3D-сцен и интерфейсов. CX Codex +1 644установок threejs-geometry Скилл threejs-geometry для Claude Code создаёт и оптимизирует геометрию Three.js. Включается в задачах с BufferGeometry, процедурными мешами и инстансами. CX Codex +1 638установок

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

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