Debug System Skill

Implement structured logging, F-key overlays, and runtime variable inspection for game debugging.

3|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/Totes-MickGOATs/mcgoats-game-template --skill debug-system-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Debug System Skill
Source: https://github.com/Totes-MickGOATs/mcgoats-game-template/tree/main/.agents/skills/debug-system
Command: npx skills add https://github.com/Totes-MickGOATs/mcgoats-game-template --skill debug-system-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a robust system for debugging game applications, offering structured logging, visual overlays, and runtime inspection tools to identify and resolve issues efficiently.

Core Features & Use Cases

  • Structured Logging: Implement tagged, leveled log output with filtering capabilities to manage console noise.
  • F-Key Overlays: Toggle visual debug displays (performance metrics, physics, AI state) using function keys without interrupting gameplay.
  • Runtime Inspection: Watch specific variables, inspect object properties, and draw visual debug aids in the game world.
  • Use Case: During a complex physics simulation, use the F3 overlay to visualize collision shapes and forces, while simultaneously watching specific wheel slip values via Debug.watch() to diagnose instability.

Quick Start

Use the debug system skill to enable the physics overlay by pressing F3.

Frequently Asked Questions about Debug System Skill

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

FAQPage Schema
How do I add in-game debug overlays to my game development project?

Structured logging for game development works by implementing tagged and leveled log output with filtering capabilities. This manages console noise by allowing developers to isolate specific systems and severity levels during diagnostics.

How do I inspect runtime variables during a game simulation?

Runtime variable inspection is done using the `Debug.watch()` function to monitor specific values like wheel slip or object properties. This allows developers to diagnose instability issues while the game simulation is actively running.

Does this debugging system work in headless CI environments?

The debugging system works in headless CI environments by supporting machine-parseable log output. This ensures that structured logging and diagnostics can be automated and analyzed without requiring a visual interface or active gameplay window.

What is the best way to filter console noise when debugging a game?

The best way to filter console noise is using structured logging with tag and level filtering capabilities. By assigning specific tags and severity levels to log outputs, you can isolate relevant diagnostic messages and hide irrelevant ones.

Can I visualize collision shapes and forces during a physics simulation?

You can visualize collision shapes and forces during a physics simulation by enabling the F3 debug overlay. This function key toggles the visual display of physical properties, allowing you to diagnose instability alongside runtime variable inspection.