spatial-developer — Claude Code skill: WebXR, AR/VR and Vision Pro
spatial-developer gives your agent working patterns for spatial interfaces: WebXR scenes in the browser, hit-test AR, visionOS views and Three.js interactions. Useful once the project leaves the flat screen.
MIT 175 installs ★ 39 updated 2025-12-25
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a claude-codeWhat spatial-developer does
The skill hands the agent concrete code for spatial interfaces: WebXR scenes, AR anchored to surfaces, native visionOS screens, 3D on Three.js and React Three Fiber. Among the files are VRScene.tsx with VRButton, controllers and hands, ARScene.tsx with hit-test, and ContentView.swift built on RealityView with a bottom ornament toolbar and a SharePlay button.
Interaction recipes come with it. Gaze selection casts a ray from the player camera. Pinches and selects arrive through useXREvent, and sound is placed at a point in the scene with PositionalAudio rather than a flat stereo channel.
The React examples expect the React Three Fiber stack already in the project: three, @react-three/fiber, @react-three/drei, @react-three/xr. Miss one and the snippets will not compile. The visionOS side is separate work in SwiftUI and RealityKit.
What it helps with
- stand up a browser VR scene with React Three Fiber
- anchor an AR object to a detected surface via hit-test
- sketch a spatial UI for visionOS
- wire a pinch gesture to an action
- place audio at a point in the scene
Example prompts for the agent
- Build a VR scene like
VRScene.tsx, with a box, controllers and hand tracking. - Add an AR scene with
hit-testso the object lands on the surface the user finds. - Show me how to catch the
squeezeevent withuseXREventand run an action.
How to install spatial-developer
1Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a claude-code2Manually: put the files in place
~/.claude/skills/spatial-developer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/spatial-developer/
1Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a codex2Manually: put the files in place
.agents/skills/spatial-developer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a cursor2Manually: put the files in place
.cursor/skills/spatial-developer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install daffy0208/ai-dev-standards skills/spatial-developer2Manually: put the files in place
.github/skills/spatial-developer/SKILL.md1Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a gemini-cli2Platform CLI
gemini skills install https://github.com/daffy0208/ai-dev-standards --path skills/spatial-developerManually: put the files in place
.devin/skills/spatial-developer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about spatial-developer
How do I install spatial-developer in Claude Code?
Run npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a claude-code. The skill file then sits at ~/.claude/skills/spatial-developer/SKILL.md.
What does spatial-developer do?
It helps the agent write AR/VR scenes for the browser, visionOS screens and Three.js interactions, shipping ready-made components, a Swift starting view and gesture patterns.
Which packages do the examples need?
three, @react-three/fiber, @react-three/drei and @react-three/xr in your project. The visionOS part relies on SwiftUI and RealityKit.
Source text
SKILL.md · MIT
---
name: spatial-developer
description: Expert in AR/VR, WebXR, and spatial computing for Vision Pro and web
version: 1.0.0
tags: [ar, vr, webxr, spatial-computing, visionos, three-js]
---
# Spatial Developer Skill
I help you build AR/VR experiences, spatial interfaces, and immersive 3D applications.
## What I Do
**WebXR Development:**
- AR/VR experiences in the browser
- Hand tracking and controllers
- Spatial anchors
- Immersive environments
**Vision Pro Development:**
- visionOS native apps
- Spatial UI design
- Reality Composer integration
- SharePlay experiences
**3D Web:**
- Three.js scenes
- React Three Fiber
- 3D interactions
- Spatial audio
## WebXR Basics
```bash
npm install three @react-three/fiber @react-three/drei @react-three/xr
```
### Simple VR Scene
```typescript
// components/VRScene.tsx
'use client'
import { Canvas } from '@react-three/fiber'
import { VRButton, XR, Controllers, Hands } from '@react-three/xr'
import { Box, OrbitControls } from '@react-three/drei'
export function VRScene() {
return (
<>
<VRButton />
<Canvas>
<XR>
<ambientLight intensity={0.5} />
<pointLight position={[10, 10, 10]} />
{/* 3D Content */}
<Box position={[0, 1, -2]} args={[1, 1, 1]}>
<meshStandardMaterial color="hotpink" />
</Box>
{/* VR Controllers */}
<Controllers />
{/* Hand Tracking */}
<Hands />
</XR>
</Canvas>
</>
)
}
```
---
## AR on Web (WebXR)
```typescript
// components/ARScene.tsx
'use client'
import { Canvas } from '@react-three/fiber'
import { ARButton, XR } from '@react-three/xr'
import { useState } from 'react'
export function ARScene() {
const [hitTest, setHitTest] = useState(null)
return (
<>
<ARButton
sessionInit={{
requiredFeatures: ['hit-test'],
optionalFeatures: ['dom-overlay']
}}
/>
<Canvas>
<XR
onHitTest={(hitMatrix, hit) => {
setHitTest(hit)
}}
>
<ambientLight />
{hitTest && (
<mesh position={hitTest.position}>
<sphereGeometry args={[0.1]} />
<meshStandardMaterial color="blue" />
</mesh>
)}
</XR>
</Canvas>
</>
)
}
```
---
## Vision Pro Spatial UI
```swift
// ContentView.swift
import SwiftUI
import RealityKit
struct ContentView: View {
var body: some View {
RealityView { content in
// Add 3D content
let model = ModelEntity(
mesh: .generateSphere(radius: 0.1),
materials: [SimpleMaterial(color: .blue, isMetallic: false)]
)
content.add(model)
}
.toolbar {
ToolbarItem(placement: .bottomOrnament) {
HStack {
Button("Reset") {
// Reset scene
}
Button("Share") {
// SharePlay
}
}
}
}
}
}
```
---
## 3D Interaction Patterns
### Gaze-Based Selection
```typescript
'use client'
import { useXR } from '@react-three/xr'
import { useFrame } from '@react-three/fiber'
import { useState } from 'react'
export function GazeSelect() {
const { player } = useXR()
const [gazing, setGazing] = useState(false)
useFrame(() => {
// Raycast from camera
const direction = player.camera.getWorldDirection(new Vector3())
// Check intersection with objects
// If gazing for 2 seconds, select
})
return (
<mesh onPointerEnter={() => setGazing(true)}>
<boxGeometry />
<meshStandardMaterial
color={gazing ? 'green' : 'white'}
/>
</mesh>
)
}
```
### Hand Gesture Recognition
```typescript
'use client'
import { useXREvent } from '@react-three/xr'
export function GestureControl() {
useXREvent('squeeze', (e) => {
console.log('Pinch gesture detected')
// Perform action
})
useXREvent('select', (e) => {
console.log('Select gesture')
})
return (
<mesh>
<sphereGeometry args={[0.05]} />
<meshStandardMaterial color="red" />
</mesh>
)
}
```
---
## Spatial Audio
```typescript
'use client'
import { PositionalAudio } from '@react-three/drei'
import { useRef } from 'react'
export function SpatialSound() {
const sound = useRef()
return (
<mesh position={[2, 1, -3]}>
<sphereGeometry args={[0.2]} />
<meshStandardMaterial color="yellow" emissive="yellow" />
<PositionalAudio
ref={sound}
url="/sounds/ambient.mp3"
distance={5}
loop
autoplay
/>
</mesh>
)
}
```
---
## When to Use Me
**Perfect for:**
- Building AR/VR web experiences
- Creating Vision Pro apps
- Implementing 3D interactions
- Spatial UI design
- Immersive storytelling
**I'll help you:**
- Set up WebXR projects
- Build AR features
- Implement hand tracking
- Design spatial interfaces
- Optimize 3D performance
## What I'll Create
```
🥽 VR Experiences
📱 AR Applications
👋 Hand Tracking
🎧 Spatial Audio
🌐 WebXR Scenes
🍎 Vision Pro Apps
```
Let's build the future of spatial computing!
© daffy0208 · MIT · daffy0208/ai-dev-standards