unity-debug

Inspect Unity compile errors, console logs, and editor diagnostics.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-debug-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-debug
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/debug
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-debug-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Diagnosing Unity project issues normally requires manually checking the console, compile state, and editor health across multiple windows. This Skill aggregates error checking, compilation status, and system diagnostics into direct tool calls 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 queries. - Error and Log Inspection: Retrieve console logs filtered by type or content, active errors, and stack traces for specific log entries. - Compilation and Environment Control: Check compilation status, force recompilation, read or set scripting define symbols, and inspect assemblies, memory, and system info. - Use Case: After editing a C# script, call unity_diagnose to confirm whether the project compiles cleanly and see any new console errors in a single response. ## Quick Start Ask the AI to run unity_diagnose and report whether the Unity project has any compile errors or console warnings.

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

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

How to get Unity console logs filtered by error type?

Use debug_get_logs with the type parameter set to Error, Warning, or Log, plus an optional content filter and entry limit. For only active errors and exceptions, call debug_get_errors instead.

Can I force Unity to recompile scripts programmatically?

Yes, debug_force_recompile forces Unity to recompile all scripts. It triggers a Domain Reload, so the server becomes temporarily unavailable and the call requires Bypass mode or an allowlist grant.

Why is debug_set_defines blocked in Approval mode?

debug_set_defines modifies PlayerSettings scripting define symbols, which triggers recompilation and a Domain Reload. Skills that trigger reloads are automatically blocked in SemiAuto modes and only run under Bypass or allowlist approval.

What is the difference between debug_get_logs and console module logs?

debug_get_logs reads the current editor console entries filtered by type and content. For runtime console capture during play mode, the console module's console_get_logs and console_start_capture are the correct tools.