# improve-threejs

Проверяет приложения Three.js и React Three Fiber на проблемы кадрового цикла, памяти GPU и рендеринга. Нужен при аудите сцены или поиске видимых дефектов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 316 установок · ★ 15049
- Автор: millionco
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/millionco/react-doctor/tree/HEAD/skills/improve-threejs/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/improve-threejs

## Что делает

Скилл сканирует код Three.js и React Three Fiber через React Doctor, затем сверяет результаты с особенностями кадрового цикла. Он ищет выделения памяти в `useFrame`, вызовы `setState` на каждом кадре, пересоздание объектов сцены и ресурсы GPU без `dispose()`.

Проверка ранжирует находки по месту выполнения: код в `useFrame` и `requestAnimationFrame` запускается 60 раз в секунду. Это повод сначала проверить горячие пути, а не правки интерфейса вне `Canvas`.

Отдельно скилл проводит визуальный аудит: смотрит на z-fighting, тени, цветовое пространство, текстуры, камеру и изменение размера окна. При доступном браузере он опирается на кадры сцены; без браузера помечает выводы как сделанные по исходному коду.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add millionco/react-doctor --skill improve-threejs -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add millionco/react-doctor --skill improve-threejs -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add millionco/react-doctor --skill improve-threejs -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install millionco/react-doctor improve-threejs
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add millionco/react-doctor --skill improve-threejs -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/millionco/react-doctor --path skills/improve-threejs
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add millionco/react-doctor --skill improve-threejs -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/millionco/react-doctor/tree/HEAD/skills/improve-threejs/SKILL.md

## Когда брать
- найти выделения объектов в `useFrame`
- освободить геометрии, материалы и текстуры GPU
- убрать пересоздание объектов сцены при рендере
- проверить z-fighting и дефекты теней
- исправить обработку изменения размера и DPR

## Примеры запросов агенту
- \`/improve-threejs` проверь сцену React Three Fiber на утечки GPU и работу `useFrame`.
- Проверь Three.js-приложение: найди проблемы цветового пространства и теней.
- Просканируй R3F-сцену и проверь, не пересоздаются ли геометрии при рендере.

## Похожие
- [threejs-animation](https://affpapa.org/nevibecode/skills/iart-ai-threejs-animation.md) — скилл · 1400 установок
- [threejs-react-three-fiber](https://affpapa.org/nevibecode/skills/threejs-react-three-fiber.md) — скилл · 1300 установок
- [threejs-r3f](https://affpapa.org/nevibecode/skills/threejs-r3f.md) — скилл · 1000 установок
- [react-three-fiber](https://affpapa.org/nevibecode/skills/react-three-fiber.md) — скилл · 3800 установок
- [r3f-materials](https://affpapa.org/nevibecode/skills/r3f-materials.md) — скилл · 1900 установок
- [threejs-fundamentals](https://affpapa.org/nevibecode/skills/threejs-fundamentals.md) — скилл · 17400 установок

Из того же набора: [millionco/react-doctor](https://affpapa.org/nevibecode/by/millionco/react-doctor.md) — 3 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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