unity-debug

Diagnose Unity runtime errors by analyzing console logs, scene hierarchy, and object state.

39|4|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/bigdra50/unity-cli --skill unity-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-debug
Source: https://github.com/bigdra50/unity-cli/tree/main/skills/unity-debug
Command: npx skills add https://github.com/bigdra50/unity-cli --skill unity-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unity runtime errors can stall development; this workflow helps you systematically identify root causes by analyzing console logs, scene hierarchy, and object state.

Core Features & Use Cases

  • Systematic console log analysis to identify error signatures and stack traces
  • Scene hierarchy and GameObject/component inspection to locate faulty state
  • Guided steps to reproduce, collect evidence, and generate a concise debug report
  • Applicable to common runtime issues like NullReferenceException and MissingReferenceException

Quick Start

Run the Unity Debug Workflow to systematically identify and investigate runtime errors.

Frequently Asked Questions about unity-debug

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

FAQPage Schema
How do I debug Unity runtime errors like NullReferenceException systematically?

Debug Unity runtime errors by analyzing console logs for stack traces, inspecting scene hierarchy and GameObject components for faulty state, and following a guided workflow to reproduce issues and collect evidence into a concise report.

What is the best way to diagnose MissingReferenceException in a Unity scene?

Diagnose MissingReferenceException by inspecting the scene hierarchy for broken object references, analyzing console logs for the exact error signature, and tracing component misconfigurations to locate the faulty GameObject state.

Do I need Unity console access to investigate component misconfigurations?

Yes, Unity console access is required to investigate component misconfigurations because console logs provide the error signatures and stack traces needed to locate faulty object state and reproduce the runtime failure scenario.

Can I use a guided workflow to find faulty GameObjects causing runtime errors?

Yes, a guided workflow can find faulty GameObjects causing runtime errors by systematically coordinating commands to inspect object state, collecting context across failure scenarios, and generating a debug report.

Why does my Unity game stall with runtime errors despite no syntax issues?

Unity games stall with runtime errors due to component misconfigurations or broken references in the scene hierarchy, requiring analysis of console logs and object state rather than syntax checks to identify the root cause.