unity-xr

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

2|Updated May 18, 2026
One-click install
npx skills add https://github.com/pcone-mm/NewFPG --skill unity-xr-pcone-mm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-xr
Source: https://github.com/pcone-mm/NewFPG/tree/main/.agents/skills/unity-skills/skills/xr
Command: npx skills add https://github.com/pcone-mm/NewFPG --skill unity-xr-pcone-mm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up VR/AR interaction 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/socket/ray interactors, teleportation, and XR UI without guessing component APIs. ## Core Features & Use Cases - XR Rig Setup and Diagnostics: Validate the scene with xr_check_setup, then create an XR Origin with camera and controllers, an interaction manager, and an XR UI event system. - Interactors and Interactables: Add ray, direct, and socket interactors plus grab/simple interactables with correct collider and Rigidbody configuration. - Locomotion and XR UI: Configure teleportation areas/anchors, continuous movement, snap or smooth turning, haptics, interaction events, and world-space canvases. - Use Case: You want a grabbable cube in VR. Run xr_setup_rig, add a direct interactor to the left controller, then call xr_add_grab_interactable with VelocityTracking movement to get a physics-based grab working immediately. ## 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 the scene, then call xr_setup_rig to create an XR Origin with camera and controllers. Add at least one interactor per controller and ensure an XRInteractionManager and XR UI event system exist.

How do I make an object grabbable in Unity VR?

Use xr_add_grab_interactable on the target object, which adds an XRGrabInteractable with a Rigidbody and non-trigger collider. Pair it with a direct interactor for hand grab or a ray interactor for distance grab, choosing VelocityTracking, Kinematic, or Instantaneous movement.

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 through a reflection-based bridge that prefers 3.x APIs and falls back automatically. The com.unity.xr.interaction.toolkit package must be installed first.

Why is my XR property change being ignored?

The bridge is reflection-based, so a wrong XRI property name fails silently without an error. Load API_REFERENCE.md before detailed property edits to get verified property names for XRRayInteractor, XRGrabInteractable, and other components.

What collider setup do XR interactors and interactables need?

Direct and socket interactors need trigger colliders, while grab interactables and teleportation areas need non-trigger colliders. XRGrabInteractable also requires a Rigidbody, and dynamic mesh colliders must be convex.