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

threejs · oakoss — скилл для Claude Code: что делает и как установить

Скилл для Claude Code помогает создавать 3D-сцены на Three.js, подключать WebGPU и React Three Fiber. Помогает настраивать шейдеры, загружать модели и повышать производительность.

MIT 167 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill threejs -a claude-code
Открыть на GitHub

Что делает threejs

Скилл подсказывает, как строить сцены на Three.js, настраивать WebGPU и писать шейдеры на TSL. В нём также есть рекомендации по React Three Fiber, React 19 и интеграции с Next.js, загрузке GLTF-моделей, освещению и анимации.

Материалы охватывают сжатие ассетов, управление детализацией моделей и сокращение вызовов отрисовки. Для WebGPU нужно дождаться renderer.init() до первого рендера; без этого возможна гонка. В React-проектах скилл советует обновлять сцену через useFrame, а не запускать собственный requestAnimationFrame.

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

  • создать 3D-сцену на Three.js
  • настроить рендеринг через WebGPU
  • написать шейдер на TSL
  • загрузить и оптимизировать GLTF-модель
  • связать Three.js с React Three Fiber и Next.js

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

  • Создай сцену на Three.js с освещением и тенями.
  • Настрой WebGPU-рендерер и дождись его инициализации перед первым рендером.
  • Подключи GLTF-модель через GLTFLoader и добавь анимацию с AnimationMixer.

Как установить threejs

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill threejs -a claude-code

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

~/.claude/skills/threejs/SKILL.md

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

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

Вопросы о threejs

Как установить threejs в Claude Code?

Выполните npx skills add oakoss/agent-skills --skill threejs -a claude-code. Файл скилла находится по пути ~/.claude/skills/threejs/SKILL.md.

Что делает скилл threejs?

Он помогает агенту создавать 3D-сцены с Three.js и работать с WebGPU, TSL и React Three Fiber. Также охватывает загрузку моделей, анимацию и оптимизацию ассетов.

Что нужно учесть при настройке WebGPU?

Перед первым рендером вызовите и дождитесь await renderer.init(). Если пропустить этот шаг, возможна гонка.

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

SKILL.md · MIT
---
name: threejs
description: 'Builds 3D web experiences with Three.js, WebGPU rendering, TSL shaders, and React Three Fiber. Covers scene setup, asset optimization, performance tuning, and React 19 integration. Use when creating 3D scenes, setting up WebGPU rendering, writing TSL shaders, optimizing draw calls, or integrating Three.js with React and Next.js.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
  source: 'https://threejs.org/docs'
user-invocable: false
---

# Three.js

## Overview

Guides building high-performance 3D web experiences with Three.js, WebGPU-first rendering, TSL (Three Shader Language), and React Three Fiber. Covers scene architecture, asset compression, draw call budgets, and React 19 / Next.js integration patterns.

**When to use:** Creating 3D scenes, WebGPU rendering setup, TSL shader authoring, asset optimization (Draco/KTX2), React Three Fiber composition, Next.js streaming for 3D content, loading GLTF models, setting up lighting and shadows, animation playback and blending.

**When NOT to use:** 2D canvas animations (use Canvas API), simple SVG graphics, server-side rendering without client hydration, projects targeting pre-2022 hardware exclusively.

## Quick Reference

