Menu
Build or fix SPHR animated guided tours, including tourpoints, camera moves, text/media overlays, annotations, models, audio, and extra transitions.
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.
Build and verify SPHR 360 panorama scenes using equirectangular images, cube faces, node navigation, and guided tourpoints.
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.
Run complete SPHR Next verification for renderer, tour, layout, asset, and production-build changes.
| name | sphr-tour |
| description | Build or fix SPHR animated guided tours, including tourpoints, camera moves, text/media overlays, annotations, models, audio, and extra transitions. |
| argument-hint | ["tour/config path or behavior"] |
| 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-tour |
Use this for guided-tour behavior.
SPHR supports tour_data.spaces and legacy tourmodels.
Tourpoint fields:
{
"id": "point-1",
"text": "Primary tour text",
"secondaryText": "Optional detail",
"textPosition": "left",
"viewMode": "FPV",
"targetType": "NODE",
"nodeUUID": "entry",
"position": { "x": 0, "y": 1.5, "z": 4 },
"rotation": { "azimuth": 0, "polar": 0 },
"zoom": 0,
"files": [],
"models": [],
"annotations": [],
"sounds": [],
"extra": "projectToSplats"
}
Runtime behavior:
position, rotation, zoom, and viewMode drive camera pose.files render media in TourOverlay.models control SceneGraphLayer.showOnly.annotations control AnnotationLayer.show.sounds are passed to AudioController.extra maps to project-specific transitions such as shrinkToPoints, projectToSplats, and nightMode.extra is reusable, implement it in a named runtime method or layer.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 tourpoint count, key transitions/extras, media/model/audio hooks touched, and verification outcome.