photo-sphere-viewer

photo-sphere-viewer is a skill for Claude Code, Codex from znlgis/opengis-skills. It costs 99 tokens per session (3,878 once invoked), scanned A, original, MIT.

A JavaScript library for showing 360-degree panoramic photos, videos, and virtual tours in a web browser. It supports panoramic images, markers, linked scenes, mobile motion controls, and optional VR viewing through plugins.

In plain words
What is it for?
Use it to embed interactive 360° photos or videos in vanilla JavaScript or React applications, add clickable markers, connect multiple scenes, or provide gyroscope and stereo viewing.
Why use it?
It avoids building the viewer, panorama navigation, annotations, and scene transitions from scratch.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to embed interactive 360° photos or videos in vanilla JavaScript or React applications, add clickable markers, connect multiple scenes, or provide gyroscope and stereo viewing.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/znlgis/opengis-skills/photo-sphere-viewer
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add znlgis/opengis-skills --skill photo-sphere-viewer
Clone the repo
git clone --depth 1 https://github.com/znlgis/opengis-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for photo-sphere-viewer

README.md
[![agentmods](https://agentmods.dev/badge/skills/znlgis/opengis-skills/photo-sphere-viewer/github.svg)](https://agentmods.dev/skills/znlgis/opengis-skills/photo-sphere-viewer)
Your own site
<a href="https://agentmods.dev/skills/znlgis/opengis-skills/photo-sphere-viewer"><img src="https://agentmods.dev/badge/skills/znlgis/opengis-skills/photo-sphere-viewer/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for photo-sphere-viewer

Your own site · 80×15
<a href="https://agentmods.dev/skills/znlgis/opengis-skills/photo-sphere-viewer"><img src="https://agentmods.dev/badge/skills/znlgis/opengis-skills/photo-sphere-viewer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 99 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,878 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00099 $0.03878
Opus 5 $0.00049 $0.01939
Sonnet 5 $0.00020 $0.00776
Haiku 4.5 $0.00010 $0.00388

Measured today against content hash a93168157baa, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

photo-sphere-viewer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

3d/photo-sphere-viewer/SKILL.md · 315 lines

How it starts

The opening of the file, as written. The whole thing — 315 lines — stays where its author put it; the contents beside it link to each section on GitHub.

仓库地址: https://github.com/mistic100/Photo-Sphere-Viewer

文档: https://photo-sphere-viewer.js.org

演示: https://photo-sphere-viewer.js.org/demos/

API 参考: https://photo-sphere-viewer.js.org/api/

Playground: https://photo-sphere-viewer.js.org/playground.html

许可证: MIT

最新版本: v5.15.0(2026-07)

概述

Photo-Sphere-Viewer (PSV) 是一个基于 Three.js 的纯 JavaScript 库,用于在 Web 浏览器中显示 360° 全景照片/球体图像。支持从简单的照片球体到复杂的带标记、导航、陀螺仪和 VR 的虚拟导览。

特性 说明
全景格式 等距柱状图、立方体贴图(6面/条纹/展开图)、双鱼眼原始格式
分块加载 大图分块(Equirectangular/Cubemap Tiles Adapter)
360° 视频 等距柱状图 + 立方体贴图视频支持
标记系统 图片/HTML/视频/SVG/多边形/折线标记,含提示框和动态缩放
VR 支持 移动端陀螺仪 + 立体视差模式(需 GyroscopePlugin + StereoPlugin)
虚拟导览 多全景场景链接,支持平滑过渡与双向箭头指示
插件生态 14 个官方插件(Markers、Gallery、VirtualTour、Autorotate、Map 等)
框架集成 原生 ES 模块,React wrapper 可用

唯一运行时依赖: Three.js(^0.185.1)。所有适配器和插件作为 @photo-sphere-viewer/* 独立 NPM 包发布。


环境准备与安装

安装核心包

npm install @photo-sphere-viewer/core

安装适配器和插件(按需)

# 适配器
npm install @photo-sphere-viewer/cubemap-adapter          # 立方体贴图
npm install @photo-sphere-viewer/equirectangular-video-adapter  # 360° 视频
npm install @photo-sphere-viewer/equirectangular-tiles-adapter  # 分块加载大图
npm install @photo-sphere-viewer/dual-fisheye-adapter     # 双鱼眼(Ricoh Theta 等)

# 常用插件
npm install @photo-sphere-viewer/markers-plugin           # 标记系统
npm install @photo-sphere-viewer/gallery-plugin           # 底部画廊
npm install @photo-sphere-viewer/virtual-tour-plugin      # 虚拟导览
npm install @photo-sphere-viewer/gyroscope-plugin         # 陀螺仪
npm install @photo-sphere-viewer/stereo-plugin            # 立体/VR
npm install @photo-sphere-viewer/autorotate-plugin        # 自动旋转
npm install @photo-sphere-viewer/video-plugin             # 视频控制条
npm install @photo-sphere-viewer/compass-plugin           # 罗盘
npm install @photo-sphere-viewer/map-plugin               # 地图集成

Read the full file on GitHub · 315 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed a93168157baa
  2. 9d ago Changed · -194 lines f4fb17589623
  3. 12d ago First seen · 509 lines · 99 tokens per session scan A 675c43280944

Subscribe to this mod's changes

photo-sphere-viewer is a skill published in the GitHub repository znlgis/opengis-skills (61 stars, last pushed yesterday), licensed MIT. It adds 99 tokens to every session and 3,878 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.