К основному содержанию
скилл CX Codex

exploded-view — скилл для Claude Code: 3D-разборки и установка

Скилл exploded-view для Claude Code собирает интерактивные 3D-разборки машин и продуктов в three.js. Двигает детали по этапам, показывает внутренности корпуса и подписывает части модели.

MIT ★ 448 обновлён 2026-11-09

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Moh4696/open-3d-skills
/plugin install open-3d-skills@open-3d-skills
Открыть на GitHub

Что делает exploded-view

Скилл помогает собрать в браузере интерактивную 3D-модель, которая раскрывает устройство машины или продукта. Детали раздвигаются по очереди с помощью ползунка или прокрутки; корпус можно сделать прозрачным или показать в разрезе. Подписи соединены с деталями линиями, а части модели выбираются наведением или кликом.

Внутри есть скрипт assets/explode.js с инструментами для разборки, подписей, рентгеновского режима, сечения и выбора деталей, а также пример страницы с мотором. Модель можно собрать кодом или загрузить из GLB. Нужен three.js; в демонстрационной карте импортов используется r169. Для GLB меши нужно сгруппировать по именам узлов, а у каждой детали должны быть собственные материалы.

Какие задачи решает

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

Примеры запросов агенту

  • Собери интерактивную разборку двигателя на three.js с ползунком этапов.
  • Добавь к модели из GLB прозрачный корпус, сечение и подписи деталей.
  • Сделай 3D-объяснение устройства камеры: разнеси детали по этапам и добавь выбор кликом.

Как установить exploded-view

1Через маркетплейс плагинов

/plugin marketplace add Moh4696/open-3d-skills
/plugin install open-3d-skills@open-3d-skills

Команда ставит плагин open-3d-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add Moh4696/open-3d-skills --skill exploded-view -a claude-code

3Вручную: положить файлы

~/.claude/skills/exploded-view/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/exploded-view/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об exploded-view

Как установить exploded-view в Claude Code?

Добавь маркетплейс командой /plugin marketplace add Moh4696/open-3d-skills, затем установи скилл: /plugin install open-3d-skills@open-3d-skills.

Что делает exploded-view?

Помогает создавать интерактивные 3D-объяснения устройства машин и продуктов: раздвигать детали по этапам, открывать корпус и добавлять подписи с выбором деталей.

Что нужно для работы exploded-view?

Нужен three.js. Модель можно создать кодом или загрузить из GLB; для файла GLB меши группируют по именам узлов.

Исходный текст

SKILL.md · MIT
---
name: exploded-view
description: Builds interactive 3D explainers of how a machine or product works, in three.js, with a staged exploded view driven by a slider or scroll, x-ray shells, a section cut through the casing, labels pinned to parts with leader lines that never cover the model, and hover or click to pick parts. Works on code-built models and loaded GLB files. Use for "show how it works", teardown or cutaway pages, product anatomy, engine, motor, gearbox, camera, phone or vehicle internals, technical education pages, or turning a 2D cutaway drawing into an interactive 3D one.
---

# Exploded view

People understand a machine when they see it come apart in the order it was put together, with each part named where it sits. This skill does that in the browser: parts slide apart along sensible lines, outer shells go ghostly or get cut open, and labels follow their parts without ever sitting on top of the model.

## Tools

| File | What it does |
| --- | --- |
| `assets/explode.js` | `Exploder` (staged explode), `Labels` (pinned labels with leader lines), `Xray`, `Section` (clipping plane through shells), `Picker` (hover and click) |
| `assets/demo/` | A complete page: a code-built induction motor taken apart, with sliders, x-ray and section. `?explode=1`, `?cut=1`, `?xray=1` set the state |

