unity-profiler

Capture read-only Unity runtime performance and memory snapshots.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-profiler-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-profiler
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/profiler
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-profiler-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unity developers need quick visibility into runtime performance and memory usage without opening the full Profiler window or writing custom instrumentation. This Skill exposes read-only snapshot queries for FPS, rendering stats, and per-asset memory so an AI agent can inspect a running Unity project on demand. ## Core Features & Use Cases - Performance Statistics: Retrieve FPS, triangles, batches, draw calls, and frame timing via profiler_get_stats and profiler_get_rendering_stats. - Memory Inspection: Query total allocated, reserved, and mono heap memory, plus top-N breakdowns for textures, meshes, materials, audio clips, and runtime objects. - Asset Auditing: List loaded AssetBundles and count loaded objects grouped by type to spot leaks or bloat. - Use Case: While playtesting a scene, ask the agent to check which textures consume the most memory; it calls profiler_get_texture_memory and returns the top offenders with sizes and dimensions. ## Quick Start Ask the agent to capture a Unity profiler snapshot showing current FPS, rendering statistics, and the top 20 textures by memory usage.

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 agent?

Call profiler_get_stats to retrieve FPS, triangles, batches, and memory totals, or profiler_get_rendering_stats for frame time, draw calls, set-pass calls, and shadow caster counts. Both take no parameters and return instant snapshots.

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

Use profiler_get_texture_memory with an optional limit parameter (default 50) to list loaded textures ranked by size, including name, type, sizeKB, width, and height. Similar queries exist for meshes, materials, and audio clips.

Can this skill start or stop Unity Profiler recording?

No. All profiler skills are read-only snapshots marked ReadOnly and SemiAuto; functions like profiler_start, profiler_stop, and profiler_record do not exist. For continuous recording, use the Unity Profiler window directly.

Does the profiler skill require special permissions or approval mode?

No grants are needed. Every skill in this module is ReadOnly with SkillMode.SemiAuto, so it executes directly under Approval, Auto, or Bypass modes, and contains no Delete, PlayMode, Reload, or high-risk operations.

What is the difference between profiler_get_memory and debug_get_memory_info?

profiler_get_memory returns heap-level totals such as allocated, reserved, and mono heap sizes, while debug_get_memory_info lives in the debug module for general memory info. For scene performance hints, use the perception module instead.