Menu
Build and verify SPHR 360 panorama scenes using equirectangular images, cube faces, node navigation, and guided tourpoints.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Convert and verify Matterport E57 exports for SPHR, including aligned 360 cube-face scan nodes, reduced 50k GLB meshes, data-only bootstrap/manifest packages, and browser navigation checks. Use when working with Matterport E57 or zip exports, Matterport scan alignment, SPHR Matterport data packages, mesh repair, or Matterport-like click/next panorama navigation.
Integrate Spark-rendered 3D Gaussian splats into SPHR Next, including legacy conversion, file inspection, config wiring, transforms, loading behavior, and verification.
Build and verify SPHR IIIF image server scenes and inspectable image planes.
Inspect, set up, and manage the SPHR Next project envelope, scene configs, local assets, and dev URLs before deeper SPHR scene work.
Build or fix SPHR animated guided tours, including tourpoints, camera moves, text/media overlays, annotations, models, audio, and extra transitions.
Run complete SPHR Next verification for renderer, tour, layout, asset, and production-build changes.
| name | sphr-360 |
| description | Build and verify SPHR 360 panorama scenes using equirectangular images, cube faces, node navigation, and guided tourpoints. |
| argument-hint | ["config/node asset instructions"] |
| allowed-tools | Read Write Glob Bash(ls *) Bash(rg *) Bash(node .claude/scripts/project/asset-inventory.mjs *) Bash(node .claude/scripts/project/validate-bootstrap.mjs *) Bash(node .claude/scripts/tour/create-bootstrap.mjs *) Bash(node .claude/scripts/project/verify-app.mjs *) Bash(npm run typecheck *) Bash(npm run build *) |
| agent | sphr-360 |
Use this for SPHR 360 image tours.
Set space.type to spaces and define space.space_data.nodes.
Equirectangular node:
{
"uuid": "entry",
"image": "/panos/entry.jpg",
"position": { "x": 0, "y": 1.5, "z": 0 },
"rotation": { "x": 0, "y": 0, "z": 0 }
}
Cube-face node:
{
"uuid": "room-a",
"faces": [
"/panos/room-a/px.jpg",
"/panos/room-a/nx.jpg",
"/panos/room-a/py.jpg",
"/panos/room-a/ny.jpg",
"/panos/room-a/pz.jpg",
"/panos/room-a/nz.jpg"
],
"position": { "x": 2, "y": 1.5, "z": -3 }
}
Template node:
{
"uuid": "room-b",
"textureTemplate": "/panos/{uuid}/{face}-{resolution}.jpg",
"resolution": "2k",
"position": { "x": 4, "y": 1.5, "z": -5 }
}
PanoramaLayer supports equirectangular spheres and cube faces. NavigationLayer handles floor markers and click navigation.
For pano tours, tourpoints should use targetType: "NODE" and nodeUUID:
{
"id": "entry-intro",
"nodeUUID": "entry",
"targetType": "NODE",
"viewMode": "FPV",
"rotation": { "azimuth": 30, "polar": 0 },
"zoom": 12,
"text": "Intro text"
}
Run asset inventory and bootstrap validation before browser testing:
node .claude/scripts/project/asset-inventory.mjs
node .claude/scripts/project/validate-bootstrap.mjs <config>
npm run typecheck
npm run build
node .claude/scripts/project/verify-app.mjs --url "http://localhost:3000/?config=/configs/<config>.json" --screenshots
Final response should report node count, asset pattern, initial node, tourpoint count, and verification outcome.