unity-performance

Detect Unity runtime performance red flags in code, scenes, and profiler traces.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mandexonla/Top-Down-Template --skill unity-performance-mandexonla
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-performance
Source: https://github.com/mandexonla/Top-Down-Template/tree/main/.codex/skills/unity-skills/skills/performance
Command: npx skills add https://github.com/mandexonla/Top-Down-Template --skill unity-performance-mandexonla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifies likely Unity performance issues and anti-patterns so developers can focus limited time on fixes that materially improve frame time, memory behavior, and scalability rather than chasing speculative micro-optimizations.

Core Features & Use Cases

  • Hotpath detection guidance: Highlights common red flags such as excessive Update/LateUpdate/FixedUpdate usage, repeated Find/GetComponent/Camera.main calls, frequent Instantiate/Destroy, and reflection or editor-only code leaking into runtime.
  • Allocation and GC guidance: Calls out avoidable per-frame allocations from LINQ, string formatting, closures, and boxing, and indicates pooling opportunities.
  • Prioritized recommendations: Produces confirmed vs likely red flags, actionable changes worth doing now, changes not worth doing now, and an expected gain category (clarity / frame time / GC / scalability).
  • Use Case: Use during profiler analysis, code reviews, PR checks, or when players report slow frame rates, stutters, or memory spikes.

Quick Start

Ask the unity-performance skill to review my profiler capture and code snippets for likely performance red flags and prioritized fixes.

Frequently Asked Questions about unity-performance

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

FAQPage Schema
How do I identify Unity performance red flags causing frame drops and stutters?▼

To identify Unity performance red flags causing frame drops and stutters, analyze profiler captures and code snippets to detect excessive Update methods, frequent Instantiate/Destroy calls, and per-frame allocations. This process highlights confirmed anti-patterns causing frame drops and stutters.

What are common Unity GC allocation anti-patterns in game code?▼

Common Unity GC allocation anti-patterns include using LINQ, string formatting, closures, and boxing inside per-frame loops. These create avoidable garbage collection spikes, and detecting them helps indicate where object pooling opportunities should replace frequent allocations.

How do I prioritize Unity optimization fixes for better frame time?▼

Prioritize Unity optimization fixes by categorizing confirmed versus likely red flags and evaluating expected gains in frame time, GC, clarity, or scalability. This approach focuses limited development time on actionable changes rather than speculative micro-optimizations.

Does this approach detect repeated Find and GetComponent calls in runtime code?▼

Yes, this approach detects repeated Find, GetComponent, and Camera.main calls leaking into runtime code. Identifying these hotpath red flags during code reviews or profiler analysis helps materially improve frame time and overall game scalability.

What is the best way to review Unity profiler traces for slow frame rates?▼

The best way to review Unity profiler traces for slow frame rates is to scan for excessive Update/LateUpdate hot paths and high GC spikes. Applying this analysis isolates practical fixes expected to improve memory behavior and frame time.

When should I not use object pooling for Unity memory optimization?▼

You should reconsider object pooling when the profiler trace shows minimal Instantiate/Destroy overhead or low per-frame allocations. If these specific red flags are absent, pooling becomes a speculative micro-optimization not worth doing now.