unity-xr

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

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-xr-du-qwq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-xr
Source: https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications/tree/main/.agents/skills/unity-skills/skills/xr
Command: npx skills add https://github.com/du-qwq/Shader-Writing-Architecture-and-Specifications --skill unity-xr-du-qwq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up VR/AR interactions in Unity requires wiring many XRI components with exact property names, and reflection-based calls fail silently when names are wrong. This Skill provides verified workflows for building XR rigs, grab/socket/ray interactions, teleportation, and XR UI without guessing component details. ## Core Features & Use Cases - XR Rig Setup: Create an XR Origin with camera and controllers, validate the scene with xr_check_setup, and configure the XR UI event system. - Interaction Building: Add ray, direct, and socket interactors plus grab/simple interactables with correct collider and Rigidbody configurations. - Locomotion and Feedback: Set up teleportation areas/anchors, continuous movement, snap or smooth turning, haptics, and interaction layer filtering. - Use Case: A developer building a VR training app can scaffold the rig, add a grabbable tool with VelocityTracking movement, configure snap turn for comfort, and wire haptic feedback in a few calls. ## Quick Start Ask the AI to set up an XR rig with a ray interactor on the right controller and a grabbable cube using VelocityTracking movement.

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 the scene, then xr_setup_rig to create an XR Origin with camera and controllers. Add at least one interactor per controller and call xr_setup_event_system for XR UI input support.

How do I make an object grabbable in Unity VR?

Add an interactor with xr_add_direct_interactor or xr_add_ray_interactor, then call xr_add_grab_interactable on the target object. The object needs a Rigidbody and a non-trigger collider such as a BoxCollider or convex MeshCollider.

Does XR Interaction Toolkit 3.x work with Unity 6?

Yes, these xr skills support XRI 3.x on Unity 6 and XRI 2.x on Unity 2022. The reflection-based bridge prefers 3.x APIs first and falls back automatically for 2.x projects.

Why is my XR property change not applying in Unity?

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

What collider settings do XR interactors and interactables need?

XRDirectInteractor and XRSocketInteractor require trigger colliders, typically SphereColliders. XRGrabInteractable and TeleportationArea require non-trigger colliders, and dynamic mesh colliders must be convex.

How do I add teleportation and smooth locomotion in Unity VR?

Call xr_setup_teleportation, add a ray interactor, then mark surfaces with xr_add_teleport_area or create fixed points with xr_add_teleport_anchor. For stick movement use xr_setup_continuous_move and xr_setup_turn_provider with snap turn for comfort.