Perfetto Debug

by meta-quest

Perfetto Debug is a Quality skill for Claude Code, published by meta-quest in agentic-tools.

189 stars17 forkson meta-quest/agentic-toolsAdded 2026/09/06+1% in starsRepository updated 2026/08/21

View source on GitHub Download repo ZIP

adbagent-skillsclidev-toolshorizon-osmcpmcp-servermetameta-questmixed-realitymodel-context-protocolquestskillsvr

Install in seconds

Install Perfetto Debug

Copy Perfetto Debug into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-perfetto-debug ~/.claude/skills/hz-perfetto-debug

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/meta-quest/agentic-tools.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/hz-perfetto-debug/SKILL.md in meta-quest/agentic-tools
Installs to: ~/.claude/skills/hz-perfetto-debug
Collection: One of 25 skills cataloged from this repository
Category: Quality — 1745 skills

What Perfetto Debug does

Perfetto Debug analyzes Meta Quest and Horizon OS VR performance from Perfetto traces, including frame timing, CPU/GPU bottlenecks, render passes, and thermal issues. Use it when profiling frame drops, jank, or missed vsync deadlines on Quest devices.

Perfetto Debug is cataloged under Quality on DirSkills. Perfetto Debug comes from a repository tagged adb, agent-skills, cli, dev-tools and horizon-os.

Documentation

README

Excerpt

Perfetto Debug Skill

When to Use

Use this skill when investigating VR performance issues on Meta Quest 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.

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Perfetto Debug

What else does meta-quest publish alongside Perfetto Debug?
Perfetto Debug is one of 25 skills that DirSkills catalogs from meta-quest/agentic-tools, the repository it ships in. Its siblings there include Android 2D Porting, Horizon API Upgrade and Horizon Platform SDK. Each one is a separate skill with its own page in this directory, installs the same way Perfetto Debug does, and is maintained by meta-quest in that same repository. The rest of the collection is listed on the meta-quest/agentic-tools page.
How does Perfetto Debug compare to other Quality skills?
Perfetto Debug ranks #1591 by stars among the 1745 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Perfetto Debug against them. Open each page to compare what they document and how they install.