| Pattern           | API / Approach                                     | Key Points                                             |
| ----------------- | -------------------------------------------------- | ------------------------------------------------------ |
| WebGPU renderer   | `import * as THREE from 'three/webgpu'`            | Must `await renderer.init()` before first render       |
| R3F canvas        | `<Canvas gl={...}>` with Suspense                  | Wrap in `<Suspense>` for streaming support             |
| Frame updates     | `useFrame((state, delta) => ...)`                  | Mutate refs directly; never use `setState`             |
| TSL shaders       | `import { ... } from 'three/tsl'`                  | Node-based; compiles to WGSL or GLSL                   |
| Instancing        | `<instancedMesh>` with matrix updates              | Single draw call for repeated geometry                 |
| Batched mesh      | `BatchedMesh` (r156+)                              | Different geometries sharing one material              |
| Draco compression | `gltf-pipeline -i in.gltf -o out.glb -d`           | Up to 90% geometry size reduction                      |
| KTX2 textures     | Basis Universal via `toktx`                        | Stays compressed in VRAM                               |
| LOD               | `THREE.LOD` with distance thresholds               | Swap detail levels by camera distance                  |
| On-demand render  | `<Canvas frameloop="demand">`                      | Only render when scene state changes                   |
| Cleanup           | `.dispose()` on unmount                            | Geometries, materials, and textures                    |
| Compute shaders   | `Fn(() => {...})().compute(count)`                 | GPU-side physics, particles, flocking                  |
| Lighting          | `DirectionalLight`, `SpotLight`, `HemisphereLight` | Enable `shadowMap` on renderer + `castShadow` on light |
| GLTF loading      | `GLTFLoader` + `DRACOLoader`                       | Draco for geometry compression; traverse for shadows   |
| Animation         | `AnimationMixer` + `clipAction()`                  | Update with `clock.getDelta()` every frame             |
| Crossfade         | `action.fadeOut()` / `action.fadeIn()`             | Weight-based blending between walk/run/idle            |
| Environment maps  | `RGBELoader` + `PMREMGenerator`                    | Set `scene.environment` for PBR reflections            |
| Raycasting        | `Raycaster.setFromCamera(pointer, cam)`            | Mouse/touch picking; use `recursive: true` for GLTF    |
| Morph targets     | `mesh.morphTargetInfluences[index]`                | Facial animation, blend shapes from GLTF               |

## Common Mistakes

| Mistake                                                                   | Correct Pattern                                                                 |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| Allocating `new THREE.Vector3()` or `new THREE.Color()` inside `useFrame` | Pre-allocate outside the loop to avoid GC pressure every frame                  |
| Using `requestAnimationFrame` manually in React projects                  | Use R3F's `useFrame` hook for frame-by-frame updates                            |
| Not awaiting `renderer.init()` for WebGPU                                 | Always `await renderer.init()` before the first render to avoid race conditions |
| Loading assets without `<Suspense>` boundaries                            | Wrap `<Canvas>` in `<Suspense>` to prevent main thread blocking                 |
| Using high-poly models for background or distant elements                 | Use LOD (Level of Detail) or Impostors to reduce draw calls                     |
| Using `setState` inside render loop for animations                        | Mutate refs directly via `useFrame` for frame-by-frame updates                  |
| Speed tied to frame rate (`rotation += 0.01`)                             | Multiply by `delta` for frame-rate-independent motion                           |
| Not using `clock.getDelta()` for `mixer.update()`                         | Always pass delta time to `mixer.update(delta)` for correct animation speed     |
| Forgetting to dispose loaded GLTF models                                  | Traverse and dispose geometries, materials, and textures on removal             |
| Shadow map enabled on renderer but not on the light                       | Set both `renderer.shadowMap.enabled` and `light.castShadow = true`             |
| Large `far/near` ratio on camera                                          | Keep ratio small to avoid z-fighting; set `near` as large as possible           |

## Delegation

- **Asset and scene graph exploration**: Use `Explore` agent
- **Multi-file scene refactoring and optimization passes**: Use `Task` agent
- **3D architecture and rendering pipeline planning**: Use `Plan` agent

## References

- [Scene, lighting, and model loading](references/scene-and-lighting.md)
- [Animation system and blending](references/animation.md)
- [Performance and asset optimization](references/performance.md)
- [WebGPU and TSL shader patterns](references/webgpu-tsl.md)
- [React Three Fiber patterns and Next.js integration](references/r3f-patterns.md)

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →

Сначала — threejs от других авторов.

