unity-xr

Configures XR Interaction Toolkit rigs, interactors, locomotion, and haptics in Unity scenes.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-xr-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-xr
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/xr
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-xr-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up VR/AR interactions in Unity requires precise knowledge of XR Interaction Toolkit component names, collider rules, and property names, where reflection-based misconfigurations fail silently and are hard to debug. ## Core Features & Use Cases - Rig and Scene Setup: Create XR Origin rigs, interaction managers, and XR UI event systems, then validate the scene with diagnostic checks. - Interaction Configuration: Add ray, direct, and socket interactors plus grab/simple interactables with correct collider and movement-type settings. - Locomotion and Feedback: Configure teleportation, continuous movement, snap/smooth turning, XR UI canvases, haptics, and interaction layer filtering. - Use Case: When building a VR prototype, run the setup check, create the rig, add a ray interactor to the right controller, and make a cube grabbable with velocity-tracked physics in a few calls. ## Quick Start Ask the assistant to set up an XR rig with a ray interactor on the right controller and a grabbable cube using the unity-xr skill.

Frequently Asked Questions about unity-xr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an XR rig in Unity with XR Interaction Toolkit?

Run xr_check_setup to validate prerequisites, then xr_setup_rig to create the XR Origin with camera and controllers, and xr_setup_event_system for XR UI input. Add at least one interactor per controller to complete the rig.

How to make an object grabbable in Unity VR?

Use xr_add_grab_interactable on the target object, which adds a Rigidbody, non-trigger collider, and XRGrabInteractable. Choose movementType VelocityTracking for general props, Kinematic for tools, or Instantaneous for remote grabs.

Does this work with XRI 3.x on Unity 6?

Yes, all xr_* skills are reflection-based and support XRI 2.x on Unity 2022 and XRI 3.x on Unity 6+. The reflection helper prefers 3.x APIs first and falls back automatically for 2.x.

Why is my XR property change not taking effect?

The bridge is reflection-based, so a wrong property name on xr_configure_interactable, xr_configure_haptics, or xr_configure_interaction_layers is silently ignored. Load API_REFERENCE.md for verified XRI property names before detailed edits.

What collider settings do XR interactors and interactables need?

XRDirectInteractor and XRSocketInteractor need trigger colliders, while XRGrabInteractable and teleport targets need non-trigger colliders. Grabbables also require a Rigidbody, and dynamic mesh colliders must be convex.