skills.rest
meta-quest
meta-questOFFICIAL
Explore all skills by this author →
GitHub

hz-simpleperf-debug

Profile CPU performance of Meta Quest and Horizon OS applications using simpleperf.

176|17|Updated Feb 9, 2026
Search Tags:#performance optimization#meta quest#simpleperf#CPU profiling#horizon OS
One-click install
npx skills add https://github.com/meta-quest/agentic-tools --skill hz-simpleperf-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hz-simpleperf-debug
Source: https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-simpleperf-debug
Command: npx skills add https://github.com/meta-quest/agentic-tools --skill hz-simpleperf-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

hz-simpleperf-debug solves the problem of CPU performance bottlenecks in Meta Quest and Horizon OS applications by profiling CPU usage and identifying areas for optimization.

Core Features & Use Cases

  • CPU Performance Profiling: Identifies CPU-bound, memory-bound, or I/O-bound workloads.
  • CPU Hotspot Recording: Determines which functions are consuming the most CPU cycles.
  • Kernel Overhead Measurement: Measures the amount of CPU time spent in kernel vs userspace.
  • Use Case: Diagnose whether an app is CPU-bound and find the specific functions causing high CPU usage.

Quick Start

Use the hz-simpleperf-debug skill to classify the CPU workload of your foreground app for 10 seconds.

Frequently Asked Questions about hz-simpleperf-debug

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

FAQPage Schema
How do I profile CPU usage to find bottlenecks in my Meta Quest app?▼

To profile CPU usage on Meta Quest, you can record CPU hotspots to identify which functions consume the most cycles and classify workloads as CPU-bound, memory-bound, or I/O-bound.

How do I measure kernel overhead versus userspace CPU time on Horizon OS?▼

Measuring kernel overhead on Horizon OS involves tracking the proportion of CPU time spent in kernel space compared to userspace, helping you identify if system calls or drivers are causing CPU performance issues.

Do I need specific tools to debug CPU performance on Meta Quest?▼

Debugging CPU performance on Meta Quest requires the simpleperf tooling for profiling and the metavr CLI for device management to execute workload classification and hotspot recording.

What is the best way to diagnose if my VR application is CPU-bound?▼

To diagnose a CPU-bound VR application, run a 10-second CPU workload classification on the foreground app to determine if performance bottlenecks are CPU, memory, or I/O related.

Can I identify specific functions causing high CPU usage in Horizon OS apps?▼

Identifying functions causing high CPU usage in Horizon OS apps is done through CPU hotspot recording, which pinpoints the exact functions consuming the most CPU cycles during execution.

Related Skills

Explore More Software Engineering Skills→
meta-questmeta-quest
176

metavr-cli

Manage Meta Quest devices, app lifecycles, and Perfetto traces via CLI.

Official
Advanced
meta-questmeta-quest
176

hz-perfetto-debug

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

Official
Advanced
LeKayLeKay

perf-profile

Profile CPU, memory, rendering, and I/O to detect performance bottlenecks.

Community
Advanced
TrainLCDTrainLCD
71

argent-native-profiler

Profile native CPU hotspots and memory leaks in iOS and Android apps.

Official
Advanced