Hz Quest Verify First

Verify First — Meta Quest Development

What you need to know before reading the rest of this

You are about to be told to call tools you may not recognize by name. Read this section first so the rest makes sense.

• Meta Quest is Meta's line of standalone VR / mixed-reality headsets (Quest 2, Quest 3, Quest 3S, Quest Pro). They run an Android-based OS.
• Horizon OS is the name of that operating system. It is forked from Android, ships on every Quest headset, and Meta updates it on its own cadence (separate from upstream Android). Many APIs are Horizon-OS-specific and have no analog in stock Android.
• metavr ("Meta VR CLI") is a Rust CLI tool published by Meta as a standalone binary and as metavr on npm. Invoke via metavr <args> (or npx -y metavr <args> with no install; npx always pulls the latest published version). It wraps adb and Meta's developer APIs into higher-level commands for Meta VR device development: list devices, install apps, capture Perfetto traces, search Meta VR documentation, query 3D asset libraries, automate UI interactions, etc. metavr is the primary action layer for Meta VR dev work — the equivalent of what gcloud is for GCP or git is for source control.
• metavr MCP server is a built-in mode of metavr that exposes a focused set of tools to AI coding agents over the Model Context Protocol. The relevant tools for this skill are:
  • vr_docs_search — search the official Meta developer documentation
  • vr_docs_get_page — fetch the full text of a specific docs page
  • device — query and control connected Meta VR Glasses and Meta Quest headsets (list, info, connect, reboot, battery, controllers, proximity, etc.)
  • app — query and manage installed apps (list, info, install, uninstall, launch, stop, clear)
  • files — file ops on a connected Meta VR device (ls, push, pull, rm, mkdir)
  • run — catch-all for any metavr subcommand without a dedicated tool (perf, ovrmetrics, ui, audio, casting, window, unity, sideload, asset, config, …). Its JSON Schema is generated from clap so the available subcommands and their typed args are visible to you in the tool definition.
  • cli_help — discover metavr subcommands and flags as markdown
• Meta SDKs you may not recognize that are commonly used in Quest projects: Meta XR All-in-One SDK (Unity), Meta XR Core / Interaction / Platform / Voice / Movement SDKs, Meta Spatial SDK (Kotlin / Android panels), IWSDK (Immersive Web SDK for WebXR), MRUK (Mixed Reality Utility Kit), Presence Platform, Horizon Platform SDK. These ship on their own release cadences, separate from Quest OS. Meta Spatial SDK is the immersive Android/Kotlin path; it is not required for ordinary 2D Android panel apps.
• OVR vs Meta XR — older Quest Unity content and most of the public web references the OVR namespace and the "Oculus Integration" Unity package. Both have been deprecated in favor of the Meta XR All-in-One SDK family. Most training data still recommends the deprecated names. Verify before recommending anything in this area.

Why this skill exists

Meta Quest and Horizon OS evolve fast. Meta SDKs ship every few weeks. APIs get renamed before public release. Manifest entitlements and store policies update monthly. Entire SDK families (Meta Spatial SDK, IWSDK, Horizon OS shells) post-date most LLM training corpora.

You almost certainly have stale knowledge about Quest specifics. The package names you remember have been renamed. The Unity menu paths have moved. The setup steps that worked on a prior Horizon OS version silently broke on the current one. The "OVR" namespace you reach for has been split across half a dozen Meta XR packages.

If you answer a Meta Quest question or write Quest-targeted code without verifying first, you will hallucinate. The user will not notice until their build fails, their app gets rejected from the store, or their AndroidManifest doesn't publish.

This skill is a hard gate. Treat it as a precondition, not a suggestion.

When this skill applies

You MUST run the verification flow below if ANY of the following is true for the current task:

• The user mentions Meta Quest, Quest 2 / 3 / 3S / Pro, Oculus, Horizon OS, MR, VR, XR, OpenXR (on Quest), Meta SDK, Meta XR, OVR, Spatial SDK, IWSDK, MRUK, Movement SDK, Voice SDK, Presence Platform, Horizon Platform SDK, hand tracking, passthrough, anchors, scene mesh, casting, eye tracking, body tracking, controllers, or platform compliance / store policy
• The repository contains any of:
  • Unity files with OVRPlugin, "Meta XR All-in-One SDK", or com.meta.xr.* in manifest.json / Packages/manifest.json
  • Spatial SDK gradle plugin (com.meta.spatial.plugins.*)
  • AndroidManifest with com.oculus.*, com.meta.quest.*, or horizon feature declarations
  • Package IDs starting with com.meta.* or com.oculus.*
  • .meta files indicating Unity, or Quest_*.uplugin / *.unrealhxr files
• The user's question references developers.meta.com/horizon, developer.oculus.com, oculus.com/sparkle-updates, or any Meta Quest documentation URL
• The agent is about to recommend any Meta SDK API, namespace, package, or AndroidManifest entitlement
• The agent is about to answer a question about app review, Meta Horizon Store submission, store-readiness or publishing requirements, content rating, or distribution
• The agent is about to write adb commands targeting a specific device
• The agent is about to claim what is or isn't installed on the user's Meta VR device

If you are not sure, the answer is YES — run the verification flow.

The verification flow

Step 1 — Identify the build path

Classify the project before choosing SDKs, docs scopes, or specialist skills:

Do not add Meta Spatial SDK to a Standard Android app merely because it targets Quest. When signals overlap, classify in this order:

1. com.meta.spatial dependency or Gradle plugin -> Meta Spatial SDK
2. Unity project files -> Unity
3. .uproject or Unreal modules -> Unreal Engine
4. OpenXR loader used directly from C/C++ or the NDK -> Native OpenXR
5. IWSDK or browser-delivered project -> WebXR
6. Otherwise, an Android app using Activities, Views, Compose, React Native, or Expo -> Standard Android

Step 2 — Verify against authoritative documentation

Before writing or recommending anything Quest-specific, call the vr_docs_search MCP tool. If MCP is not available, use the equivalent metavr CLI command metavr docs search.

MCP:

vr_docs_search(
  query="<the specific claim or API you are about to make>",
  scope="auto",   # or unity / unreal / spatial_sdk / android / native / web /
                  #    policy / distribution / design
  mode="verify"
)

CLI:

metavr docs search "<query>"

If you need exact wording (manifest entries, full API signatures, store policy text, code snippets), follow up with vr_docs_get_page on the canonical_url or doc_path returned by verify. Never paraphrase a truncated snippet when correctness matters.

CLI:

metavr docs fetch "<canonical_url_or_path>"