godot-director

Orchestrates phased full-game builds in Godot 4 using GDScript and MCP editor tools.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building a complete game from a prompt or design documents requires planning, incremental implementation, and continuous testing; this Skill provides a structured director workflow that turns prompts or GDD folders into a playable Godot 4 game without producing broken prototypes. ## Core Features & Use Cases - PRD Generation: Converts a user prompt or a folder of design documents into a structured PRD covering mechanics, enemies, UI, visual style, and a full file manifest. - Phased Build Pipeline: Executes six gated phases (Foundation, Player Abilities, Enemies, UI & Flow, Polish, Verification) with mandatory error checks after every 1-2 scripts via Godot MCP tools. - Multi-Session Builds: Supports SESSION_PLAN.md-based resumable builds with build-state checkpoints so large games can be completed across multiple sessions. - Use Case: A user drops a folder of game design docs and says "build this game"; the Skill reads only that folder, generates a PRD for approval, then incrementally writes GDScript scenes and scripts into the existing Godot project, testing each phase before advancing. ## Quick Start Ask the AI to build a complete Godot 4 game from your prompt or from a specified folder of design documents, then approve the generated PRD to start the phased build.

Frequently Asked Questions about godot-director

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

FAQPage Schema
How do I build a complete game in Godot 4 from design documents?

Point the Skill at your docs folder; it reads only that folder, extracts the game design while ignoring non-Godot technology references, and generates a PRD in docs/PRD.md. After your approval, it builds the game in six tested phases using GDScript.

Can I use this to create a web or mobile game?

Yes, but the game is always built as a Godot 4 project in GDScript. Web or mobile targets only change project.godot viewport and stretch settings; the Skill never creates HTML, JavaScript, React, or other non-Godot projects.

What happens if a Godot game build is interrupted mid-session?

The Skill saves build state checkpoints after each phase. On the next session it detects the interrupted build, shows the last completed phase, and lets you resume from the checkpoint or start fresh.

Why does the build stop after writing only one or two scripts?

The incremental build protocol requires running godot_reload_filesystem after every 1-2 scripts to catch compilation errors early. Writing many scripts untested causes cascading errors that are far harder to diagnose and fix.

Does the Godot editor need to be open for the build to work?

Yes. The pre-flight check calls godot_get_project_state and stops if the editor is not connected. You must open the Godot editor with the AI Game Builder plugin enabled before any files are written.