# hz-simpleperf-debug

> Claude/Codex skill by [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars · Updated 2026-09-24

Profiles Meta VR and Horizon OS application CPU performance using simpleperf — workload classification, CPU hotspot recording, kernel overhead measurement. Use when diagnosing whether an app is CPU-bound, memory-bound, or I/O-bound on Meta VR devices. Build paths: all Meta VR app stacks; use hz-quest-verify-first if the build path is unclear.

Tags: adb, agent-skills, cli, dev-tools, horizon-os, mcp, mcp-server, meta, meta-quest, mixed-reality, model-context-protocol, quest, skills, vr

## Install

```sh
git clone https://github.com/meta-quest/agentic-tools /tmp/agentic-tools && ln -s /tmp/agentic-tools/skills/hz-simpleperf-debug ~/.claude/skills/hz-simpleperf-debug
```

## From README

Simpleperf Debug Skill When to Use Use this skill when you need hardware-level CPU performance insights on Meta VR devices: Classifying whether an app is CPU-bound, memory-bound, or I/O-bound Finding CPU hotspot functions consuming the most cycles Measuring kernel vs userspace CPU overhead per thread Identifying cache-thrashing or branch-prediction issues Supplementing Perfetto trace analysis with hardware PMU counter data This skill complements hz-perfetto-debug. Perfetto shows what your app is doing over time. Simpleperf shows where the CPU is spending hardware cycles — cache misses, branch mispredictions, and instruction throughput that Perfetto can't see. VR Performance Context Meta VR devices run on mobile ARM SoCs with strict thermal and power budgets.

## Links

- HTML page: https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-simpleperf-debug/
- GitHub: https://github.com/meta-quest/agentic-tools
- Author: [@meta-quest](https://omgskills.com/library/meta-quest/index.md)

## More from this repo

- [hz-android-2d-porting](https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-android-2d-porting/index.md) — Guides porting existing Android 2D apps to Meta VR and Horizon OS — input adaptation, panel layout, and design...
   - [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars
- [hz-immersive-designer](https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-immersive-designer/index.md) — Guides design of comfortable, intuitive VR/MR experiences for Meta VR and Horizon OS — comfort guidelines, interaction...
   - [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars
- [hz-iwsdk-webxr](https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-iwsdk-webxr/index.md) — Builds WebXR experiences for Meta VR and Horizon OS using the Immersive Web SDK (IWSDK) — ECS architecture, Three.js...
   - [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars