react-three-fiber · vercel-labs — скилл для Claude Code: что делает, установка
Помогает агенту описывать 3D-сцены для json-render JSON-спекой и рендерить их через React Three Fiber: меши, свет, модели GLTF, окружение.
Apache-2.0 2 400 установок ★ 19 802 обновлён 2026-10-24
npx skills add vercel-labs/json-render --skill react-three-fiber -a claude-codeЧто делает react-three-fiber
Скилл помогает агенту работать с @json-render/react-three-fiber, рендерером React Three Fiber для json-render. Сцена описывается плоской JSON-спекой: корень в root и словарь elements, где у каждого элемента есть type, props и children. Внутри 19 готовых 3D-компонентов: семь примитивов (Box, Sphere, Capsule и другие), четыре источника света, Group, Model для GLTF/GLB, Environment, Fog, GridHelper, Text3D, PerspectiveCamera и OrbitControls.
Точек входа две. @json-render/react-three-fiber/catalog отдаёт threeComponentDefinitions: схемы без зависимости от R3F, поэтому их можно импортировать на сервере. Основной пакет даёт threeComponents, ThreeRenderer и ThreeCanvas. Сначала выбираете нужные компоненты для defineCatalog, потом такие же реализации для defineRegistry. Для своих компонентов пригодятся vector3Schema и materialSchema.
Заранее нужны peer-зависимости: @react-three/fiber >= 8.0.0, @react-three/drei >= 9.0.0, three >= 0.160.0 и zod ^4.0.0. Версия React тоже важна: нужен react ^19.0.0, на старом React сначала придётся обновиться.
Какие задачи решает
- собрать 3D-сцену из JSON-спеки без ручного JSX
- добавить на сцену куб или сферу с заданным цветом, металличностью и шероховатостью
- загрузить модель GLTF/GLB и осветить её направленным светом
- настроить окружение сцены: HDRI, туман, сетка-ориентир
- описать собственный 3D-компонент через Zod-схемы
materialSchemaиtransformProps
Примеры запросов агенту
- Собери через react-three-fiber сцену из JSON-спеки: синий куб,
AmbientLightиOrbitControls - Выведи спеку через
ThreeCanvasс тенями и камерой в позиции [5, 5, 5] - Подключи
threeComponentDefinitionsв каталог json-render и зарегистрируйSphereиDirectionalLight
Как установить react-three-fiber
1Через Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill react-three-fiber -a claude-code2Вручную: положить файлы
~/.claude/skills/react-three-fiber/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/react-three-fiber/
1Через Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill react-three-fiber -a codex2Вручную: положить файлы
.agents/skills/react-three-fiber/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill react-three-fiber -a cursor2Вручную: положить файлы
.cursor/skills/react-three-fiber/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vercel-labs/json-render skills/react-three-fiber2Вручную: положить файлы
.github/skills/react-three-fiber/SKILL.md1Через Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill react-three-fiber -a gemini-cli2Командой платформы
gemini skills install https://github.com/vercel-labs/json-render --path skills/react-three-fiberВручную: положить файлы
.devin/skills/react-three-fiber/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vercel-labs/json-render --skill react-three-fiber -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о react-three-fiber
Как установить react-three-fiber в Claude Code?
Выполните npx skills add vercel-labs/json-render --skill react-three-fiber -a claude-code. Скилл окажется в ~/.claude/skills/react-three-fiber/SKILL.md.
Что делает react-three-fiber?
Подсказывает агенту, как собирать 3D-сцены для json-render из JSON-спеки: какие из 19 компонентов выбрать, как собрать каталог и реестр и как вывести результат через ThreeCanvas или ThreeRenderer.
Какие зависимости нужны для react-three-fiber?
Peer-зависимости: @react-three/fiber >= 8.0.0, @react-three/drei >= 9.0.0, three >= 0.160.0, react ^19.0.0 и zod ^4.0.0.
Исходный текст
SKILL.md · Apache-2.0
---
name: react-three-fiber
description: React Three Fiber 3D renderer for json-render. Use when working with @json-render/react-three-fiber, building 3D scenes from JSON specs, rendering meshes/lights/models/environments, or integrating Three.js with json-render catalogs.
---
# @json-render/react-three-fiber
React Three Fiber renderer for json-render. 19 built-in 3D components.
## Two Entry Points
| Entry Point | Exports | Use For |
|-------------|---------|---------|
| `@json-render/react-three-fiber/catalog` | `threeComponentDefinitions` | Catalog schemas (no R3F dependency, safe for server) |
| `@json-render/react-three-fiber` | `threeComponents`, `ThreeRenderer`, `ThreeCanvas`, schemas | R3F implementations and renderer |
## Usage Pattern
Pick the 3D components you need from the standard definitions:
```typescript
import { defineCatalog } from "@json-render/core";
import { schema } from "@json-render/react/schema";
import { threeComponentDefinitions } from "@json-render/react-three-fiber/catalog";
import { defineRegistry } from "@json-render/react";
import { threeComponents, ThreeCanvas } from "@json-render/react-three-fiber";
// Catalog: pick definitions
const catalog = defineCatalog(schema, {
components: {
Box: threeComponentDefinitions.Box,
Sphere: threeComponentDefinitions.Sphere,
AmbientLight: threeComponentDefinitions.AmbientLight,
DirectionalLight: threeComponentDefinitions.DirectionalLight,
OrbitControls: threeComponentDefinitions.OrbitControls,
},
actions: {},
});
// Registry: pick matching implementations
const { registry } = defineRegistry(catalog, {
components: {
Box: threeComponents.Box,
Sphere: threeComponents.Sphere,
AmbientLight: threeComponents.AmbientLight,
DirectionalLight: threeComponents.DirectionalLight,
OrbitControls: threeComponents.OrbitControls,
},
});
```
## Rendering
### ThreeCanvas (convenience wrapper)
```tsx
<ThreeCanvas
spec={spec}
registry={registry}
shadows
camera={{ position: [5, 5, 5], fov: 50 }}
style={{ width: "100%", height: "100vh" }}
/>
```
### Manual Canvas setup
```tsx
import { Canvas } from "@react-three/fiber";
import { ThreeRenderer } from "@json-render/react-three-fiber";
<Canvas shadows>
<ThreeRenderer spec={spec} registry={registry}>
{/* Additional R3F elements */}
</ThreeRenderer>
</Canvas>
```
## Available Components (19)
### Primitives (7)
- `Box` -- width, height, depth, material
- `Sphere` -- radius, widthSegments, heightSegments, material
- `Cylinder` -- radiusTop, radiusBottom, height, material
- `Cone` -- radius, height, material
- `Torus` -- radius, tube, material
- `Plane` -- width, height, material
- `Capsule` -- radius, length, material
All primitives share: `position`, `rotation`, `scale`, `castShadow`, `receiveShadow`, `material`.
### Lights (4)
- `AmbientLight` -- color, intensity
- `DirectionalLight` -- position, color, intensity, castShadow
- `PointLight` -- position, color, intensity, distance, decay
- `SpotLight` -- position, color, intensity, angle, penumbra
### Other (8)
- `Group` -- container with position/rotation/scale, supports children
- `Model` -- GLTF/GLB loader via url prop
- `Environment` -- HDRI environment map (preset, background, blur, intensity)
- `Fog` -- linear fog (color, near, far)
- `GridHelper` -- reference grid (size, divisions, color)
- `Text3D` -- SDF text (text, fontSize, color, anchorX, anchorY)
- `PerspectiveCamera` -- camera (position, fov, near, far, makeDefault)
- `OrbitControls` -- orbit controls (enableDamping, enableZoom, autoRotate)
## Shared Schemas
Reusable Zod schemas for custom 3D catalog definitions:
```typescript
import { vector3Schema, materialSchema, transformProps, shadowProps } from "@json-render/react-three-fiber";
import { z } from "zod";
// Custom 3D component
const myComponentDef = {
props: z.object({
...transformProps,
...shadowProps,
material: materialSchema.nullable(),
myCustomProp: z.string(),
}),
description: "My custom 3D component",
};
```
## Material Schema
```typescript
materialSchema = z.object({
color: z.string().nullable(), // default "#ffffff"
metalness: z.number().nullable(), // default 0
roughness: z.number().nullable(), // default 1
emissive: z.string().nullable(), // default "#000000"
emissiveIntensity: z.number().nullable(), // default 1
opacity: z.number().nullable(), // default 1
transparent: z.boolean().nullable(), // default false
wireframe: z.boolean().nullable(), // default false
});
```
## Spec Format
3D specs use the standard json-render flat element format:
```json
{
"root": "scene",
"elements": {
"scene": {
"type": "Group",
"props": { "position": [0, 0, 0] },
"children": ["light", "box"]
},
"light": {
"type": "AmbientLight",
"props": { "intensity": 0.5 },
"children": []
},
"box": {
"type": "Box",
"props": {
"position": [0, 0.5, 0],
"material": { "color": "#4488ff", "metalness": 0.3, "roughness": 0.7 }
},
"children": []
}
}
}
```
## Dependencies
Peer dependencies required:
- `@react-three/fiber` >= 8.0.0
- `@react-three/drei` >= 9.0.0
- `three` >= 0.160.0
- `react` ^19.0.0
- `zod` ^4.0.0
© vercel-labs · Apache-2.0 · vercel-labs/json-render
Похожие скиллы
Все скиллы по теме «Фронтенд и UI» →Сначала — react-three-fiber от других авторов.