Upgrades Meta VR apps to newer Horizon OS SDK versions — migration guides, deprecated API replacements, changelog.
$ npx skills add meta-quest/agentic-tools --skill hz-api-upgrade -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install meta-quest/agentic-tools hz-api-upgrade --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/meta-quest/agentic-tools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hz-api-upgrade .claude/skills/hz-api-upgrade && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "hz-api-upgrade" agent skill from https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-api-upgrade into .claude/skills/hz-api-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hz-api-upgrade", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-api-upgradeType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add meta-quest/agentic-tools --skill hz-api-upgrade -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install meta-quest/agentic-tools hz-api-upgrade --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/meta-quest/agentic-tools.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/hz-api-upgrade .agents/skills/hz-api-upgrade && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "hz-api-upgrade" agent skill from https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-api-upgrade into .agents/skills/hz-api-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hz-api-upgrade", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add meta-quest/agentic-tools --skill hz-api-upgrade -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install meta-quest/agentic-tools hz-api-upgrade --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/meta-quest/agentic-tools.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/hz-api-upgrade .cursor/skills/hz-api-upgrade && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "hz-api-upgrade" agent skill from https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-api-upgrade into .cursor/skills/hz-api-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hz-api-upgrade", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/meta-quest/agentic-tools.git --path skills/hz-api-upgrade--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add meta-quest/agentic-tools --skill hz-api-upgrade -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install meta-quest/agentic-tools hz-api-upgrade --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/meta-quest/agentic-tools.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/hz-api-upgrade .gemini/skills/hz-api-upgrade && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "hz-api-upgrade" agent skill from https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-api-upgrade into .gemini/skills/hz-api-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hz-api-upgrade", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install meta-quest/agentic-tools hz-api-upgradeInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add meta-quest/agentic-tools --skill hz-api-upgrade -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/meta-quest/agentic-tools.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/hz-api-upgrade .github/skills/hz-api-upgrade && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "hz-api-upgrade" agent skill from https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-api-upgrade into .github/skills/hz-api-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hz-api-upgrade", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add meta-quest/agentic-tools --skill hz-api-upgrade -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install meta-quest/agentic-tools hz-api-upgrade --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/meta-quest/agentic-tools.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/hz-api-upgrade .opencode/skills/hz-api-upgrade && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "hz-api-upgrade" agent skill from https://github.com/meta-quest/agentic-tools/tree/main/skills/hz-api-upgrade into .opencode/skills/hz-api-upgrade/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hz-api-upgrade", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
hz-api-upgradeUpgrades Meta VR apps to newer Horizon OS SDK versions — migration guides, deprecated API replacements, changelog.
Hz API Upgrade is an agent skill from meta-quest/agentic-tools. Upgrades Meta VR apps to newer Horizon OS SDK versions — migration guides, deprecated API replacements, changelog. Use when updating SDK versions or fixing deprecated API warnings. Build paths: all Meta VR app stacks; use hz-quest-verify-first if the build path is unclear.
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/api-changelog.md`, `references/deprecation-guide.md` and `references/sdk-migration.md`).
It sits in Development, covering Changelog and release notes and Code migrations. It works with Android, npm and Gradle. The repository describes itself as: Agent Skills for Meta Quest/Horizon OS VR Development. The licence is Apache-2.0.
6 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 3a8553d. It shows what the files ask for, not the result of running them.
Pre-approves these tools, so the agent can use them without asking each time:
Bash(metavr:*)Bash(hzdb:*)From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
npmnpxFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Hz API Upgrade loads about 1.8k tokens when it runs, and up to ~7k if it reads all its reference files. Until then it costs about 72 tokens; SKILL.md has 719 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from meta-quest/agentic-tools at commit 3a8553d, republished under its Apache-2.0 licence (© meta-quest). 719 words, ~1,757 tokens.
.claude/skills/hz-api-upgrade/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.For Unity projects using the Meta XR SDK, use the dedicated
hz-unity-sdk-upgrade skill. Continue
here for Unreal, native Android or Spatial SDK, Web or IWSDK, and general
cross-platform upgrade planning.
Use this skill when:
Every SDK upgrade, regardless of platform, follows the same high-level process:
Determine what version the project currently targets:
Packages/manifest.json or the Package Manager UI for com.meta.xr.* package versions.uplugin files or the Plugins browserbuild.gradle or build.gradle.kts for com.meta.spatial:* dependency versionspackage.json for @meta-spatial-sdk/* or @iwsdk/* package versionsBefore upgrading, review what changed between your current version and the target version. See references/api-changelog.md for a summary of recent changes.
Use the device hub to search documentation:
metavr docs search "release notes v72"
metavr docs search "migration guide openxr"Update the version numbers in your project configuration:
manifest.json directlybuild.gradlenpm update or edit package.jsonAfter updating, compile the project and address errors and warnings. See references/deprecation-guide.md for common replacements.
# Search project for known deprecated APIs
grep -rn "vrapi_" --include="*.c" --include="*.cpp" --include="*.h" src/
grep -rn "OVRManager" --include="*.cs" Assets/Deploy and verify functionality on a connected Meta VR device:
metavr app install ./build/output.apk
metavr app launch com.yourcompany.yourappEnsure the upgrade did not introduce performance regressions:
metavr perf captureThe Meta XR SDK for Unity is distributed as UPM packages. Upgrades are performed through the Unity Package Manager. Key packages include com.meta.xr.sdk.core, com.meta.xr.sdk.interaction, and com.meta.xr.sdk.platform.
See references/sdk-migration.md for the step-by-step Unity upgrade guide.
The Meta XR Plugin for Unreal is distributed as an engine plugin. Upgrades involve downloading the new plugin version and regenerating project files.
See references/sdk-migration.md for the step-by-step Unreal upgrade guide.
The Meta Spatial SDK is distributed as Gradle dependencies. Upgrades involve bumping version numbers in your Gradle build files.
See references/sdk-migration.md for the step-by-step Spatial SDK upgrade guide.
The Immersive Web SDK is distributed as npm packages. Upgrades involve updating package versions in package.json.
See references/sdk-migration.md for the step-by-step IWSDK upgrade guide.
Meta has progressively moved from Oculus.* and OVR* namespaces to Meta.* namespaces. After an upgrade, you may see compilation errors due to renamed classes or moved packages.
APIs that were deprecated in previous versions may be fully removed in newer versions. If you skipped intermediate upgrades, you may encounter missing symbols. Always upgrade incrementally.
Newer Horizon OS versions may require additional permissions in your AndroidManifest.xml. Common additions include:
com.oculus.permission.HAND_TRACKING for hand tracking featureshorizonos.permission.HEADSET_CAMERA for passthrough camera access<meta-data> entries for feature declarationsNewer SDK versions may require updated <meta-data> entries in AndroidManifest.xml, such as com.oculus.supportedDevices or updated minSdkVersion values.
New binary uploads for Meta Horizon apps must set targetSdkVersion within the supported range.
targetSdkVersion to API level 32-34 for immersive apps (or 32-36 for 2D panel apps)minSdkVersion can remain at API level 32Unity: Use the Project Setup Tool in the Meta XR SDK -- it can update API versions automatically. Or manually set in Player Settings -> Other Settings -> Target API Level.
Unreal: Use the Project Setup Tool in the Meta XR Plugin. Or set in Project Settings -> Android -> Target SDK Version.
Gradle (Spatial SDK / Native):
android {
defaultConfig {
targetSdkVersion 34 // 32-34 for immersive, 32-36 for 2D panel apps
minSdkVersion 32
}
}The metavr tool provides documentation search to help during upgrades. Invoke via metavr <args> (published as the npm package metavr; if metavr is not on PATH, run npx -y metavr <args>) — no global install needed.
# Search for migration-related documentation
metavr docs search "migration guide"
metavr docs search "deprecated API"
metavr docs search "breaking changes v73"
# Search for specific API replacements
metavr docs search "OVRManager replacement"
metavr docs search "vrapi openxr migration"© meta-quest, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 3 other files (references) in skills/hz-api-upgrade of meta-quest/agentic-tools.
Open the folder on GitHubat commit 3a8553d
Hz API Upgrade next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Hz API Upgrade this skillmeta-quest/agentic-tools | 215 | — | ~1.8k | Automated safety check: Pass | Apache-2.0 | |
| Update Version CatalogRedMadRobot/gradle-version-catalogs | 118 | — | ~9.5k | Automated safety check: Pass | MIT | |
| Project Gradle Third Party Version UpgradeafkT/DevUtils | 1.6k | — | ~1.2k | Automated safety check: Pass | Apache-2.0 | |
| Version Update WorkflowHkingAuditore/civ-game | 113 | — | ~742 | Automated safety check: Pass | None | |
| Docs Engineeringhiroshiyui/GuilelessBopomofo | 135 | — | ~806 | Automated safety check: Pass | GPL-3.0 | |
| Release Engineeringhiroshiyui/GuilelessBopomofo | 135 | — | ~1.6k | Automated safety check: Pass | GPL-3.0 |
RedMadRobot/gradle-version-catalogs
Use EVERY time the user asks to update / bump the version catalogs, "сделать обновление", "обновить каталог(и)", "обнови версии", "оформи изменения", "update the catalog", or to record dependency…
afkT/DevUtils
对 DevUtils 工程（DEPSROOT=file/gradle、DEPSMANIFEST=file/deps）中定义的第三方库 GAV 依赖做版本查证与升级；结合 Maven Central、Google Maven、Gradle Plugin Portal、 JitPack 与 GitHub Releases/README 交叉校验「最新可用版本」；必要时修正…
HkingAuditore/civ-game
Summarize and execute civ-game version update workflow, including change classification, changelog entry authoring, release highlights, and verification steps.
hiroshiyui/GuilelessBopomofo
Writing/updating project documentation (README, PRIVACY-POLICY, NOTICES, changelogs) and maintaining F-Droid metadata.
hiroshiyui/GuilelessBopomofo
Release engineering tasks including version bumping, building release APKs, creating git tags, writing changelogs, and preparing F-Droid releases.
arindamxd/camerax-android
A skill your agent uses when upgrading or migrating an Android project from any legacy Google Play Billing Library (PBL) version to the latest stable version of PBL.
meta-quest/agentic-tools
Guides porting existing Android 2D apps to Meta VR and Horizon OS — input adaptation, panel layout, and design requirements.
meta-quest/agentic-tools
Builds WebXR experiences for Meta VR and Horizon OS using the Immersive Web SDK (IWSDK) — ECS architecture, Three.js integration, spatial UI.
meta-quest/agentic-tools
Build multi-window Meta Horizon OS experiences with the MetaVrx Layout SDK in Jetpack Compose or React Native.
meta-quest/agentic-tools
Scaffolds new Meta VR and Horizon OS projects after the build path is selected — Standard Android, Meta Spatial SDK, Unity, Unreal, or WebXR.
meta-quest/agentic-tools
Analyzes Meta VR and Horizon OS VR performance using Perfetto traces — frame timing, CPU/GPU bottlenecks, render pass analysis.
meta-quest/agentic-tools
Build and iterate on React Native apps for Meta VR / Horizon OS with Expo.
Categories
Upgrades Meta VR apps to newer Horizon OS SDK versions — migration guides, deprecated API replacements, changelog. Hz API Upgrade is an agent skill from meta-quest/agentic-tools. Upgrades Meta VR apps to newer Horizon OS SDK versions — migration guides, deprecated API replacements, changelog.
Hz API Upgrade fits situations like: updating SDK versions; fixing deprecated API warnings.
Run `npx skills add meta-quest/agentic-tools --skill hz-api-upgrade -a claude-code`. Or copy the skill folder (skills/hz-api-upgrade in meta-quest/agentic-tools) into .claude/skills/hz-api-upgrade in your project. Claude Code loads it when a task matches its description.
Run `npx skills add meta-quest/agentic-tools --skill hz-api-upgrade -a codex`. Or copy the skill folder (skills/hz-api-upgrade in meta-quest/agentic-tools) into .agents/skills/hz-api-upgrade in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add meta-quest/agentic-tools --skill hz-api-upgrade -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hz-api-upgrade, .gemini/skills/hz-api-upgrade, .github/skills/hz-api-upgrade and .opencode/skills/hz-api-upgrade in your project.
Going by SKILL.md and its folder, Hz API Upgrade needs the command-line tools its instructions call (npm and npx). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Bash(metavr:*), Bash(hzdb:*).
SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Hz API Upgrade is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.8k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.2k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Hz API Upgrade: Update Version Catalog (RedMadRobot/gradle-version-catalogs, 118 stars), Project Gradle Third Party Version Upgrade (afkT/DevUtils, 1.6k stars), Version Update Workflow (HkingAuditore/civ-game, 113 stars) and Docs Engineering (hiroshiyui/GuilelessBopomofo, 135 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
meta-quest (a GitHub organization) maintains it in meta-quest/agentic-tools, which has 215 GitHub stars. The repository holds 34 skills in this directory. The repository was last updated on September 24, 2026.
Source: meta-quest/agentic-tools on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.
