unity-debug

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

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-debug-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-debug
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/debug
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-debug-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working in Unity, tracking down compile failures, console errors, and environment issues requires checking many separate places. This Skill aggregates error logs, compilation status, stack traces, and system information into a single diagnostic workflow so problems can be triaged quickly. ## Core Features & Use Cases - Aggregated Health Snapshot: unity_diagnose combines console errors, compile state, recent jobs, and server stats in one call, avoiding chained requests. - Error & Log Inspection: Filter console logs by type and content, retrieve active errors, and fetch stack traces for specific log entries. - Compilation Control: Check compilation status, force recompilation, and read or set scripting define symbols. - Use Case: After editing a C# script, call unity_diagnose to immediately see whether compilation succeeded and which errors appeared, then use debug_get_stack_trace to inspect the failing code path. ## Quick Start Ask the AI to run a Unity diagnostic check and report any compile errors and console warnings in the project.

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 an AI assistant?

Call debug_check_compilation to see whether any compilation errors exist, or use unity_diagnose for a combined snapshot of compile state, console errors, and server status in one response.

How to get Unity console errors and logs programmatically?

Use debug_get_errors to retrieve only active errors and exceptions, or debug_get_logs with type and content filters to narrow results. You can limit the number of returned entries with the limit parameter.

Can I force Unity to recompile scripts remotely?

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

Does forcing a Unity recompile interrupt the connection?

Yes. debug_force_recompile and debug_set_defines both trigger a Domain Reload, making the server briefly unavailable. These skills are blocked in semi-automatic modes and require Bypass or allowlist approval.

How do I read Unity scripting define symbols?

Use debug_get_defines to list the scripting define symbols for the current build target group. To modify them, call debug_set_defines with the new define string, which triggers recompilation.