spatial-developer — скилл для Claude Code: WebXR, AR/VR и Vision Pro
Скилл spatial-developer для Claude Code даёт агенту приёмы для разработки пространственных интерфейсов: WebXR-сцен, AR с hit-test, приложений для visionOS и 3D на Three.js.
MIT 175 установок ★ 39 обновлён 2025-12-25
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a claude-codeЧто делает spatial-developer
Скилл даёт агенту рабочие приёмы для пространственных интерфейсов: WebXR-сцены в браузере, AR с привязкой к поверхности, нативные экраны visionOS, 3D на Three.js и React Three Fiber. Внутри лежит код, а не пересказ: VRScene.tsx с VRButton, контроллерами и трекингом рук, ARScene.tsx с hit-test, ContentView.swift на RealityView с панелью bottomOrnament и кнопкой SharePlay.
Есть и паттерны взаимодействия. Выбор взглядом строится на рейкасте из камеры игрока, жесты приходят через useXREvent('squeeze') и useXREvent('select'), звук ставится в точку сцены на PositionalAudio вместо плоского стереоканала.
React-примеры рассчитаны на стек React Three Fiber: three, @react-three/fiber, @react-three/drei, @react-three/xr. Без любого из этих пакетов сниппеты не соберутся, поэтому ставить их нужно в сам проект. Часть под visionOS отдельная и требует SwiftUI с RealityKit.
Какие задачи решает
- поднять VR-сцену в браузере на React Three Fiber
- привязать AR-объект к найденной плоскости через hit-test
- набросать spatial UI под visionOS
- поймать жест сжатия и повесить на него действие
- вывести звук в точку сцены, а не в стереоканал
Примеры запросов агенту
- Собери VR-сцену по образцу
VRScene.tsx: куб, контроллеры и трекинг рук. - Добавь AR-сцену с
hit-test, чтобы объект появлялся на найденной плоскости. - Покажи, как поймать событие
squeezeчерезuseXREventи запустить по нему действие.
Как установить spatial-developer
1Через Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a claude-code2Вручную: положить файлы
~/.claude/skills/spatial-developer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/spatial-developer/
1Через Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a codex2Вручную: положить файлы
.agents/skills/spatial-developer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a cursor2Вручную: положить файлы
.cursor/skills/spatial-developer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install daffy0208/ai-dev-standards skills/spatial-developer2Вручную: положить файлы
.github/skills/spatial-developer/SKILL.md1Через Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a gemini-cli2Командой платформы
gemini skills install https://github.com/daffy0208/ai-dev-standards --path skills/spatial-developerВручную: положить файлы
.devin/skills/spatial-developer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о spatial-developer
Как установить spatial-developer в Claude Code?
Выполните npx skills add daffy0208/ai-dev-standards --skill spatial-developer -a claude-code. Скилл окажется в ~/.claude/skills/spatial-developer/SKILL.md.
Что делает spatial-developer?
Помогает агенту писать AR/VR-сцены для браузера, экраны под visionOS и 3D-взаимодействия на Three.js: в скилле лежат готовые компоненты, Swift-заготовка и паттерны жестов.
Какие пакеты нужны, чтобы примеры заработали?
three, @react-three/fiber, @react-three/drei и @react-three/xr в проекте. Для части под visionOS нужны SwiftUI и RealityKit.
Исходный текст
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