threejs-errors-rendering

Diagnose and fix Three.js rendering errors like black screens and z-fighting.

11|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/OpenAEC-Foundation/Three.js-Claude-Skill-Package --skill threejs-errors-rendering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: threejs-errors-rendering
Source: https://github.com/OpenAEC-Foundation/Three.js-Claude-Skill-Package/tree/main/skills/source/threejs-errors/threejs-errors-rendering
Command: npx skills add https://github.com/OpenAEC-Foundation/Three.js-Claude-Skill-Package --skill threejs-errors-rendering

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill guides developers when a Three.js scene renders incorrectly: black screen, invisible objects, wrong colors, z-fighting, or broken shadows. It also helps prevent common mistakes such as incorrect color space configuration, missing material.side, or forgetting updateProjectionMatrix, by outlining diagnosis steps and fix patterns.

Core Features & Use Cases

  • Diagnosis workflow: Step-by-step checks to identify rendering issues in a Three.js scene.
  • Fix patterns: Practical recipes for common rendering problems (color space, material settings, camera projection, lighting, shadows).
  • Real-world scenarios: Debug black screens, invisible meshes, color discrepancies, z-fighting, shadow artifacts in r160+ environments.

Quick Start

Describe the rendering symptom you observe (for example, a black screen or invisible object) and let the skill guide you through a step-by-step diagnosis and fixes.

Frequently Asked Questions about threejs-errors-rendering

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my Three.js scene render a black screen?

A black screen in Three.js typically results from missing lights, incorrect camera setup, or wrong color space configuration. This skill guides structured diagnosis steps to check render state, lighting, camera projection, and material settings to identify and fix the rendering failure.

How do I fix z-fighting artifacts in a Three.js WebGL scene?

To fix z-fighting in a Three.js scene, adjust camera near and far clipping planes or modify object scaling. This skill provides diagnosis workflows and fix patterns to resolve z-fighting and shadow artifacts by evaluating projection matrix settings and render state.

How do I correct wrong colors in a Three.js r160+ environment?

Wrong colors in Three.js r160+ often occur due to incorrect color space configuration or missing material side properties. This skill outlines diagnosis steps and fix patterns to harden scenes against color-space mistakes and ensure consistent rendering results.

What is the best way to debug invisible objects in Three.js?

The best way to debug invisible Three.js objects is to systematically check material side settings, camera updateProjectionMatrix calls, and lighting. This skill guides a step-by-step diagnosis workflow to identify missing or misconfigured render states causing invisible meshes.

Does this Three.js debugging workflow apply to shadow artifacts?

Yes, this workflow diagnoses and fixes shadow artifacts in Three.js scenes by evaluating lighting setups and render states. It applies to r160+ environments and provides practical recipes to correct projection mistakes and ensure deterministic shadow rendering.