threejs-lighting · cesartevisual — Claude Code skill for Three.js lighting
The threejs-lighting Claude Code skill guides lighting and shadow work in Three.js scenes. It comes into play when setting up environment maps, direct lights, or shadow maps.
MIT 694 installs ★ 26 updated 2026-09-10
npx skills add cesartevisual/threejs-skills --skill threejs-lighting -a claude-codeWhat threejs-lighting does
The skill helps shape scene lighting around the intended mood and material readability. For PBR objects, its guidance pairs an environment with a controlled key light; metallic surfaces need reflected surroundings rather than a stronger ambient setting.
Instructions cover environment mapping, limiting shadows to relevant lights and objects, and tuning shadow-camera coverage and bias. Baked lighting is considered for static scenes. Point-light shadows need several views and can be costly.
The guidance calls for checking shadow artifacts, texture seams, and moving objects near shadow-frustum edges, then comparing the scene with shadows enabled and disabled on the target device. Keep the project's existing architecture and installed versions. For exact API signatures, consult the Three.js documentation.
What it helps with
- choose lighting for PBR materials in a Three.js scene
- adjust shadow-camera coverage and bias
- limit shadow casting to selected lights and objects
- compare baked lighting with dynamic shadows
Example prompts for the agent
- Set up lighting and shadows for this Three.js scene.
- Choose an environment and key light for the metallic object.
- Check moving objects near the shadow-camera boundaries.
How to install threejs-lighting
1Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-lighting -a claude-code2Manually: put the files in place
~/.claude/skills/threejs-lighting/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/threejs-lighting/
1Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-lighting -a codex2Manually: put the files in place
.agents/skills/threejs-lighting/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-lighting -a cursor2Manually: put the files in place
.cursor/skills/threejs-lighting/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cesartevisual/threejs-skills skills/threejs-lighting2Manually: put the files in place
.github/skills/threejs-lighting/SKILL.md1Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-lighting -a gemini-cli2Platform CLI
gemini skills install https://github.com/cesartevisual/threejs-skills --path skills/threejs-lightingManually: put the files in place
.devin/skills/threejs-lighting/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cesartevisual/threejs-skills --skill threejs-lighting -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about threejs-lighting
How do I install threejs-lighting in Claude Code?
Run npx skills add cesartevisual/threejs-skills --skill threejs-lighting -a claude-code. The skill file is located at ~/.claude/skills/threejs-lighting/SKILL.md.
What does threejs-lighting do?
It provides guidance for lighting Three.js scenes with environment maps, direct lights, baked lighting, and shadow maps.
What should I check when tuning Three.js shadows?
Inspect shadow artifacts, detached contact shadows, thin surfaces, and moving objects at shadow-frustum edges. Compare the scene with and without shadows on the target device.
Source text
SKILL.md · MIT
--- name: threejs-lighting description: "Light Three.js scenes using environment maps, direct lights, baked light, and tuned shadow maps." --- # Lighting and Shadows 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. Establish the intended mood and material readability before adding lights. For a PBR subject, test an environment plus a controlled key light. Metallic surfaces need reflected surroundings; increasing ambient intensity is not a substitute for meaningful reflection. Use environment preprocessing and mapping appropriate to the renderer/version. Decide whether background and illumination should share an image. Dispose owned preprocessing resources and replaced environments without releasing shared loader cache entries. Enable shadows only on lights and objects that need them. Tighten directional/spot shadow coverage before raising map resolution. Inspect the shadow camera with helpers; adjust bias and normal bias in relation to scene scale. Excessive bias detaches contact shadows. Point-light shadows require multiple views and can be expensive. Choose baked lighting for static scenes when dynamic lights add little value. Keep shadow updates demand-driven for static arrangements where supported. Add contact-shadow approximations only when they remain believable during interaction. Verify shadow acne, detached feet, thin surfaces, moving objects at shadow-frustum edges, dark metallic surfaces, and texture seams. Compare the scene with and without shadows on a target device before accepting the cost. ## API reference Consult the [official documentation](https://threejs.org/docs/pages/Light.html) 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 →threejs-lighting by other authors comes first.