Requires three.js (r169 in the demo's import map). Build the model with `threejs-scene` techniques or load a GLB.

## Build

### 1. Structure the model as parts

The unit of an exploded view is a part: a `Group` that moves as one. Make every part a direct child of one assembly group, and give each part **its own materials** (x-ray and hover change materials; shared ones would change every part at once).

For a GLB, regroup on load: walk the scene, and parent meshes into named part groups by their node names. Preserve world transforms when re-parenting (`group.attach(mesh)`).

### 2. Decide how each part moves

Per-part settings live on `userData`:

```js
housing.userData = { shell: true, stage: 0, explode: [0, 0.32, 0] };   // lifts off first
rotor.userData   = { stage: 2, explode: [0.42, 0, 0] };                // slides out along the shaft last
```

- `explode: [x, y, z]` is the offset at full explosion. Without it, the part moves away from the assembly centre (along `axis` if you pass one to `Exploder`), scaled by its distance.
- `stage` orders the motion: stage 0 moves first, and each later stage starts when the previous is half done. Take things apart the way a mechanic would: covers and shells, then fasteners and caps, then the inner parts.
- `shell: true` marks casings for x-ray and section cuts.

Lay out the exploded state like a technical illustration: one main axis (the shaft, the stack direction), parts spaced so each is clear of its neighbours, large shells moved off-axis (up) so the core stays visible.

```js
const ex = new Exploder(assembly);
ex.set(t);   // 0 assembled .. 1 exploded; ease toward a target each frame for slider input
```

### 3. Label the parts

```js
const labels = new Labels(document.querySelector(".labels"), camera, canvas);
labels.add(rotor, "Rotor", { note: "turns in the magnetic field", anchor: [0.03, 0.07, 0] });
// every frame, after renderer.render():
labels.update();
```

Labels sit in two columns at the screen edges, keep their anchors' vertical order and push apart when they would overlap; a leader line runs from each label to its anchor point. They follow the part as it explodes and hide when the part is hidden or behind the camera. Anchor each label on a point of the part that stays visible from the main view (the top edge, the end of a shaft), in the part's local coordinates.

Style `.label`, `.label b`, `.label span`, `.leader` and their `.focus` variants in CSS. On narrow phones, hide the labels and show the hovered or tapped part's name in one caption instead: two columns of labels do not fit beside a model on a 390 px screen.

### 4. X-ray and section

```js
const xray = new Xray(assembly);      xray.set(true);          // shells to 14% opacity, no depth write
renderer.localClippingEnabled = true;
const section = new Section(assembly, [0, 0, -1]);  section.set(0);   // cut the shells' front half away; null = off
```

The section plane cuts only shells, so the interior stays whole inside an opened casing, the way a cutaway drawing shows it. Cut materials are made double-sided so the inside of the casing reads.

### 5. Picking

```js
new Picker(canvas, camera, assembly.children, {
  onHover: (part) => highlightLabelOf(part),
  onPick: (part) => focusOn(part),
});
```

Hover tints the part's emissive slightly and switches the pointer cursor. A click can isolate the part, fly the camera to it, or open its description.

## Camera and framing

- Fit the camera to the assembly for the current screen shape, and let the distance follow the explode amount (the demo's `autoDistance`): close when assembled, pulled back when exploded. Stop doing it once the visitor zooms or orbits.
- Raise `OrbitControls.maxDistance` above the fitted distance, or the controls silently clamp it and phones see a crop.
- A three-quarter view slightly from above (the demo uses direction 0.42, 0.34, 1) shows ends and sides of a cylindrical machine at once.

## Driving it from scroll

Map scroll progress to `ex.set()` through keys with holds, as `scroll-film` does for frames: assembled while the intro reads, explode stage by stage with a caption per stage, hold fully exploded, then section cut. The model is real-time, so the visitor can stop and orbit at any point.

## Rendering

Product-shot lighting suits explainers better than a sky: a `RoomEnvironment` PMREM for reflections, one soft key light with shadows onto a `ShadowMaterial` floor, ACES tone mapping, and the page's own background colour as the clear colour (an opaque canvas defaults to black). Metals read through roughness 0.3 to 0.45 and metalness 0.8 to 0.95; painted parts through a clearcoat.

## Accuracy

If the subject is a real product, use real part names and the real assembly order, and say in the page copy which internal details are illustrative. An explainer that is wrong teaches the wrong thing confidently.

© exploraX · MIT · Moh4696/open-3d-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
scan-to-threejs wesbos Скилл scan-to-threejs для Claude Code собирает редактируемые комнаты Three.js из сканов iPhone, RoomPlan JSON и GLB/glTF. Модель сверяется с фото. CX Codex +1 ★ 3 114звёзд репо fal-regenerate-3d fal-ai-community Скилл fal-regenerate-3d для Claude Code и Codex автоматизирует сборку 3D-экрана выбора персонажей на Three.js с моделями через fal.ai. Разворачивает статическую страницу с GLB-моделями, PBR-полами и видеофонами. CX Codex +1 442установок 3DAssets.dev 3dassets-dev MCP-сервер 3DAssets.dev находит и скачивает бесплатные 3D-модели GLB с лицензией CC0 для three.js или Godot прямо через агента. Пригодится при сборке сцен без ручного поиска файлов. CX Codex +1 ★ 8звёзд репо threejs-3d-generator majidmanzarpour Скилл threejs-3d-generator генерирует 3D-модели для игр на Three.js через Tripo API: из текста или картинки, с текстурами, ригом и анимациями, и складывает готовые GLB или FBX в проект. CX Codex +1 4 400установок meshyai OpusGameLabs Генерирует 3D-модели из текста или картинки через Meshy AI, ставит скелет на гуманоидов и добавляет анимации ходьбы и бега для Three.js. CX Codex +1 1 000установок add-3d-assets OpusGameLabs Скилл add-3d-assets для Claude Code и Codex. Заменяет примитивы вроде BoxGeometry на GLB-модели: персонажи с анимацией, дома, деревья, бочки. Генерирует через Meshy AI или берёт из бесплатных библиотек. CX Codex +1 1 000установок

Из того же набора9

site-check Скилл site-check для Claude Code проверяет 3D- и анимированные веб-страницы в браузерах Chromium и WebKit. Запускается после изменений, чтобы найти ошибки, проблемы мобильной вёрстки и просадки производительности до публикации. CX Codex +1 ★ 448звёзд репо motion-assets Скилл motion-assets для Claude Code планирует и создаёт изображения и видеоклипы для анимированных сайтов. Он включается при запросах сгенерировать графику, зациклить фон или анимировать изображение. CX Codex +1 ★ 448звёзд репо cursor-rig Скилл cursor-rig для Claude Code собирает из иллюстрации портрет, который поворачивает голову вслед за курсором. Он включается для анимированного героя страницы без 3D-модели и отслеживания лица. CX Codex +1 ★ 448звёзд репо alpha-cutout Скилл alpha-cutout для Claude Code удаляет фон у видеоклипа и готовит прозрачную анимацию для веб-страницы. Запускается по просьбе убрать фон или добавить видео с альфа-каналом поверх контента. CX Codex +1 ★ 448звёзд репо frame-capture Скилл frame-capture для Claude Code записывает веб-страницы в MP4 с покадровым управлением временем. Запускается для записи анимаций и прокрутки или сравнения двух клипов. CX Codex +1 ★ 448звёзд репо scroll-film Скилл scroll-film для Claude Code собирает кинематографичную анимацию, привязанную к прокрутке страницы. Помогает соединить видеоклипы, настроить паузы для подписей и загрузку кадров. CX Codex +1 ★ 448звёзд репо threejs-scene Скилл threejs-scene для Claude Code создаёт интерактивные 3D-сцены на three.js из кода, без файлов моделей. Включается для 3D-сайтов, WebGL-заставок и сцен реальных объектов. CX Codex +1 ★ 448звёзд репо open-3d-skills Плагин open-3d-skills для Claude Code помогает собирать 3D-сцены и анимированные сайты. Восемь скиллов охватывают сцены на three.js, видео с прокруткой и проверку в браузерах. CX Codex ★ 448звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой