unity-xr

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

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-xr-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-xr
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/xr
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-xr-ethanjpope

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 validated workflows for building XR rigs, grab interactions, teleportation, and XR UI without guessing component fields. ## Core Features & Use Cases - Rig and Scene Setup: Create XR Origin, controllers, interaction manager, and XR UI event system, then validate the scene with diagnostic checks. - Interaction Building: Add ray, direct, and socket interactors plus grab/simple interactables with correct collider and Rigidbody configuration. - Locomotion and Feedback: Configure teleportation areas/anchors, continuous movement, snap or smooth turning, haptics, and interaction layer filtering. - Use Case: You are building a VR training app and need a grabbable tool with haptic feedback and snap-turn locomotion; run the setup skills in sequence to produce a working scene without manually inspecting XRI property names. ## Quick Start Ask the AI to set up an XR rig with a ray interactor on the right controller, a grabbable cube using VelocityTracking movement, and snap turn locomotion in the current Unity scene.

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 XRI?

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 this work with XRI 3.x on Unity 6?

Yes, the skills support XRI 2.x on Unity 2022 and XRI 3.x on Unity 6+. The reflection-based bridge automatically prefers 3.x APIs and falls back to 2.x when needed.

Why is my XR property change not taking effect?

The bridge is reflection-based, so a wrong property name is silently ignored without an error. Load API_REFERENCE.md for verified XRI property names before calling xr_configure_interactable, xr_configure_haptics, or xr_configure_interaction_layers.

What collider settings do XR interactors and interactables need?

XRDirectInteractor and XRSocketInteractor require trigger colliders, while XRGrabInteractable and teleportation targets require non-trigger colliders. XRRayInteractor needs no collider because it uses raycasts.

What happens if the XR Interaction Toolkit package is missing?

Every xr_* skill returns a NoXRI install instruction instead of executing when com.unity.xr.interaction.toolkit is not installed. Install the package first, then rerun xr_check_setup to validate the scene.