Skip to main content
skill CX Codex

godot-3d-lighting — Claude Code skill: 3D lighting in Godot

A skill that gives AI agents working patterns for Godot 3D lighting: shadow cascades, light attenuation, VoxelGI, SDFGI and lightmap baking.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-3d-lighting -a claude-code
Open on GitHub

What godot-3d-lighting does

The skill covers DirectionalLight3D, OmniLight3D and SpotLight3D: shadow modes, attenuation curves, spot angles. It also walks through the global illumination options — VoxelGI, SDFGI, LightmapGI and ReflectionProbe — and says which one fits which scene.

Inside are GDScript helpers. shadow_cascade_tuner.gd adjusts shadow split distances from sun angle, lightmap_bake_helper.gd sets up Shadowmasking for hybrid static and dynamic scenes, fake_gi_bounce.gd fakes bounced light on mobile renderers, light_lod_optimizer.gd culls shadows by distance. There are managers for fog, reflection probes and day-night cycles too. The skill asks the agent to read the matching script before implementing a pattern.

The renderer is the hard limit. Real-time SDFGI is Forward+ only, so on Mobile and Compatibility you fall back to fake bounce lights. VoxelGI leaks light through thin walls, and baked lightmaps do not follow moving geometry. If your scene is fully dynamic, baking is the wrong tool — pick SDFGI or VoxelGI from the start.

What it helps with

  • set up DirectionalLight3D shadow cascades for a large outdoor scene
  • stop VoxelGI light leaking through thin walls
  • choose between VoxelGI, SDFGI and LightmapGI for a scene
  • cut the number of shadow-casting lights without wrecking the look
  • bake a lightmap with denoising and Shadowmasking

Example prompts for the agent

  • help me set up a DirectionalLight3D with four shadow cascades for an open field
  • why does VoxelGI leak light through walls and how do I fix it
  • build a fake bounce light setup for the mobile renderer with fake_gi_bounce.gd

How to install godot-3d-lighting

1Skills CLI (Vercel)

npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-3d-lighting -a claude-code

2Manually: put the files in place

~/.claude/skills/godot-3d-lighting/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/godot-3d-lighting/

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

Questions about godot-3d-lighting

How do I install godot-3d-lighting in Claude?

Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-3d-lighting -a claude-code. The skill lands in ~/.claude/skills/godot-3d-lighting/SKILL.md.

What does godot-3d-lighting do?

It hands the agent Godot 3D lighting patterns: shadow cascades, OmniLight3D attenuation, SpotLight3D projectors, global illumination and lightmap baking. Each pattern comes with a GDScript helper.

Why doesn't SDFGI work on mobile?

Real-time SDFGI is a Forward+ feature. For Mobile and Compatibility the skill points to fake_gi_bounce.gd, which uses non-shadowed fill lights instead.

Similar skills

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

From the same set51

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor