skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
besty0728/unity-skills82 installs

unity-xr

Set up XR Interaction Toolkit (XRI) for VR/AR

How do I install this agent skill?

npx skills add https://github.com/besty0728/unity-skills --skill unity-xr
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is a development tool for configuring the Unity XR Interaction Toolkit. It is functional and follows standard Unity development practices, but it contains an inherent attack surface for indirect prompt injection because it reads and acts upon Unity scene data (such as GameObject names and properties) and possesses capabilities to wire events to code methods.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Unity XR Interaction Toolkit Skills

XR Interaction Toolkit setup and configuration. Every xr_* skill is reflection-based and supports XRI 2.x on Unity 2022 and XRI 3.x on Unity 6 and later. Parameters come from the schema (GET /skills/schema?names=<skill>&wire=v2); execution and dryRun rules: root SKILL.md.

Requires com.unity.xr.interaction.toolkit. When it is missing, every xr_* skill returns the NoXRI() install instruction instead of running.

When to use

  • Building VR or AR interaction
  • Setting up an XR rig
  • Configuring grab, socket or ray interactors

Rules

  • Read this module before the first xr_* call in a session. Wrong property names can fail silently, because the bridge is reflection-based.
  • Property names on XRI components must match XRI 2.x and 3.x exactly. A wrong field name on xr_configure_interactable or xr_configure_haptics is ignored without an error. Check detailed property edits in api-reference.
  • xr_configure_interaction_layers takes layer names or an integer mask, and rejects undefined names.
  • Most locomotion skills assume an XROrigin already exists.
  • Setup, collider rules, class names and version differences: setup-and-colliders.
  • For non-XR Canvas UI use the ui module. For XR gameplay architecture load advisory modules such as architecture, patterns, async or scriptdesign.

Pitfalls

  • XRHand, XRPlayer, XRTeleporter, GrabInteractor, VRController, XRLocomotion and XRManager are not the runtime classes to use here.
  • interactable.OnGrab() and OnRelease() are not the XRI event model. Use selectEntered and selectExited.
  • controller.vibrate() is not the route here. Configure haptics with xr_configure_haptics.
  • A physics Layer or Tag does not replace InteractionLayerMask.

Skills

Skills that act on an existing GameObject find it by name, entityId (preferred; the only id on Unity 6000.4+), instanceId or path.

Setup and diagnostics

SkillUseKey parameters
xr_check_setupValidate the package, rig, managers and scene prerequisitesverbose?
xr_setup_rigCreate an XR Origin with camera and controllersname, cameraYOffset?
xr_setup_interaction_managerAdd or find the interaction managernone
xr_setup_event_systemAdd the XR UI input stacknone
xr_get_scene_reportReport the scene's XR statusnone

Interactors and interactables

SkillUseKey parameters
xr_add_ray_interactorRemote pointing and ray interactionname, maxDistance?, lineType?
xr_add_direct_interactorClose-range hand grabname, radius?
xr_add_socket_interactorSnap to a slotname, showHoverMesh?, recycleDelay?
xr_add_grab_interactableRigidbody, collider and grab configurationname, movementType?, throwOnDetach?
xr_add_simple_interactableHover and select without grabname
xr_configure_interactableFine-tune interactable behaviortarget and changed fields only
xr_list_interactorsList the scene's interactorsnone
xr_list_interactablesList the scene's interactablesnone

Locomotion and XR UI

SkillUseKey parameters
xr_setup_teleportationAdd a teleport provider to the XR Originnone
xr_add_teleport_areaMark a surface as teleportablename, matchOrientation?
xr_add_teleport_anchorCreate a fixed teleport destinationname, x, y, z, rotY?, matchOrientation?
xr_setup_continuous_moveAdd stick locomotionmoveSpeed?, enableStrafe?, enableFly?
xr_setup_turn_providerAdd snap or smooth turnturnType, turnAmount?, turnSpeed?
xr_setup_ui_canvasConvert a Canvas for XR interactionname

Feedback and filtering

SkillUseKey parameters
xr_configure_hapticsSet hover and select vibrationname, intensities, durations
xr_add_interaction_eventWire an interaction callback to a target methodname, eventType, targetName, targetMethod
xr_configure_interaction_layersSet the InteractionLayerMaskname, layers, isInteractor

Quick start

curl -s "http://localhost:<port>/skill/xr_check_setup?expectProject=<project>" -d '{}'
curl -s "http://localhost:<port>/skill/xr_setup_rig?expectProject=<project>" -d '{"name":"XR Origin","cameraYOffset":1.36}'
curl -s "http://localhost:<port>/skill/xr_setup_event_system?expectProject=<project>" -d '{}'
curl -s "http://localhost:<port>/skill/xr_add_ray_interactor?expectProject=<project>" -d '{"name":"Right Controller","maxDistance":30,"lineType":"StraightLine"}'
curl -s "http://localhost:<port>/skill/xr_add_direct_interactor?expectProject=<project>" -d '{"name":"Left Controller"}'
curl -s "http://localhost:<port>/skill/xr_setup_teleportation?expectProject=<project>" -d '{}'
curl -s "http://localhost:<port>/skill/xr_add_grab_interactable?expectProject=<project>" -d '{"name":"MyCube","movementType":"VelocityTracking"}'

Reference

  • setup-and-colliders: rig and grab workflows, collider rules, class names, XRI 2.x and 3.x differences
  • api-reference: verified XRI property names, event and property tables, and detailed workflows

Errors

Transport-level codes: error codes.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-xr">View unity-xr on skillZs</a>