dev-unity-profiler-mind

Diagnose Unity framerate drops, GC allocation spikes, memory leaks, and GPU overdraw using profiler workflows.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/Unity-UPM-Packages/Antigravity-skills --skill dev-unity-profiler-mind-unity-upm-packages
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-unity-profiler-mind
Source: https://github.com/Unity-UPM-Packages/Antigravity-skills/tree/main/.agents/skills/dev-unity-profiler-mind
Command: npx skills add https://github.com/Unity-UPM-Packages/Antigravity-skills --skill dev-unity-profiler-mind-unity-upm-packages

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unity games often suffer from hitches, low FPS, memory growth, and rendering bottlenecks that are hard to trace without a structured profiling methodology. This Skill provides a systematic investigation protocol for identifying and fixing performance issues across CPU, memory, and GPU domains. ## Core Features & Use Cases - Symptom Classification: Maps observable symptoms (hitches, low FPS, memory growth, UI lag) to the correct profiler tool and likely root cause. - CPU & Memory Analysis: Identifies hot-path anti-patterns like FindObjectOfType in Update, GC allocations, event subscription leaks, and LOH fragmentation, with concrete fixes. - GPU Overdraw & Migration Guidance: Covers Frame Debugger overdraw analysis and migrating per-frame loops to the Burst-compiled C# Job System. - Use Case: When a Unity scene stutters every few seconds, use this Skill to classify it as a GC spike, locate the allocating method in the CPU Profiler, and apply pooling or caching fixes. ## Quick Start Ask the AI to investigate why your Unity game hitches during gameplay and identify the GC allocations causing it.

Frequently Asked Questions about dev-unity-profiler-mind

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

FAQPage Schema
How do I find GC allocation spikes in Unity?▼

Use the Unity CPU Profiler to inspect method self-time rankings and look for GC.Collect in the timeline, which indicates allocations on hot paths. Eliminate per-frame new allocations by caching references, pooling objects, and pre-sizing collections.

How to detect memory leaks in Unity with Memory Profiler?▼

Take a baseline snapshot at a clean state, perform the suspect action repeatedly, then take a second snapshot and compare them filtering by new objects. Object types that grow, such as Texture2D or event handlers, indicate leaks from unreleased Addressables or missing unsubscriptions.

Why does my Unity game hitch every few seconds?▼

Periodic hitches typically indicate GC allocation spikes on hot paths like Update or FixedUpdate loops. Common causes include string concatenation, boxing, FindObjectOfType calls, and unbounded collections that trigger garbage collection.

When should I use the C# Job System in Unity?▼

Use the C# Job System with Burst compilation for CPU-intensive per-frame loops such as pathfinding, NPC updates, or physics sampling that block the main thread. Jobs run in parallel on worker threads using NativeArray data without managed object access.

How do I reduce GPU overdraw in Unity?▼

Enable Overdraw mode in the Frame Debugger to visualize transparent rendering layers, where bright spots indicate fill-rate hot spots. Fix overdraw by using opaque materials, merging UI layers into sprite atlases, and disabling bloom or distortion effects on low-end devices.