unity-profiler

Profile Unity projects for FPS, rendering, and memory metrics.

8|1|Updated Oct 7, 2025
One-click install
npx skills add https://github.com/Zzulin/unity-project01 --skill unity-profiler-zzulin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-profiler
Source: https://github.com/Zzulin/unity-project01/tree/main/URP1/Plugins/Unity-Skills-main/SkillsForUnity/unity-skills~/skills/profiler
Command: npx skills add https://github.com/Zzulin/unity-project01 --skill unity-profiler-zzulin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unity projects can suffer from frame rate drops, unexpected memory growth, and rendering bottlenecks that are difficult to diagnose by eye. This Skill provides fast, read-only snapshots of runtime and editor performance metrics so developers can quickly identify hotspots without recording sessions or changing project state.

Core Features & Use Cases

  • Performance Snapshots: Retrieve FPS, frame time, triangles, batches, draw call counts, and rendering timing to spot frame rate issues.
  • Memory Breakdown: Get total allocated, reserved, mono heap usage and listings of top memory-consuming objects, textures, meshes, materials, and audio clips.
  • Asset & Object Insights: Query loaded AssetBundles and object type counts to find asset-related overheads; use case: diagnose a scene with sudden memory spikes by listing the top N objects by runtime memory usage.

Quick Start

Request profiler_get_stats to retrieve FPS, batches, and a memory summary for the current scene.

Frequently Asked Questions about unity-profiler

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

FAQPage Schema
How do I check FPS and rendering statistics in a Unity scene?

You can retrieve read-only performance snapshots that provide FPS, frame time, triangles, batches, and draw call counts to quickly spot rendering bottlenecks and frame rate drops in your Unity scene.

Why does my Unity project have unexpected memory growth and how can I diagnose it?

Diagnose unexpected memory growth by requesting a memory breakdown that returns total allocated MB, reserved memory, mono heap usage, and listings of top memory-consuming objects to identify leaks.

Can I get a memory breakdown of top objects without recording a profiling session?

Yes, you can retrieve read-only snapshots listing top memory-consuming objects, textures, meshes, and materials without recording profiling sessions or altering your Unity project state.

How do I diagnose rendering bottlenecks and asset overhead in Unity?

Diagnose rendering bottlenecks by querying rendering timing metrics, loaded AssetBundles, and object type counts to isolate asset-related overheads and frame rate issues.

Does this Unity profiling approach work for both Editor and runtime scene analysis?

Yes, this Unity profiling approach is applicable to both Editor and runtime scene analysis, providing structured metrics like FPS, batches, and total allocated MB to diagnose bottlenecks.