hz-perfetto-debug

Analyze Meta Quest and Horizon OS VR performance from Perfetto traces.

176|17|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/meta-quest/agentic-tools --skill hz-perfetto-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hz-perfetto-debug
Source: https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-perfetto-debug
Command: npx skills add https://github.com/meta-quest/agentic-tools --skill hz-perfetto-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires metavr, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers analyze and optimize the performance of VR applications on Meta Quest and Horizon OS devices, identifying bottlenecks such as frame drops, jank, and thermal issues.

Core Features & Use Cases

  • Performance Analysis: Analyze frame timing, CPU/GPU bottlenecks, and render pass analysis to pinpoint performance issues.
  • Use Case: If you are experiencing frame drops or jank in your VR application, this Skill can help you identify the root cause, whether it's a CPU, GPU, or render pass issue.

Quick Start

Use the hz-perfetto-debug skill to capture a performance trace of your VR application. Then, load the trace and analyze it using metavr commands.

Frequently Asked Questions about hz-perfetto-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze VR performance issues using Perfetto traces on Meta Quest?

You can analyze VR performance using Perfetto traces to identify frame timing issues, CPU/GPU bottlenecks, and render pass inefficiencies on Meta Quest and Horizon OS. This Skill requires the metavr dependency and access to Meta Quest devices for trace capture.

What is the best way to diagnose frame drops and jank in Horizon OS VR applications?

Diagnosing frame drops and jank in Horizon OS VR applications involves analyzing Perfetto traces to pinpoint root causes, whether they stem from CPU, GPU, or render pass issues. This Skill applies that analysis to help developers optimize performance and fix visual stuttering.

Can I use the hz-perfetto-debug Skill to identify CPU and GPU bottlenecks in VR applications?

Yes, the hz-perfetto-debug Skill analyzes VR applications to identify both CPU and GPU bottlenecks. It examines Perfetto traces to pinpoint render pass inefficiencies and frame timing issues that cause performance degradation on Meta Quest and Horizon OS devices.

Do I need the metavr dependency to capture and analyze Meta Quest performance traces?

Yes, you need the metavr dependency to capture and analyze Meta Quest performance traces. This Skill requires metavr to load Perfetto traces and execute the analysis commands needed to detect frame timing issues and CPU/GPU bottlenecks in VR applications.

When should I run a Perfetto trace analysis on my Meta Quest VR application?

You should run a Perfetto trace analysis on your Meta Quest VR application when experiencing frame drops, jank, or thermal issues. This Skill uses the trace data to identify CPU, GPU, or render pass inefficiencies that require optimization to restore smooth VR performance.

What are the limitations of analyzing VR performance with Perfetto traces on Horizon OS?

Analyzing VR performance with Perfetto traces on Horizon OS is limited to identifying frame timing issues, CPU/GPU bottlenecks, and render pass inefficiencies. It requires access to Meta Quest devices for trace capture and the metavr dependency to load and execute the analysis commands.