unity-profiler
Capture read-only Unity runtime performance snapshots
How do I install this agent skill?
npx skills add https://github.com/besty0728/unity-skills --skill unity-profilerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides read-only performance and memory monitoring for Unity runtime environments and contains no security risks.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
Unity Profiler Skills
Instant, read-only snapshots of runtime performance and memory. Parameters come from the schema (GET /skills/schema?category=Profiler&wire=v2); execution and dryRun rules: root SKILL.md.
When to use
- Checking frame rate, draw calls or batches at this moment
- Reading memory use by category: heap, textures, meshes, materials, audio, objects
- Finding the largest runtime memory consumers
Rules
- Every skill is
SemiAutoand read-only: it runs in every mode without a grant. - Snapshots only. For continuous recording use the Unity Profiler window.
Routing
- Scene-level performance hints →
scene_performance_hints(perceptionmodule). - Asset or scene optimisation →
optimizationmodule. - Memory overview from the debug side →
debug_get_memory_info(debugmodule).
Skills
profiler_get_stats
FPS, frame time, rendering counters and memory in one call. Parameters: None.
Returns: { success, fps, frameTime, renderTime, triangles, vertices, batches, setPassCalls, drawCalls, dynamicBatchedDrawCalls, staticBatchedDrawCalls, instancedBatchedDrawCalls, visibleSkinnedMeshes, visibleAnimators, memory: { totalAllocatedMB, totalReservedMB, unusedReservedMB, monoHeapMB, monoUsedMB } }
profiler_get_memory
Memory overview: total allocated, reserved, and the Mono heap. Parameters: None.
Returns: { success, totalAllocatedMB, totalReservedMB, unusedReservedMB, monoHeapMB, monoUsedMB }
profiler_get_runtime_memory
Top N objects by runtime memory use in the scene.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| limit | int | No | 20 | Maximum number of objects to return |
Returns: { success, totalTrackedMB, showing, objects: [{ name, type, sizeKB }] }
profiler_get_texture_memory
Memory use of all loaded textures.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| limit | int | No | 50 | Maximum number of textures to return |
Returns: { success, totalCount, totalMB, topTextures: [{ name, type, sizeKB, width, height }] }
profiler_get_mesh_memory
Memory use of all loaded meshes.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| limit | int | No | 50 | Maximum number of meshes to return |
Returns: { success, totalCount, totalMB, topMeshes: [{ name, sizeKB, vertices, triangles }] }
profiler_get_material_memory
Memory use of all loaded materials.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| limit | int | No | 50 | Maximum number of materials to return |
Returns: { success, totalCount, totalMB, topMaterials: [{ name, shader, sizeKB }] }
profiler_get_audio_memory
Memory use of all loaded AudioClips.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| limit | int | No | 50 | Maximum number of clips to return |
Returns: { success, totalCount, totalMB, topClips: [{ name, sizeKB, length, channels, frequency }] }
profiler_get_object_count
Count all loaded objects, grouped by type.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| topN | int | No | 20 | Number of top types to return |
Returns: { success, totalObjects, topTypes: [{ type, count }] }
profiler_get_rendering_stats
Rendering counters: batches, triangles, vertices, draw calls and shadow casters. Parameters: None.
Returns: { success, frameTime, renderTime, triangles, vertices, batches, setPassCalls, drawCalls, dynamicBatchedDrawCalls, staticBatchedDrawCalls, instancedBatchedDrawCalls, shadowCasters }
profiler_get_asset_bundle_stats
Loaded AssetBundles. Parameters: None.
Returns: { success, count, bundles: [{ name, isStreamedSceneAssetBundle }] }
DO NOT (common hallucinations):
profiler_start,profiler_stopandprofiler_recorddo not exist: these skills are snapshots, not recording controls.profiler_analyzeandprofiler_get_fpsdo not exist: useprofiler_get_statsfor FPS, batches and draw calls, orprofiler_get_memoryfor heap sizes.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-profiler">View unity-profiler on skillZs</a>