by meta-quest
Agent Skills for Meta Quest/Horizon OS VR Development
# Add to your Claude Code skills
git clone https://github.com/meta-quest/agentic-toolsGuides for using ai agents skills like agentic-tools.
agentic-tools is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by meta-quest. Agent Skills for Meta Quest/Horizon OS VR Development. It has 100 GitHub stars.
agentic-tools's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/meta-quest/agentic-tools" and add it to your Claude Code skills directory (see the Installation section above).
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh agentic-tools against similar tools.
No comments yet. Be the first to share your thoughts!
Unlocks once the catalog security scan passes (runs nightly).
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
Agentic skills and tools for Meta Quest and Horizon OS development.
This repository packages a curated set of agentic tools and skills for Meta Quest and Horizon OS development, along with shared Meta VR CLI (metavr) references and contribution/process documentation for maintaining the skill ecosystem.
The skills follow the open Agent Skills model: each skill has a required SKILL.md plus optional supporting files that are loaded on demand. This repo includes packaging artifacts for Claude Code, Cursor, GitHub Copilot CLI, and Gemini-compatible environments.
Skills are powered by the Meta VR CLI (metavr), which provides device management, app management, performance tooling, and documentation search through both direct commands and an MCP server.
metavr) — invoke via npx (no install required):
npx -y metavr --version
Add Meta Quest Agentic Tools marketplace and install the agentic tools plugin
Within claude run:
/plugin marketplace add meta-quest/agentic-tools
/plugin install meta-vr@meta-quest
Install from the Cursor marketplace with:
/add-plugin meta-quest-agentic-tools
Or install online at: https://cursor.com/marketplace/meta-reality-labs
gemini extensions install https://github.com/meta-quest/agentic-tools
gh skill)These skills are published as Agent Skills releases and can be installed with the built-in gh skill command, independent of any specific editor or plugin marketplace. Requires a recent GitHub CLI (gh) — gh skill is a preview feature.
# Install all skills from this repo
gh skill install meta-quest/agentic-tools
# Install a single skill
gh skill install meta-quest/agentic-tools hz-spatial-sdk
# Pin to a specific release tag
gh skill install meta-quest/agentic-tools hz-spatial-sdk --pin v1.2.1
By default skills install at project scope for GitHub Copilot. Use --agent (e.g. claude-code, cursor, codex, gemini-cli) and --scope user to target a specific agent or make skills available everywhere:
gh skill install meta-quest/agentic-tools --agent claude-code --scope user
metavr includes a built-in Model Context Protocol (MCP) server with 40+ tools for device management, app control, file operations, documentation search, performance tracing, and more. This lets AI coding assistants interact directly with your Meta Quest device.
# Claude Code
npx -y metavr mcp install claude-code
# Claude Desktop
npx -y metavr mcp install claude-desktop
# Cursor
npx -y metavr mcp install cursor
# VS Code / VS Code Insiders
npx -y metavr mcp install vscode
npx -y metavr mcp install vscode-insiders
# Windsurf
npx -y metavr mcp install windsurf
# Zed
npx -y metavr mcp install zed
# Android Studio (Gemini)
npx -y metavr mcp install android-studio
# Gemini CLI
npx -y metavr mcp install gemini-cli
# OpenAI Codex CLI
npx -y metavr mcp install codex
# LM Studio
npx -y metavr mcp install lm-studio
# OpenCode
npx -y metavr mcp install open-code
# Google Antigravity (Gemini)
npx -y metavr mcp install antigravity
# Generic project-local config
npx -y metavr mcp install project
Or start the MCP server directly:
npx -y metavr mcp server
Bun users: substitute
bunx metavrfornpx -y metavr(no-yneeded).
| Skill | Description |
|---|---|
metavr-cli |
Provides the Meta VR CLI (metavr command) reference for Meta Quest and Horizon OS device management, app management, docs search, audio control, test setup, performance tooling, and MCP usage. |
hz-android-2d-porting |
Guides Android 2D app porting to Meta Quest and Horizon OS panels, including input adaptation, Gradle setup, compatibility, and panel layout. |
hz-api-upgrade |
Guides Meta Quest and Horizon OS SDK/API upgrades, deprecated API replacements, migration planning, and changelog review. |
hz-immersive-designer |
Reviews Meta Quest and Horizon OS VR/MR experiences for comfort, accessibility, spatial layout, and interaction quality. |
hz-iwsdk-webxr |
Builds WebXR experiences for Meta Quest and Horizon OS using the Immersive Web SDK, Three.js, ECS patterns, and spatial UI. |
hz-new-project-creation |
Scaffolds new Meta Quest and Horizon OS projects across Unity, Unreal, Android/Spatial SDK, and WebXR. |
hz-perfetto-debug |
Analyzes Meta Quest and Horizon OS performance with Perfetto traces, including frame timing, CPU/GPU bottlenecks, and thermal issues. |
hz-platform-sdk |
Guides Horizon Platform SDK API usage for Meta Quest and Horizon OS Android/Kotlin apps across the public platform packages. |
hz-psdk-integration |
Guides interactive Horizon Platform SDK integration for Meta Quest and Horizon OS Android/Kotlin projects, from codebase analysis through on-device validation. |
hz-quest-verify-first |
Forces docs-first verification against current Meta Quest and Horizon OS documentation and metavr capabilities before answering or editing Quest-specific code. |
hz-simpleperf-debug |
Profiles Meta Quest and Horizon OS CPU performance with simpleperf, including workload classification, hotspot recording, and kernel overhead analysis. |
hz-spatial-sdk |
Builds spatial Android apps for Meta Quest and Horizon OS with Meta Spatial SDK, including ECS architecture, panels, 3D objects, and hybrid experiences. |
hz-store-submit |
Guides Meta Quest and Horizon OS app submission to the Meta Horizon Store, including build validation, VRC compliance, assets, upload, and review tracking. |
hz-unity-code-review |
Reviews Unity code targeting Meta Quest and Horizon OS for rendering, performance, input handling, allocations, and common VR pitfalls. |
hz-unity-fbx-import |
Ensures complete FBX URLs or absolute paths are used when importing external 3D models into Unity projects targeting Meta Quest and Horizon OS. |
hz-unity-meta-core-sdk |
Guides Meta XR Core SDK (com.meta.xr.sdk.core) usage for Meta Quest and Horizon OS Unity XR development, including OVRManager, OVRCameraRig, passthrough, hand tracking, spatial anchors, boundaryless mode, controller input, Scene API, OVRProjectSetup, and AndroidManifest generation. |
hz-unity-meta-quest-ui |
Configures Unity UI for Meta Quest and Horizon OS VR development, including world-space canvases, TextMesh Pro, sizing, and interaction readiness. |
hz-unity-placement |
Ensures accurate object placement in Unity projects targeting Meta Quest and Horizon OS using Renderer and Collider bounds. |
hz-unity-platform-sdk |
Guides Horizon Platform SDK integration for Meta Quest and Horizon OS Unity/C# apps across all 18 public platform packages, including achievements, IAP, users, leaderboards, challenges, presence, notifications, entitlements, setup, initialization, and error handling. |
hz-unity-project-analyzer |
Analyzes and maintains .agent-docs/ project knowledge bases for Unity projects targeting Meta Quest and Horizon OS. |
hz-unity-tmp-resources |
Imports and verifies TextMesh Pro Essential Resources for Unity projects targeting Meta Quest and Horizon OS. |
hz-vr-debug |
Debugs Meta Quest and Horizon OS VR/MR apps with metavr logs, screenshots, app inspection, and common issue diagnosis. |
hz-xr-simulator-setup |
Sets up Meta XR Simulator workflows for testing Meta Quest and Horizon OS Unity or Unreal apps without a physical device. |
portal |
Builds and sideloads Android apps for Meta Portal devices (Portal, Portal+, Portal Mini, Portal Go, Portal TV) with metavr, covering ADB enablement, the no-GMS constraint, launcher intent-filters, icon density quirks, the Smart Camera SDK, and the gradle build/deploy/debug loop. |
metavr organizes commands into groups:
| Command group | Purpose |
|---|---|
metavr device |
List, connect, reboot, and query connected Quest devices |
metavr app |
Install, launch, stop, and inspect apps on a device |
metavr capture |
Capture screenshots |
metavr files |
Manage files on the device (ls, push, pull, rm) |
metavr perf |
Capture and analyze Perfetto performance traces |
metavr docs |
Search Meta Quest developer documentation |
metavr asset |
Search Meta's 3D asset library |
metavr config |
Manage CLI configuration settings |
metavr log |
View device logs (shortcut for adb logcat) |
metavr shell |
Run shell commands on the device |
metavr adb |
Direct ADB passthrough commands |
metavr mcp |
Start the MCP server for AI-agent integration |
Run npx -y metavr --help or npx -y metavr <group> --help for full usage details.
.
├── .claude-plugin/ # Claude Code plugin configuration
│ ├── plugin.json # Plugin metadata (name, version, keywords)
│ └── marketplace.json # Marketplace listing
├── .cursor-plugin/ # Cursor plugin configuration
│ ├── plugin.json # Plugin manifest with skills paths
│ └── marketplace.json # Marketplace listing
├── .github/plugin/ # GitHub Copilot CLI plugin configuration
│ ├── plugin.json # Plugin metadata with skills paths
│ └── marketplace.json # Marketplace li