unity-debug

Inspect Unity console errors, compilation state, stack traces, and system diagnostics.

2|Updated May 18, 2026
One-click install
npx skills add https://github.com/pcone-mm/NewFPG --skill unity-debug-pcone-mm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-debug
Source: https://github.com/pcone-mm/NewFPG/tree/main/.agents/skills/unity-skills/skills/debug
Command: npx skills add https://github.com/pcone-mm/NewFPG --skill unity-debug-pcone-mm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Diagnosing Unity Editor issues normally requires manually checking the console, compile state, and environment info across multiple windows. This Skill aggregates error reading, compilation checks, forced recompilation, and system diagnostics into callable operations so you can triage problems quickly. ## Core Features & Use Cases - Aggregated Health Snapshot: unity_diagnose combines console errors, compile state, recent jobs, and server stats in one call, making it the first step when triaging any problem. - Error & Log Inspection: Read console errors, filter logs by type or content, and retrieve stack traces for specific log entries. - Compilation Control: Check compilation status, force a full script recompile, and read or set scripting define symbols. - Use Case: After editing a script, ask the AI to check for compile errors; it calls debug_check_compilation and debug_get_errors, then reports the failing file and stack trace so you can fix it immediately. ## Quick Start Ask the AI to run a Unity health check with unity_diagnose and report any console errors and compilation problems.

Frequently Asked Questions about unity-debug

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

FAQPage Schema
How do I check Unity compilation errors from the console?

Use debug_check_compilation to detect whether compilation errors exist, then call debug_get_errors to list the active errors and exceptions. For a full picture in one call, unity_diagnose combines compile state with console errors.

How to force Unity to recompile all scripts programmatically?

Call debug_force_recompile to trigger a full script recompilation. Note that it always causes a Domain Reload, so the server becomes temporarily unavailable and the call requires elevated approval or bypass mode.

What is the fastest way to triage a Unity project problem?

Call unity_diagnose first. It returns an aggregated snapshot covering console errors, warnings, compile state, recent workflow tasks, recent jobs, and server stats, avoiding the need to chain four or five individual diagnostic calls.

Can I read and modify Unity scripting define symbols?

Yes. debug_get_defines returns the scripting define symbols for the current build target group, and debug_set_defines replaces them. Setting defines triggers recompilation and a Domain Reload, so the server is briefly unavailable afterward.

Why is the Unity server unavailable after forcing a recompile?

debug_force_recompile and debug_set_defines trigger a Domain Reload in the Unity Editor, which restarts the scripting environment. During the reload the server cannot respond, so these operations are restricted to bypass or allowlisted execution modes.

When should I use the console module instead of debug logs?

Use the console module's console_get_logs or console_start_capture for runtime console log capture during play mode. The debug module's log functions are intended for error and diagnostics inspection, not continuous runtime log streaming.