game-debug

Automates a structured 9-phase debugging workflow for Godot projects.

Updated Jan 1, 2026

Search Tags:#debugging #gdscript #godot #root-cause #fixes #game-dev #scene-tree

Ready to run

npx skills add https://github.com/AirMile/claude-config --skill game-debug-airmile

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: game-debug
Source: https://github.com/AirMile/claude-config/tree/main/skills/game-debug
Command: npx skills add https://github.com/AirMile/claude-config --skill game-debug-airmile

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging for Godot projects with inline investigation, root cause analysis, and 3 fix strategies. Use for runtime errors, physics bugs, signal issues, or scene tree problems.

Core Features & Use Cases

9-phase debugging: context → intake → investigate → analyze → research → fix plans → select → implement → verify.
Context-aware data gathering: reads CLAUDE.md, project.json, and backlog hints to seed investigation.
Actionable fixes: maps findings to concrete code changes and robust verification steps.

Quick Start

Start the debugging workflow by running the game-debug skill and begin at Phase 0: Context Loading.

Frequently Asked Questions about game-debug

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

FAQPage Schema

How do I debug runtime errors and signal issues in Godot?▼

Debugging Godot runtime errors and signal issues requires a structured workflow that gathers context, investigates the scene tree, and maps root causes to concrete code fixes. This skill automates that multi-pass process to resolve physics bugs and scene-tree problems.

What is the best way to find the root cause of physics bugs in GDScript?▼

Finding the root cause of GDScript physics bugs involves a multi-pass investigation across nine distinct phases, from initial context loading to final verification. This approach targets specific scene-tree data to isolate and fix the underlying problem rather than just patching symptoms.

Can I use this to fix scene tree problems in my Godot project?▼

Yes, you can fix scene tree problems in your Godot project by running an automated debugging workflow. It reads your project configuration and backlog hints to perform phase-specific data gathering, ensuring the scene tree analysis is context-aware before applying fixes.

How do I plan code fixes with risk assessment for game development bugs?▼

Planning code fixes with risk assessment involves mapping investigation findings to three distinct fix strategies. This skill generates explicit fix plans and robust verification steps to ensure the changes resolve the bug without introducing new game development issues.

Does the Godot debugging workflow support context from project configuration files?▼

Yes, the Godot debugging workflow supports context by reading project configuration files like CLAUDE.md and project.json. It uses these files to seed the investigation, ensuring the data gathering and root cause analysis are tailored to your specific game architecture.