unity-profiler

Capture read-only Unity runtime performance snapshots of frame timing, memory, and rendering statistics.

2|Updated May 18, 2026
One-click install
npx skills add https://github.com/pcone-mm/NewFPG --skill unity-profiler-pcone-mm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-profiler
Source: https://github.com/pcone-mm/NewFPG/tree/main/.agents/skills/unity-skills/skills/profiler
Command: npx skills add https://github.com/pcone-mm/NewFPG --skill unity-profiler-pcone-mm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a Unity game runs slowly or consumes too much memory, developers need quick visibility into runtime performance without setting up the full Profiler window or writing instrumentation code. This Skill provides instant, read-only snapshots of FPS, memory usage, rendering stats, and per-asset memory breakdowns directly from the running Unity editor. ## Core Features & Use Cases - Runtime Statistics: Query FPS, triangles, batches, draw calls, set-pass calls, and frame timing with profiler_get_stats and profiler_get_rendering_stats. - Memory Inspection: Inspect total allocated/reserved memory, mono heap, and per-category memory for textures, meshes, materials, and audio clips. - Object & Asset Auditing: List top memory-consuming scene objects, count loaded objects by type, and enumerate loaded AssetBundles. - Use Case: A user notices frame drops in their scene and asks for a performance check. The Skill returns current FPS, batch counts, and the top 20 memory-heavy textures, revealing that uncompressed 4K textures are the bottleneck. ## Quick Start Ask the AI to take a profiler snapshot of the running Unity scene and report the current FPS, memory usage, and the largest textures in memory.

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 performance stats in Unity at runtime?

Use profiler_get_stats to retrieve current FPS, triangle count, batch count, and memory totals from the running Unity editor. For deeper rendering detail, profiler_get_rendering_stats returns frame time, draw calls, set-pass calls, and shadow caster counts.

How to find which textures use the most memory in Unity?

Call profiler_get_texture_memory to list all loaded textures sorted by memory usage, including name, type, size in KB, width, and height. You can set the limit parameter to control how many top textures are returned, defaulting to 50.

Can this skill record Unity profiler sessions over time?

No, these skills only take instantaneous read-only snapshots and do not control profiler recording. For continuous sampling or recording, use the Unity Profiler window directly; commands like profiler_start or profiler_record do not exist.

Does querying Unity profiler stats modify the scene or require approval?

No, all profiler skills are marked ReadOnly with SemiAuto mode, so they execute without grants in any approval mode and never mutate the scene. They contain no delete, play mode, or reload operations.

What is the difference between profiler_get_memory and profiler_get_runtime_memory?

profiler_get_memory returns aggregate heap statistics like total allocated, reserved, and mono heap sizes. profiler_get_runtime_memory instead lists the top N individual scene objects ranked by their runtime memory footprint.