pico-design

Provides verified PICO Unity SDK v3.4.0 API references, workflows, and anti-hallucination rules for XR development.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI assistants frequently hallucinate PICO Unity SDK method names, use deprecated APIs from older SDK versions, or misuse signatures with wrong parameter orders and return types. This Skill anchors every PICO XR development answer to the official v3.4.0 documentation so generated Unity code compiles and follows current API contracts. ## Core Features & Use Cases - API Signature Verification: Complete method tables for the nine core PXR_* classes (PXR_Input, PXR_System, PXR_MixedReality, PXR_MotionTracking, PXR_HandTracking, PXR_CameraImage, PXR_Boundary, PXR_FoveationRendering, PXR_Enterprise) with exact signatures and deprecation status. - Domain Workflows: Step-by-step integration guides for controller input, hand tracking, eye/face/body tracking, haptic feedback, spatial anchors, scene capture, video seethrough, and camera image capture. - Pitfall Prevention: A blacklist of deprecated APIs, semantic traps (e.g., TrackingStateCode int returns instead of bool), mutual-exclusion constraints, and known contradictions in official documentation. - Use Case: When asked to implement spatial anchors on PICO 4 Ultra, the Skill enforces the correct sequence StartSenseDataProvider → CreateSpatialAnchorAsync → PersistSpatialAnchorAsync, and prevents mistakes like destroying an anchor before unpersisting it. ## Quick Start Ask the AI to write or review any PICO Unity SDK code, such as implementing hand tracking interaction or video seethrough, and it will verify every API call against the v3.4.0 reference tables before generating code.

Frequently Asked Questions about pico-design

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

FAQPage Schema
How do I implement hand tracking in Unity with the PICO SDK?

Add the HandLeft and HandRight prefabs under XR Origin after deleting the controller objects, attach PXR_Manager, and enable Hand Tracking. Read joints via PXR_HandTracking.GetJointLocations and aim state via GetAimState; XRI bindings must be added manually to the XRI Default Input Actions.

How do I create spatial anchors with PXR_MixedReality?

Call StartSenseDataProvider with SpatialAnchor type, then CreateSpatialAnchorAsync, PersistSpatialAnchorAsync, and QuerySpatialAnchorAsync to reload by UUID. Always call UnPersistSpatialAnchorAsync before DestroyAnchor, and never run queries concurrently.

Which PICO vibration APIs are deprecated in SDK v3.4.0?

All legacy vibration methods including SetControllerVibration, StartVibrateBySharem, StartVibrateByPHF, and the HapticStream family are deprecated. Use PXR_Input.SendHapticImpulse for simple haptics and SendHapticBuffer for AudioClip, PCM, or PHF-based buffered haptics.

Does PXR_MotionTracking return bool or int for eye tracking calls?

PXR_MotionTracking methods return int as TrackingStateCode, where PXR_MT_SUCCESS is 0 and failures are negative values like -5 for eye tracking permission denied. Writing if(GetEyeTrackingData(...)) will not compile; compare the result against zero instead.

Why does video seethrough not work on my PICO Unity app?

Video seethrough requires disabling all post-processing, setting the main camera Clear Flags to Solid Color with background RGBA all zero, and disabling HDR when using Vulkan with URP or Built-in. Enable it via PXR_Manager.EnableVideoSeeThrough and listen to VstDisplayStatusChanged for the actual state.

Can I use PXR_Enterprise APIs on consumer PICO 4 devices?

No, PXR_Enterprise methods only work on enterprise devices such as PICO Neo3 Pro or PICO 4 Enterprise. They also require calling InitEnterpriseService then BindEnterpriseService before any other enterprise API, and must not be called on consumer devices.