This skill helps an agent assemble a 3D scene in Godot 4.7 that shows what it should in the running game. It covers the renderer choice, one current Camera3D per viewport, lights and a WorldEnvironment placed in the scene itself, Environment settings, StandardMaterial3D and GridMap blockouts.
A bundled headless check loads a scene and fails when there is no current camera, nothing lights the meshes, a sky background has no sky, or a mesh is hidden by the camera culling mask. The gotchas section explains black meshes, grey screens, wrong cameras and look_at() errors.
What You Get
- A workflow from renderer check through camera, lighting, Environment and materials to GridMap blockouts
- GDScript patterns for a sun and sky environment, a material from code and filling a GridMap
- A headless scene check that exits non-zero on a missing camera, unlit meshes or hidden meshes
- A command for rendering one software frame with Movie Maker so the agent can inspect a screenshot
Common Use Cases
- Fixing a 3D scene that renders black or washed out in the running game
- Tracking down a mesh that is invisible because of culling, distance or flipped normals
- Blocking out a level quickly with a GridMap and MeshLibrary
- Correcting a child node that rotates on the wrong axis because of local versus global transforms
What Makes It Unique
The skill separates what the editor preview shows from what the running game shows, which is the usual cause of dark scenes. It pairs that with a no-GPU headless check and a software Movie Maker render, so the agent can test a scene and look at a frame without a display. It hands spatial shaders, physics and camera feel to named sibling skills.
Under The Hood
The agent loads the SKILL.md and, when needed, a reference covering transforms, light types, Environment options and GI. It runs commands in your project: the Godot binary headless with the bundled GDScript check, an optional Python project checker from the godot-nodes-scenes skill, and, for a screenshot, xvfb-run with Godot’s movie writer, which writes image files into a shots folder. It makes no network calls. The shipped GDScript check is a file type the scanner cannot read, so what it does was not analysed and is worth a look before you run it.