unity-profiler

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

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-profiler-du-qwq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-profiler
Source: https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications/tree/main/.agents/skills/unity-skills/skills/profiler
Command: npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-profiler-du-qwq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Diagnosing Unity runtime performance issues requires quick access to frame timing, memory usage, and rendering statistics without modifying the running project or setting up complex profiling sessions. ## Core Features & Use Cases - Performance Snapshots: Read FPS, batches, draw calls, triangles, and frame timing via profiler_get_stats and profiler_get_rendering_stats. - Memory Inspection: Query total allocated/reserved memory, mono heap, and per-asset memory for textures, meshes, materials, and audio clips. - Object Analysis: List top memory-consuming runtime objects and count loaded objects grouped by type, plus inspect loaded AssetBundles. - Use Case: When a scene feels slow, ask for a performance snapshot to instantly see FPS, draw calls, and which textures or meshes consume the most memory, all without entering Play mode recording or changing any project state. ## Quick Start Ask the assistant to take a Unity profiler snapshot showing current FPS, memory usage, and the top memory-consuming textures in the running 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 Unity runtime FPS and draw calls from an AI assistant?

Use profiler_get_stats to read FPS, triangles, batches, and memory totals, or profiler_get_rendering_stats for detailed metrics like draw calls, set-pass calls, vertices, and shadow casters. Both are read-only snapshot queries with no parameters.

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. The optional limit parameter controls how many top textures are returned, defaulting to 50.

Can this skill start or stop Unity Profiler recording?

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

Does querying Unity profiler stats modify the running project?

No. Every skill in this module is marked ReadOnly and runs in SemiAuto mode, meaning it only reads runtime statistics without mutating scenes, assets, or play mode state. No approval grants are required in any operating mode.

What is the difference between profiler_get_memory and profiler_get_runtime_memory?

profiler_get_memory returns aggregate heap figures such as 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.