# 3d-virtual-tour

Скилл для сборки виртуальных туров по 3D-сцене: маршрут камеры, переходы между комнатами, осмотр модели. Пригодится для архитектурных обходов и шоурумов на Three.js.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 527 установок · ★ 7001
- Автор: MengTo
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/MengTo/Skills/tree/HEAD/agent-skills/3d/3d-virtual-tour/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/3d-virtual-tour

## Что делает

Скилл описывает, как собрать тур по 3D-сцене: авторский маршрут камеры, переходы к комнатам по списку или плану этажа, режим осмотра модели с ограниченным орбитальным управлением. Есть и режим свободной ходьбы, но его включают только по запросу. Если на входе лишь набор панорам, скилл советует связать точки обзора, а не делать вид, что в сцене есть проходимая геометрия.

Маршрут хранится как ключи с прогрессом, позицией, направлением взгляда и углом обзора. Ключи ставят до, внутри и после узких проёмов, высоту глаз считают от пола, перед поворотами камеру замедляют. Интерполяция — timed Hermite или сплайн; при интерполяции направления взгляда следят, чтобы цель не пересеклась с камерой, иначе камера развернётся. Кривая не равна расстоянию: для ровной скорости нужна выборка по длине дуги.

Камерой в каждый момент владеет один контроллер — маршрут, орбита или обработчик перехода, а не все сразу. При входе в осмотр сохраняются координата маршрута, активная остановка и позиция прокрутки; на выходе состояние восстанавливается, а инерция перетаскивания сбрасывается. Прямая линия от интерьера к внешней орбите может пройти сквозь крышу, поэтому переход строят по безопасным точкам или делают короткое затемнение. Карточки комнат, план этажа и хотспоты берут данные из одного реестра остановок.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MengTo/Skills --skill 3d-virtual-tour -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/3d-virtual-tour/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/3d-virtual-tour/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MengTo/Skills --skill 3d-virtual-tour -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/3d-virtual-tour/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MengTo/Skills --skill 3d-virtual-tour -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/3d-virtual-tour/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MengTo/Skills 3d-virtual-tour
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/3d-virtual-tour/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MengTo/Skills --skill 3d-virtual-tour -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/MengTo/Skills --path agent-skills/3d/3d-virtual-tour
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/3d-virtual-tour/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add MengTo/Skills --skill 3d-virtual-tour -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/MengTo/Skills/tree/HEAD/agent-skills/3d/3d-virtual-tour/SKILL.md

## Когда брать
- собрать обход здания по заданному маршруту камеры
- перейти к выбранной комнате без полёта сквозь стены
- дать осмотреть модель и вернуться на то же место тура
- связать карточки комнат и план этажа с одной точкой правды
- подгружать ассеты следующей комнаты заранее

## Примеры запросов агенту
- собери виртуальный тур по этой сцене Three.js: маршрут камеры, список комнат и режим осмотра
- добавь переход из интерьера в орбитальный осмотр без пролёта сквозь крышу
- свяжи хотспоты и план этажа с реестром остановок тура

## Похожие
- [threejs](https://affpapa.org/nevibecode/skills/threejs.md) — скилл · 3400 установок
- [title-sequence-3d](https://affpapa.org/nevibecode/skills/title-sequence-3d.md) — скилл · 1500 установок
- [threejs-geometry](https://affpapa.org/nevibecode/skills/threejs-geometry.md) — скилл · 14600 установок
- [threejs-loaders](https://affpapa.org/nevibecode/skills/threejs-loaders.md) — скилл · 12900 установок
- [threejs-materials-lighting](https://affpapa.org/nevibecode/skills/threejs-materials-lighting.md) — скилл · 5500 установок
- [threejs-webgl](https://affpapa.org/nevibecode/skills/threejs-webgl.md) — скилл · 4600 установок

Из того же набора: [mengto/skills](https://affpapa.org/nevibecode/by/mengto/skills.md) — 148 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md