agentic-tools AGENTS.md

Project guidance for a repository of reusable instructions, called skills, for AI coding agents working on Meta Quest and Horizon OS applications. It explains the skill format and how agents should find supporting documentation.

In plain words
What is it for?
Use it to navigate Quest and Horizon OS development skills, read the right skill files, and work with packages compatible with several coding-agent tools.
Why use it?
It helps an agent understand that the repository contains guidance rather than ordinary software libraries. It also reduces unnecessary file reading by explaining which instructions to load first.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/meta-quest/agentic-tools/agents-md
Clone the repo
git clone --depth 1 https://github.com/meta-quest/agentic-tools

Made for: Codex, OpenCode.

Per session 2,466 This file is loaded in full into every session.
When invoked 2,466 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.02466 $0.02466
Opus 5 $0.01233 $0.01233
Sonnet 5 $0.00493 $0.00493
Haiku 4.5 $0.00247 $0.00247

Measured 2d ago against content hash ae8c9517d5c9, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

agentic-tools AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 111 lines

How it starts

The opening of the file, as written. The whole thing — 111 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Agent Guide — Meta Quest Agentic Tools

This file helps AI agents navigate and use this repository effectively.

What this repo is

A skills repository for AI coding agents that provides domain-specific guidance for Meta Quest and Horizon OS development. Skills are not code libraries — they are structured prompts and reference documentation that teach agents how to perform Quest development tasks. The repo includes Claude Code, Cursor, Codex, GitHub Copilot CLI, and Gemini-compatible packaging, and the skill format is intended to remain compatible with the broader open Agent Skills ecosystem.

How skills work

Each skill is a directory under skills/ with:

  • SKILL.md — required; the main skill definition and prompt
  • optional supporting files/directories such as references/, scripts/, assets/, examples/, and agents/

Agents should read SKILL.md first, then selectively load only the supporting files needed for the current task. Do not assume every skill has a references/ directory, and avoid loading all supporting files upfront.

Shared references

The current repo keeps general metavr reference material in:

  • docs/hzdb.md for the generated end-to-end CLI reference
  • skills/metavr-cli/ for install guidance, MCP usage, and focused metavr deep dives

When a skill needs generic metavr command guidance, prefer referencing those existing docs instead of creating another parallel copy.

Skill index

Skill Directory When to use
metavr-cli skills/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 skills/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 skills/hz-api-upgrade/ Guides Meta Quest and Horizon OS SDK/API upgrades, deprecated API replacements, migration planning, and changelog review.
hz-immersive-designer skills/hz-immersive-designer/ Reviews Meta Quest and Horizon OS VR/MR experiences for comfort, accessibility, spatial layout, and interaction quality.
hz-iwsdk-webxr skills/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 skills/hz-new-project-creation/ Scaffolds new Meta Quest and Horizon OS projects across Unity, Unreal, Android/Spatial SDK, and WebXR.
hz-perfetto-debug skills/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 skills/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 skills/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 skills/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 skills/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 skills/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-pwa skills/hz-store-pwa/ Guides shipping a web app to the Meta Quest and Horizon OS Store as a PWA/TWA, both 2D windowed panels and immersive WebXR, covering the IWSDK/web build, Vercel deploy, PWA manifest and icons, bubblewrap packaging with keystore and Digital Asset Links, and ovr-platform-util upload.
hz-store-submit skills/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 skills/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-face-tracking skills/hz-unity-face-tracking/ Drives ARKit-blendshape-rigged head/face models in Unity from the wearer's facial expressions on Meta Quest and Horizon OS via Meta Movement SDK (face tracking + Audio-to-Expression), for FBX models with the 52 ARKit blendshapes on Quest Pro / Quest 3 / Quest 3S.
hz-unity-fbx-import skills/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 skills/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-mixed-reality-utility-kit skills/hz-unity-meta-mixed-reality-utility-kit/ Builds scene-aware mixed reality in Unity for Meta Quest and Horizon OS with the Meta XR Mixed Reality Utility Kit (MRUK / com.meta.xr.mrutilitykit), including Scene API data, anchor-based prefab spawning, world locking, room-geometry raycasting, NavMesh generation, passthrough camera access, trackable detection, and room sharing.
hz-unity-meta-movement-sdk-retargeting skills/hz-unity-meta-movement-sdk-retargeting/ Sets up and tweaks Meta Movement SDK (MSDK) retargeting for humanoid character models on Meta Quest and Horizon OS, generating the retargeting config and hand-editing the resulting <asset>.json (joint mappings, mapping weights and behaviors, T-pose values).
hz-unity-meta-quest-ui skills/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-passthrough-camera-access skills/hz-unity-passthrough-camera-access/ Accesses the forward-facing RGB cameras on Meta Quest and Horizon OS (Quest 3 / Quest 3S) via Passthrough Camera Access (PCA) in Unity to feed Computer Vision and ML pipelines, covering camera image/texture capture, pose and intrinsics, pixel-to-world projection, resolution, and permissions.
hz-unity-placement skills/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 skills/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 skills/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 skills/hz-unity-tmp-resources/ Imports and verifies TextMesh Pro Essential Resources for Unity projects targeting Meta Quest and Horizon OS.
hz-vr-debug skills/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 skills/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 skills/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.

Read the full file on GitHub · 111 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 111 lines · 2,466 tokens per session scan A ae8c9517d5c9

Subscribe to this mod's changes

agentic-tools AGENTS.md is an instructions file published in the GitHub repository meta-quest/agentic-tools (187 stars, last pushed 11d ago), licensed Apache-2.0. It adds 2,466 tokens to every session, about $0.0123 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

ai-toolkit AGENTS.md

Instructions for pipefy/ai-toolkit, covering repository guidelines, documentation map, project structure, import namespace migration: pipefysdk → pipefy and src/pipefysdk/init.py (transitional shim).

pipefy/ai-toolkit · 3,184 tokens

superpowers-reasonix AGENTS.md

Instructions for christopherarter/superpowers-reasonix, covering project guidance, skills — stop. load a skill before you act, red flags — these thoughts mean stop. you are rationalizing and priority.

christopherarter/superpowers-reasonix · 761 tokens

ai-mind AGENTS.md

Instructions for HWYD/ai-mind, covering agents, version spec workspace continuity (mandatory), 项目定位, 事实来源优先级 and 开始大改前先读什么.

HWYD/ai-mind · 3,170 tokens

android-qa-kit AGENTS.md

Instructions for willbytee-sudo/android-qa-kit, covering agents.md — setting up and driving an android device, 1. how to work with the user, 2. start by finding out what's already there, 3. what you can do in each mode and 4. if there's no device: ask first.

willbytee-sudo/android-qa-kit · 2,707 tokens

finding-unknowns-skills CLAUDE.md

Claude Code instructions for Neeeophytee/finding-unknowns-skills, covering repo notes, what ships, and the gate that decides, version lives in three manifests — move them together, files that must be edited together and shipped guidance is not this file.

Neeeophytee/finding-unknowns-skills · 1,447 tokens

vvvv-skills CLAUDE.md

Claude Code instructions for tebjan/vvvv-skills, covering vvvv gamma, when to patch vs code, core concepts, live environment and important conventions.

tebjan/vvvv-skills · 987 tokens