Skip to main content
skill CX Codex

threejs-debugging — Claude Code skill: what it does and how to install

The threejs-debugging Claude Code skill traces rendering faults in Three.js scenes. It kicks in for blank canvases, missing meshes, color issues, flicker, picking failures, or lost graphics context.

MIT 658 installs ★ 26 updated 2026-09-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add cesartevisual/threejs-skills --skill threejs-debugging -a claude-code
Open on GitHub

What threejs-debugging does

The skill helps narrow down Three.js rendering failures, from an empty canvas to asset loading errors and lost context. It asks for console output, failed requests, and a minimal reproduction, then points to the diagnostic decision tree in references/diagnostics.md.

Checks cover canvas dimensions, the render loop, camera setup, materials, picking coordinates, and other likely causes. The skill also calls for retesting the action that failed and nearby states that share its code. It follows the project's installed versions and architecture, and avoids unrelated dependency upgrades.

What it helps with

  • trace why a Three.js canvas stays blank
  • investigate missing meshes or incorrect colors
  • pin down flicker in a rendered scene
  • debug object picking and context loss

Example prompts for the agent

  • Find why the Three.js canvas is blank and walk through the likely causes.
  • Investigate the flicker and incorrect color in this scene.
  • Work out why clicking an object selects the wrong position.

How to install threejs-debugging

1Skills CLI (Vercel)

npx skills add cesartevisual/threejs-skills --skill threejs-debugging -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/threejs-debugging/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about threejs-debugging

How do I install threejs-debugging in Claude Code?

Run npx skills add cesartevisual/threejs-skills --skill threejs-debugging -a claude-code. The skill file is at ~/.claude/skills/threejs-debugging/SKILL.md.

What does threejs-debugging do?

It helps diagnose Three.js rendering faults such as blank canvases, missing meshes, color problems, flicker, picking bugs, and context loss. It gathers symptoms and guides checks that narrow down the cause.

How does the skill investigate a blank canvas?

It checks drawing dimensions, the render loop, renderer creation, camera framing, object visibility, and transforms. Swapping in an unlit diagnostic material can help separate lighting faults from geometry issues.

Source text

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

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set24

The whole set →
threejs-interaction This Claude Code skill guides Three.js interaction work, from object picking to orbit controls. It applies when an agent is asked to add dragging, selection, or synchronized HTML controls. CX Codex +1 681installs threejs-assets The threejs-assets Claude Code skill guides loading and managing glTF models, textures, and user-provided 3D files. It applies to asset validation, compression, caching, and cleanup in Three.js projects. CX Codex +1 676installs threejs-scene This skill for Claude Code configures Three.js scene hierarchies, camera framing, coordinate transforms, and renderer lifecycles. It enforces proper GPU cleanup and bounds calculations. CX Codex +1 671installs threejs-materials The threejs-materials Claude Code skill configures Three.js PBR materials, textures, transparency, and color handling. It activates when a scene needs a surface setup or a material-related color fix. CX Codex +1 668installs threejs-postprocessing This Claude Code skill adds or debugs Three.js postprocessing. It handles tasks involving bloom, antialiasing, ambient occlusion, depth effects, and render-target composition. CX Codex +1 651installs threejs-particles Claude Code skill for building Three.js particle systems, point clouds, and GPU simulations. CX Codex +1 648installs threejs-accessibility The threejs-accessibility Claude Code skill makes Three.js interactions usable with keyboards and assistive technology. It applies when adding accessibility to 3D scenes and controls. CX Codex +1 644installs threejs-geometry This Claude Code skill creates and refines Three.js geometry. It activates for work on BufferGeometry, procedural meshes, and instanced objects. CX Codex +1 638installs

Project sponsors

Companies that keep this analytics open