threejs nexu-io Помогает ассистенту создавать 3D-сцены, настраивать материалы, камеру и пост-обработку на Three.js прямо в браузере. CX Codex +1 3 600установок threejs MengTo Помогает агенту собирать и отлаживать интерактивные 3D-сцены на Three.js: сцена, камера, свет, загрузка glTF, контролы и производительность. CX Codex +1 2 500установок threejs mrgoonie Собирает 3D-сцены, шейдеры и VR-опыты на Three.js. Закрывает задачи с WebGL и WebGPU. CX Codex +1 1 300установок threejs secondsky Скилл threejs для Claude Code с примерами и справочниками по Ten.js: сцены, материалы, свет, шейдеры, загрузка GLTF. Покрывает сборку 3D в браузере. CX Codex +1 501установок threejs benchflow-ai Разбирает граф сцены Three.js, разделяет модели на части и готовит OBJ-файлы или URDF. Экспортирует геометрию и связи между деталями. CX Codex +1 8установок threejs-animation CloudAI-X Скилл threejs-animation для работы с keyframe-анимацией, костями и морф-целями в Three.js. Помогает воспроизводить glTF-анимации, управлять костями скелета, миксировать и кроссфейдить клипы на WebGL и WebGPU. CX Codex +1 27 200установок threejs-fundamentals CloudAI-X Скилл threejs-fundamentals помогает настроить базовую сцену Three.js r186: рендерер, камеры, цикл анимации с THREE.Timer и import map для WebGL или WebGPU с TSL. CX Codex +1 24 100установок threejs-gltf-loading gamedev-skills Скилл threejs-gltf-loading для Claude Code загружает модельные файлы .gltf и .glb в three.js версии r187 и запускает для них анимацию. Агент подключает этот скилл при импорте трёхмерных персонажей или отладке невидимых объектов. CX Codex +1 11 200установок threejs-webgl freshtechbro Скилл threejs-webgl для Claude Code учит агента настраивать сцены Three.js, рендереры WebGL и WebGPU, свет, материалы и загрузку glTF-моделей. Описывает настройку Three.js для 3D-визуализаций и конфигураторов. CX Codex +1 5 300установок threejs-game-ui-designer majidmanzarpour Скилл threejs-game-ui-designer для Claude Code проектирует игровые интерфейсы на Three.js: HUD, меню и экраны паузы и победы. Помогает сохранять читаемость и избегать наложений. CX Codex +1 4 400установок threejs-gameplay-systems majidmanzarpour Скилл threejs-gameplay-systems разворачивает игровой цикл на Three.js, Vite и TypeScript с контролем физики, ввода и камеры. Пригодится при сборке прототипов и настройке гейм-фила. CX Codex +1 4 400установок

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

Весь набор →
motion Скилл обучает ИИ-агента правильно применять библиотеку Motion (framer-motion) в React и Next.js. Помогает настроить жесты, скролл-эффекты и избежать просадок FPS. CX Codex +1 176установок shadcn-ui Учит агента работать с shadcn/ui: добавлять компоненты через CLI, настраивать темы на oklch и собирать формы с проверкой через Zod. CX Codex +1 176установок local-first Скилл local-first помогает решить, нужна ли веб-приложению локальная база с синхронизацией, и выбрать движок и стратегию разрешения конфликтов. CX Codex +1 173установок tanstack-query Помогает агенту писать запросы и мутации на TanStack Query v5, переводить код с v4 и настраивать инвалидацию кэша. CX Codex +1 170установок accessibility Скилл accessibility помогает создавать и проверять интерфейсы по WCAG 2.2 AA: от семантической HTML-разметки до клавиатурной навигации и поддержки скринридеров. CX Codex +1 164установок react-performance Скилл react-performance для Claude Code собирает паттерны оптимизации React и включается автоматически в задачах о скорости приложения. CX Codex +1 163установок design-system Скилл design-system для Claude Code собирает дизайн-систему с токенами, темами и архитектурой компонентов. Задаёт структуру для dark mode, CVA-вариантов и доступности. CX Codex +1 160установок zustand Скилл помогает настроить Zustand v5 в React: от типизированных хранилищ и middleware до SSR, тестов и миграции с Redux или Context. CX Codex +1 158установок

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

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