# hz-android-2d-porting

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

Guides porting existing Android 2D apps to Meta VR and Horizon OS — input adaptation, panel layout, and design requirements. Use when adapting a mobile Android app for Meta VR. For UI design decisions, use hz-panel-designer if available. Build path: Standard Android; 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-android-2d-porting ~/.claude/skills/hz-android-2d-porting
```

## From README

Android 2D App Porting to Horizon OS When to Use Use this skill when: Porting an existing Android 2D app to run on Meta VR headsets Adapting a mobile Android app for Horizon OS panels Troubleshooting input, layout, or compatibility issues with a 2D app on Meta VR devices Preparing an Android app for Horizon Store submission Evaluating whether an existing Android app is compatible with Horizon OS Overview Horizon OS is built on Android (AOSP) and can run standard Android applications inside panels -- floating 2D windows positioned in 3D space. Most well-built Android apps work on Meta VR devices with minimal changes, but several areas require attention: Input: There is no touchscreen. Users interact via controller pointer (ray-casting), hand tracking, or connected peripherals. Layout: Apps run in resizable panels, not full-screen on a fixed display. Compatibility: Dependencies and permissions must work without Google Play Services or unavailable hardware.

## Links

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

## More from this repo

- [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
- [hz-metavrx-layout-sdk](https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-metavrx-layout-sdk/index.md) — Used to build multi-window Meta Horizon OS experiences with the MetaVrx Layout SDK in Jetpack Compose or React Native.
   - [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars