debug-issue

Diagnose Godot physics, signals, rendering, navigation, and input issues via decision trees.

32|8|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/n24q02m/better-godot-mcp --skill debug-issue-n24q02m
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-issue
Source: https://github.com/n24q02m/better-godot-mcp/tree/main/skills/debug-issue
Command: npx skills add https://github.com/n24q02m/better-godot-mcp --skill debug-issue-n24q02m

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Godot debugging guidance to quickly pinpoint why physics, signals, rendering, navigation, or input behaviors are failing in a game scene.

Core Features & Use Cases

  • Domain-specific decision trees: Routes common symptoms into Physics, Signals, Rendering, Navigation, or Input checklists so you stop guessing.
  • Actionable diagnostic commands: Recommends specific Godot/MCP actions for inspecting layers, scene nodes, properties, signal connections, and runtime behavior.
  • Ordered root-cause workflow: Starts with the most common causes (e.g., collision layer/mask mismatch) and narrows toward the most likely fix, then instructs how to report findings.

Quick Start

Ask the AI to debug your Godot issue by symptom, including the relevant scene path and what exactly is going wrong.

Frequently Asked Questions about debug-issue

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

FAQPage Schema
How do I debug Godot physics issues when objects are not colliding?

Debug Godot physics collisions by verifying collision layer and mask configurations on interacting nodes. The workflow maps the non-collision symptom to a physics decision tree to pinpoint mismatched properties.

Why are my Godot signals not firing and how can I trace the connections?

Godot signals not firing are diagnosed by validating signal connections and handler signatures. The workflow inspects scene node connections to identify mismatched arguments or missing handlers causing the signal failure.

What is the best way to troubleshoot invisible or flickering rendering in Godot?

Troubleshoot Godot rendering issues like invisible or flickering visuals by inspecting scene nodes and their properties. The decision tree workflow checks visibility flags and rendering configurations to isolate the visual anomaly.

How do I fix unresponsive input actions in a Godot scene?

Fix unresponsive Godot input actions by matching input action names against the project settings. The diagnostic workflow validates the input map and action names to correct detection failures in the scene.

Can I use a decision tree to diagnose broken pathfinding in Godot navigation?

Yes, you can diagnose broken Godot navigation pathfinding using a dedicated decision tree. It routes navigation symptoms through ordered domain checks to identify missing navigation meshes or layer configuration errors.

What information do I need to start diagnosing a Godot scene with this debugging workflow?

To start the Godot debugging workflow, provide the specific symptom keyword and the relevant scene path. This allows the diagnostic process to map the issue to the correct domain tree and inspect the appropriate nodes.