Godogen: Claude Code Skills for Complete Godot Game Generation

Godogen is a pipeline that takes a text prompt and generates complete, playable Godot 4 projects. It uses Claude Code skills to design architecture, generate 2D/3D assets, write GDScript, and test visually.

Engineering Solutions

The developer solved three specific bottlenecks:

• Training Data Scarcity: LLMs have minimal GDScript training. Godogen includes a custom reference system with a hand-written language spec, full API docs converted from Godot's XML source, and a quirks database for undocumented engine behaviors. The agent lazy-loads only needed APIs at runtime to avoid context window overflow from Godot's ~850 classes.
• Build-Time vs Runtime State: Scenes are generated by headless scripts that build node graphs in memory and serialize to .tscn files, avoiding fragility of hand-editing Godot's serialization format. The model is taught which APIs are available at each phase and that every node needs its owner set correctly.
• Evaluation Loop: A separate Gemini Flash agent acts as visual QA, analyzing rendered screenshots from the running engine to catch visual bugs like z-fighting, floating objects, physics explosions, and grid-like placements that should be organic.

Architecture and Setup

The system runs as two Claude Code skills: an orchestrator that plans the pipeline, and a task executor that implements each piece in a context: fork window to prevent mistakes and state accumulation.

Prerequisites:

• Godot 4 (headless or editor) on PATH
• Claude Code installed
• API keys as environment variables: GOOGLE_API_KEY for Gemini (image generation and visual QA), TRIPO3D_API_KEY for Tripo3D (image-to-3D model conversion, only for 3D games)
• Python 3 with pip

Getting Started:

Run ./publish.sh ~/my-game to create a new project folder with all skills installed. This creates the target directory with .claude/skills/ and a CLAUDE.md, then initializes a git repo. Open Claude Code in that folder and describe what game to make — the /godogen skill handles everything.

Performance Notes:

• A single generation run can take several hours
• Running on a cloud VM with a T4 or L4 GPU works well for Godot's screenshot capture
• Claude Code with Opus 4.6 delivers the best outcome; Sonnet 4.6 works but requires more user guidance
• OpenCode is a viable alternative and porting the skills is straightforward

Asset Generation: Gemini creates 2D art and textures; Tripo3D converts selected images to 3D models. The system is budget-aware, maximizing visual impact per cent spent.

Tested Environment: Ubuntu and Debian. macOS is untested — screenshot capture depends on X11/xvfb/Vulkan and needs a native capture path.