skills.rest
zerox-core
zerox-coreCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

godot-ops

Runs and debugs Godot game projects through MCP tools in a build-test-fix loop.

Updated Aug 11, 2026
Search Tags:#game development#debugging#mcp#gdscript#godot#build test fix#scene runner
One-click install
npx skills add https://github.com/zerox-core/AI_Game --skill godot-ops-zerox-core
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: godot-ops
Source: https://github.com/zerox-core/AI_Game/tree/main/.claude/skills/godot-ops
Command: npx skills add https://github.com/zerox-core/AI_Game --skill godot-ops-zerox-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Iterating on a Godot game requires repeatedly reloading the filesystem, running scenes, reading errors, and fixing scripts. This Skill standardizes that loop through MCP tools so every change is immediately tested and errors are fixed surgically instead of rewriting whole files. ## Core Features & Use Cases - Build-Run-Fix Loop: Reload the filesystem, run a scene, read detailed errors with file and line numbers, fix, and repeat until zero errors remain. - Dock Progress Logging: Mandatory godot_log calls before and after every action so the Godot editor dock panel always shows live progress. - Error Resolution Patterns: A reference table of common GDScript errors (missing identifiers, type mismatches, cyclic references, collision layer issues) with concrete fixes, plus cascading-error diagnosis for broken autoloads. - Use Case: After generating player movement scripts, run the scene, discover an "Identifier not found" error caused by a missing autoload, register it in project.godot, reload, and verify a clean run. ## Quick Start Ask the AI to run the Godot project, check for errors with the MCP tools, and fix any issues it finds until the game runs cleanly.

Frequently Asked Questions about godot-ops

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

FAQPage Schema
How do I run and debug a Godot scene with MCP tools?▼

Call godot_reload_filesystem after writing files, then godot_run_scene to launch the game, then godot_get_errors to retrieve detailed errors with file paths and line numbers. Fix each error, reload, and repeat until zero errors remain.

How to fix cascading errors across multiple GDScript files?▼

Cascading errors usually come from a broken autoload or base class that many scripts reference. Find and fix only the root script, then reload the filesystem and recheck errors; most downstream errors disappear automatically.

Why does godot_run_scene fail when the editor is not connected?▼

Tools like godot_run_scene, godot_stop_scene, godot_get_errors, and godot_reload_filesystem require the Godot editor running with the plugin enabled. File operations, godot_scan_project_files, and godot_parse_scene still work without the editor.

Can I use curl instead of MCP tools to control Godot?▼

No. Calling raw HTTP endpoints bypasses the MCP layer and indicates the plugin is not loaded. Always use the MCP tools; if they are unavailable, restart the client with the plugin directory configured.

Why is my Area2D collision not detecting bodies in Godot?▼

Collision failures usually come from layer and mask mismatches. Set layers explicitly with set_collision_layer_value and set_collision_mask_value, and note that body_entered only fires for physics bodies while area_entered fires for other Area2D nodes.

Related Skills

Explore More Software Engineering Skills→
AsreonnAsreonn
3

godot-extract-to-scenes

Convert code-created Godot nodes into reusable .tscn scene files.

Community
Intermediate
arthur0narthur0n

godot-export-builds

Export Godot projects to desktop and web builds headlessly and upload them to itch.io with butler.

Community
Intermediate
catlog22catlog22
2.1k

spec-generator

Generates software specifications through an 8-phase chain workflow with quality gates and auto-fix loops.

Community
Advanced
HKUDSHKUDS
48.8k

cli-anything-godot

Manage Godot projects, scenes, GDScript execution, and exports from the command line.

Official
Intermediate