hz-perfetto-debug
Analyzes Meta VR and Horizon OS VR performance using Perfetto traces — frame timing, CPU/GPU bottlenecks, render pass analysis. Use when profiling frame drops, jank, or thermal issues on Meta VR devices. Build paths: all Meta VR app stacks; use hz-quest-verify-first if the build path is unclear.
Install
With your agent
Install OMGSkills skill "meta-quest/agentic-tools:skills/hz-perfetto-debug" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/meta-quest/agentic-tools /tmp/agentic-tools && ln -s /tmp/agentic-tools/skills/hz-perfetto-debug ~/.claude/skills/hz-perfetto-debugFrom README
Perfetto Debug Skill When to Use Use this skill when investigating VR performance issues on Meta VR devices: Frame drops, jank, or stuttering CPU or GPU bottlenecks Render pass overhead and GPU utilization Thermal throttling and clock frequency changes Frame timing variance and missed vsync deadlines Thread contention and synchronization issues High draw call counts or overdraw VR Frame Time Targets These are the hard deadlines for each refresh rate. If a frame exceeds its target, the compositor must reproject or the user sees a stale frame. | Refresh Rate | Frame Time Budget | Notes | |-------------|------------------|-------| | 120 Hz | 8.3 ms | Supported on Quest 2, Quest 3, Quest 3S | | 90 Hz | 11.1 ms | Supported on Quest 2, Quest Pro, Quest 3, Quest 3S | | 72 Hz | 13.9 ms | Default on all Quest devices | | 60 Hz | 16.7 ms | Media apps only (Quest 2); interactive apps must use 72 Hz+ | Missing a frame deadline by even 1 ms causes a stale frame (reprojection).
More from this repo
hz-android-2d-porting
Guides porting existing Android 2D apps to Meta VR and Horizon OS — input adaptation, panel layout, and design...
hz-immersive-designer
Guides design of comfortable, intuitive VR/MR experiences for Meta VR and Horizon OS — comfort guidelines, interaction...
hz-iwsdk-webxr
Builds WebXR experiences for Meta VR and Horizon OS using the Immersive Web SDK (IWSDK) — ECS architecture, Three.js...