unity-perf

Profile Unity frame data to identify CPU/GPU bottlenecks and generate improvement recommendations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unity performance profiling and optimization workflow helps engineers identify bottlenecks such as CPU/GPU time, GC spikes, and draw calls, enabling targeted improvements and faster iteration cycles.

Core Features & Use Cases

  • Profiling workflow guidance: from entering Play Mode to collecting profiler data and analyzing results.
  • GC and memory analysis: identify allocations causing spikes and memory pressure across scenes.
  • Optimization planning: provides actionable recommendations and checklists to improve frame times.

Quick Start

Start a profiling session in Unity, collect a snapshot, and review results to begin bottleneck remediation.

Frequently Asked Questions about unity-perf

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

FAQPage Schema
How do I identify Unity performance bottlenecks using profiling data?

Unity performance bottlenecks are identified by profiling and analyzing frame data to pinpoint CPU/GPU time spikes, GC allocations, and draw calls. This workflow collects snapshots during Play Mode and generates actionable improvement recommendations to reduce frame times.

What causes GC spikes in Unity and how do I analyze them?

GC spikes in Unity are caused by memory allocations across scenes during runtime. Profiling sessions capture this memory pressure, enabling you to analyze the profiler data, identify the specific allocations causing the spikes, and optimize memory usage to stabilize frame times.

How do I start a Unity profiling session to investigate frame time issues?

To start a Unity profiling session for frame time investigation, enter Play Mode, collect a profiler snapshot of your application's runtime behavior, and review the results. This process captures CPU and GPU times to begin targeted bottleneck remediation.

Does this Unity profiling workflow support batch optimization and draw call analysis?

Yes, this Unity profiling workflow supports batching optimization by analyzing frame data to identify excessive draw calls and CPU/GPU bottlenecks. It provides optimization checklists and recommendations to improve frame times through targeted batching improvements.

What's the best way to optimize Unity frame times after collecting profiler snapshots?

The best way to optimize Unity frame times after collecting profiler snapshots is to analyze the CPU/GPU times and GC data, then apply the generated improvement recommendations. This targeted approach addresses specific bottlenecks for faster iteration cycles.

Can I use this workflow to profile memory pressure across multiple Unity scenes?

Yes, you can profile memory pressure across multiple Unity scenes. The workflow analyzes GC and memory allocations causing spikes, identifying memory pressure across scenes to help you target improvements and optimize overall application performance.