skills.rest
gmackie
gmackieCOMMUNITY
Explore all skills by this author →
Website𝕏@grahammackieGitHub

unity-debug-workflow

Diagnose Unity projects using console logs, breakpoints, profiler data, and unity-mcp integration.

Updated Mar 27, 2026
Search Tags:#game development#unity#debugging#console logs#breakpoints#profiler#unity-mcp
One-click install
npx skills add https://github.com/gmackie/agent-skills --skill unity-debug-workflow-gmackie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-debug-workflow
Source: https://github.com/gmackie/agent-skills/tree/main/skills/unity-debug-workflow
Command: npx skills add https://github.com/gmackie/agent-skills --skill unity-debug-workflow-gmackie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Troubleshooting Unity games often requires manually digging through console logs, setting breakpoints, and interpreting profiler data, which slows down identifying runtime errors and performance bottlenecks. ## Core Features & Use Cases - AI-Assisted Console Analysis: Connect unity-mcp so an AI client can read Unity console logs, inspect scene hierarchies, and suggest fixes for runtime errors. - Breakpoint and Component Debugging: Set up Visual Studio or Rider debugging with assertions and breakpoints to inspect component state, input values, and movement calculations. - Performance Monitoring: Generate debug scripts that log draw calls, triangles, and batches, and use the Frame Debugger and Deep Profiling to analyze the rendering pipeline. - Use Case: When a player movement bug appears, ask the AI to check the Unity console for errors, generate a monitoring script via unity-mcp, and analyze profiler data to locate the bottleneck. ## Quick Start Ask the AI to check the Unity console for errors and create a debug script for the player movement issue using unity-mcp.

Frequently Asked Questions about unity-debug-workflow

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

FAQPage Schema
How do I debug Unity games with AI assistance?▼

Install the MCP for Unity package from the CoplayDev/unity-mcp git URL, start the local HTTP server from Window > MCP for Unity, and connect your AI client to http://localhost:8080/mcp. The AI can then read console logs and generate debug scripts.

How to set up unity-mcp in a Unity project?▼

Install Python and uv, then in Unity open Package Manager and add the package from git URL https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity. Open Window > MCP for Unity and click Start Local HTTP Server.

Why is unity-mcp not connecting to my AI client?▼

Ensure the HTTP server is running in the MCP for Unity window and that your AI client configuration points to http://localhost:8080/mcp. Verify port 8080 is not blocked or used by another process.

Why are breakpoints not hitting in Unity?▼

Breakpoints fail when script debugging is not enabled in Unity preferences or the IDE is not attached to the Unity Editor. Check Unity preferences for debugger settings and attach Visual Studio or Rider before entering Play mode.

How do I profile performance issues in Unity?▼

Enable Deep Profiling for detailed call stacks and use the Frame Debugger to analyze the rendering pipeline. You can also log metrics like draw calls, triangles, and batches from a monitoring script using UnityStats.

Related Skills

Explore More Software Engineering Skills→
RakameNouyaRakameNouya

unity-initial-setup

Automate Unity project setup with unity-mcp-cli installation and MCP integration.

Community
Intermediate
dmooneydmooney

parish-engine

Verify Rundale gameplay changes live by running Parish engine scripts and inspecting JSON outputs.

Community
Advanced
pikachu0310pikachu0310

unity-profiler

Capture read-only Unity runtime performance and memory snapshots.

Community
Intermediate
FermislothFermisloth
1

screenshot-game-view

Captures a screenshot from the Unity Editor Game View as an image.

Community
Basic