unity-profiler

Capture read-only Unity runtime performance and memory snapshots.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-profiler-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-profiler
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/profiler
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-profiler-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Diagnosing Unity runtime performance issues requires quick access to FPS, memory, and rendering statistics without setting up full profiler recordings. This Skill provides instant read-only snapshots of runtime metrics so you can identify bottlenecks during development. ## Core Features & Use Cases - Performance Statistics: Retrieve FPS, triangle counts, batches, draw calls, and frame timing in a single call. - Memory Inspection: Query total allocated/reserved memory, mono heap usage, and per-asset breakdowns for textures, meshes, materials, and audio clips. - Object Analysis: List top memory-consuming scene objects and count loaded objects grouped by type. - Use Case: When playtesting reveals frame drops, call profiler_get_stats to check FPS and batch counts, then use profiler_get_texture_memory to find oversized textures consuming memory. ## Quick Start Ask the AI to get the current Unity performance statistics and memory usage to check for frame rate or memory issues.

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 FPS and performance stats at runtime?

Use profiler_get_stats to retrieve FPS, triangle counts, batches, and memory totals in one call. 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 size, including name, type, dimensions, and size in KB. Similar queries exist for meshes, materials, and audio clips with configurable result limits.

Can this skill start or stop Unity Profiler recording?

No, these skills only take instantaneous read-only snapshots and cannot control recording. For continuous sampling or recording, use the Unity Profiler window directly.

Does the profiler skill work in SemiAuto mode without approval?

Yes, all skills in this module are marked ReadOnly with SkillMode.SemiAuto, so they execute directly without grant approval in Approval, Auto, or Bypass modes. No delete, play mode, or high-risk operations are included.

What is the difference between profiler_get_memory and profiler_get_runtime_memory?

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