godot-builder

Orchestrates Godot 4 game builds by routing requests to specialized GDScript skills and MCP editor tools.

Updated Aug 11, 2026
One-click install
npx skills add https://github.com/zerox-core/AI_Game --skill godot-builder-zerox-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: godot-builder
Source: https://github.com/zerox-core/AI_Game/tree/main/.claude/skills/godot-builder
Command: npx skills add https://github.com/zerox-core/AI_Game --skill godot-builder-zerox-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building a game in Godot 4 requires coordinating project setup, GDScript code, scenes, assets, physics, UI, and iterative error fixing inside a running editor. This Skill acts as the master router that decomposes a game request, enforces Godot-only constraints, and dispatches work to the right specialized skills and MCP editor tools. ## Core Features & Use Cases - Scope Detection & Routing: Distinguishes simple builds from full games, routes full builds to a director workflow with PRD and phased quality gates, and distills complex design documents into scoped session plans. - MCP Editor Integration: Uses tools like godot_get_project_state, godot_run_scene, godot_get_errors, and godot_generate_asset_pack to write files, run scenes, and fix errors directly in the open Godot editor. - Enforced Conventions: Standardizes collision layers, project structure, GDScript 4.3+ syntax, asset-first visual rules, and dock-panel progress logging. - Use Case: A user says "create a complete top-down shooter with enemies, HUD, and polish" — the Skill detects a full-game request, loads the director, coordinates sub-agents for player/enemy/UI scripts, generates sprite assets, and iterates run-and-fix cycles until the game runs with zero errors. ## Quick Start Ask the assistant to create a Godot 4 game, for example: "Build a simple platformer in my current Godot project."

Frequently Asked Questions about godot-builder

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

FAQPage Schema
How do I create a Godot 4 game from a text prompt?

Describe the game you want in the current Godot project directory. Short prompts trigger a scope question (simple vs. full game); detailed prompts route to a director workflow that writes GDScript files, scenes, and assets, then runs and fixes the game in the editor.

How do I build a game from existing design documents?

Point the Skill at your docs folder. Complex document sets are first distilled into a scoped session plan for approval, then the director builds only the approved session scope in GDScript, ignoring any non-Godot technology references in the docs.

Does this Skill support web or mobile game builds?

Yes, but only as Godot 4 projects. Web and mobile requests only change project.godot viewport and stretch settings; all game code remains GDScript. It never creates HTML, JavaScript, React, Unity, or other non-Godot projects.

Why is the Godot editor plugin not responding?

The pre-flight check fails when godot_get_project_state returns editor_connected as false. Ensure the Godot editor is open with your project, the AI Game Builder plugin is enabled in Project Settings, and the dock panel is visible, then retry.

What happens when the build produces script errors?

The MCP tools enforce error gates: filesystem reloads report error counts and phase completion is rejected while errors exist. The Skill reads each error, fixes the file, reloads, and repeats until zero errors remain, rewriting a script from scratch after three failed attempts.