spatial-sdk-guideline
Installation
SKILL.md
PICO Spatial SDK 3D Developer
Description and Goals
Use this skill for focused SDK API guidance, isolated implementation patterns, and non-deliverable diagnosis in PICO Spatial SDK on PICO OS 6 (Android + Kotlin + Jetpack Compose + Spatial ECS).
Route any requested edit that creates, loads, parents, transforms, arranges, places, or validates a Kotlin Entity hierarchy to spatial-sdk-scene-builder. This skill may provide the API facts that support that implementation, but it does not own the resulting scene change.
Goals:
- Pick the right container (WindowContainer vs Stage) and understand space-state constraints.
- Understand ECS (entities/components/systems) choices needed for maintainable, performant scene code.
- Explain resource-loading options (USD preferred, glTF/GLB supported, AssetBundle workflow) and their lifecycle constraints.
- Diagnose interaction prerequisites (programmatic hit testing needs
CollisionComponent; user interaction needsCollisionComponent + InteractableComponent, plus targeting/gestures patterns). - Avoid common pitfalls (threading, coordinate-handedness, unit conversions, physics-world scoping).
- Keep content within typical performance budgets for 90 fps.