threejs-skills README

README проекта с github.com/CloudAI-X/threejs-skills. Одним файлом markdown: README.md.

Three.js Skills for Claude Code

Skill files that give Claude Code current, verified knowledge of three.js, so the code it writes runs on the release you actually install.

The skills target three.js r186 ([email protected]), React Three Fiber 9.8 with drei 10.7, and gltf-transform 4.5. Rendering examples use WebGLRenderer, directly or through React Three Fiber; the WebGPU and TSL section in every skill covers WebGPURenderer.

Why

Claude Code knows three.js from its training data, which mixes many releases. A lot changed between r160 and r186: RGBELoader became HDRLoader, Clock gave way to Timer, PostProcessing became RenderPipeline, WebGL 1 support is gone, and the three.js docs now tell LLMs to use WebGPURenderer with TSL for custom shaders and materials. These skills give Claude Code the current API, working examples, and a Common Mistakes list of the outdated patterns models still reach for.

Installation

With the skills CLI:

npx skills add cloudai-x/threejs-skills

Or manually. Claude Code loads skills from ~/.claude/skills/ (all your projects) or .claude/skills/ (one project):

git clone https://github.com/CloudAI-X/threejs-skills.git

# all your projects
mkdir -p ~/.claude/skills && cp -r threejs-skills/skills/* ~/.claude/skills/

# or one project (run from the project root)
mkdir -p .claude/skills && cp -r threejs-skills/skills/* .claude/skills/

Skills Included

Skill Covers
threejs-fundamentals Scene, cameras, renderer setup, animation loop, object hierarchy, transforms
threejs-geometry Built-in shapes, BufferGeometry, merging, instancing, BatchedMesh, points, lines
threejs-materials Material types, PBR, blending, stencil, recompiles, node materials
threejs-lighting Light types and physical units, shadows, HDR environments, light probes
threejs-textures Loading, color spaces, UV channels, texture types, render targets, memory
threejs-animation Keyframes, the animation mixer, skeletal and morph animation, blending
threejs-loaders glTF with Draco, meshopt and KTX2, other formats, HDR, progress, disposal
threejs-shaders ShaderMaterial and RawShaderMaterial, shader chunks, TSL and node materials
threejs-postprocessing EffectComposer, built-in renderer effects, the WebGPU RenderPipeline
threejs-interaction Raycasting, camera controls, transform gizmos, drag and box selection
threejs-performance Measuring frame cost, draw calls, GPU memory, fill rate, compile stalls
threejs-react-three-fiber React Three Fiber 9 and a verified set of drei helpers, on WebGL or WebGPU
threejs-asset-pipeline gltf-transform: Draco, meshopt, KTX2, WebP, and the matching loader setup

How It Works

Claude Code loads a skill when your request matches its description. When you ask it to:

Skill File Structure

Every skill follows the same layout:

---
name: threejs-<topic>
description: "What the skill covers. Use when ..."
---

# Three.js <Topic>

Targets three.js r186. Examples use WebGLRenderer; the WebGPU and TSL section uses WebGPURenderer.

## Quick Start          a complete, runnable example
## <topic sections>     the API with working examples
## WebGPU and TSL       the same topic under WebGPURenderer
## Common Mistakes      outdated or wrong code → the r186 fix, with the reason
## See Also             related skills

Verification

The skills were checked against the published [email protected] package and the official Migration Guide, and against @react-three/[email protected], @react-three/[email protected], @gltf-transform/[email protected] and [email protected] where they apply:

If you find something that is wrong on the current release, please open an issue with the skill name, the line and the three.js version you use.

License

MIT, see LICENSE.

Acknowledgments

threejs-skills (CloudAI-X/threejs-skills)

Ищем в базе…

Что это такое?Набор из 13 файлов скиллов, которые учат Claude Code актуальному API three.js (r186), React Three Fiber 9.8 с drei 10.7 и gltf-transform 4.5, чтобы 3D-код, который он пишет, соответствовал установленным версиям.
Это библиотека, которую я подключаю к проекту?Нет. Это файлы скиллов: Claude Code сам загружает нужный, когда запрос совпадает с описанием скилла, поэтому в ваш код ничего не импортируется.
Как всё настроить?Скопируйте папки скиллов в ~/.claude/skills/, чтобы использовать их во всех проектах, или в .claude/skills/ внутри отдельного проекта. Затем Claude Code сам выбирает подходящий скилл для каждого запроса.
Что нужно помимо скиллов?Claude Code и проект на three.js. Скиллы написаны именно для three.js r186, React Three Fiber 9.8 с drei 10.7 и gltf-transform 4.5.
Есть ли поддержка WebGPU, а не только WebGL?В основном WebGL: примеры рендеринга используют WebGLRenderer, но в каждом скилле также есть раздел про WebGPU и TSL, где описан WebGPURenderer.
Какой скилл срабатывает для какой задачи?Создание сцены использует threejs-fundamentals, освещение и тени используют threejs-lighting, загрузка glTF использует threejs-loaders, а построение сцены с React использует threejs-react-three-fiber.
От чего предупреждают разделы «Частые ошибки»?В них перечислены устаревшие шаблоны, которые модели всё ещё пытаются использовать, например RGBELoader, которого сменил HDRLoader, и Clock, которого уступил место Timer.
Чем помогает скилл по производительности?Измерением затрат на кадр, количества draw calls, памяти GPU, скорости заполнения (fill rate) и простоев из-за компиляции шейдеров в медленной сцене.
Автор
CloudAI-X
Размер
0.2 MB
Звёзды
4.2K
Обновлён
КоммитOct 19
Возраст
9 мес
Коммиты · 90 дней