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

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

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

Что делает 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-code

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

~/.claude/skills/react-three-fiber/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

react-three-fiber freshtechbro Скилл react-three-fiber обучает агента строить декларативные 3D-сцены в React через Three.js, настраивать хуки рендера и загружать модели через Suspense. CX Codex +1 4 300установок react-three-fiber-architect Claude Design Skillstack Субагент react-three-fiber-architect для проектирования 3D-сцен на React Three Fiber: разбирает архитектуру, ищет узкие места рендера и предлагает план оптимизации. CX Codex ★ 1 428звёзд репо threejs-react-three-fiber CloudAI-X Скилл threejs-react-three-fiber для Claude Code помогает собирать сцены three.js в React-компонентах. Он охватывает React Three Fiber, drei, цикл кадров и обработку событий указателя. CX Codex +1 6 800установок react-three-fiber-game официальный OpenAI Скилл react-three-fiber-game помогает собирать 3D-игры и интерактивные сцены прямо в интерфейсе на React с помощью экосистемы pmndrs. CX Codex GP ChatGPT +1 39установок r3f-loaders EnzeD Скилл r3f-loaders помогает загружать и переиспользовать 3D-модели в React Three Fiber. Настраивает хуки, предзагрузку, клонирование объектов и показ заглушек. CX Codex +1 2 100установок r3f-animation zebbern Скилл r3f-animation помогает писать 3D-анимации в React Three Fiber: от циклов useFrame до микширования клипов GLTF и пружин. CX Codex +1 ★ 4 719звёзд репо three-js Mindrally Задаёт правила разработки на Three.js и React Three Fiber: код на TypeScript, очистка ресурсов и оптимизация рендера. CX Codex +1 861установок

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

Весь набор →
directives Скилл directives для Claude Code добавляет в json-render готовые директивы для форматирования, математики, строк и i18n. Подключается в каталог и рендерер одним импортом. CX Codex +1 8 100установок mcp Скилл помогает собирать MCP-серверы с интерактивными json-render UI для Claude, ChatGPT, Cursor и VS Code. CX Codex +1 5 900установок react-native Собирает нативные React Native-интерфейсы из JSON-спецификаций. Задаёт мобильный UI с состоянием, условиями видимости и действиями. CX Codex +1 3 300установок react-pdf Рендерит PDF-документы из JSON-спецификаций через @react-pdf/renderer. Собирает счета, отчёты и формы программно. CX Codex +1 2 400установок remotion-best-practices Скилл remotion-best-practices для Claude Code загружает правила работы с библиотекой Remotion для создания видео на React: от анимаций и секвенцирования до аудио, 3D и переходов. CX Codex +1 1 600установок zustand Интегрирует Zustand в json-render и синхронизирует состояние приложения. Связывает Zustand-хранилища с компонентами, которые рендерит json-render. CX Codex +1 1 900установок remotion Превращает JSON-описания видеотайм-лайна в готовые видеокомпозиции через Remotion. Рендерит видео программно и собирает каталоги клипов из данных. CX Codex +1 1 800установок image Скилл image для Claude Code превращает JSON-спецификации в SVG и PNG через Satori. Создаёт OG-картинки, социальные карточки и изображения по схемам от ИИ. CX Codex +1 1 600установок

Ещё в каталоге

paprika3d (three.js games and 3D pages end to end, for coding agents) Keeno-Corp paprika3d (three.js games and 3D pages end to end, for coding agents) — MCP-сервер для Claude Code и Codex: создаёт, анализирует и тестирует браузерные 3D-игры на three.js. CX Codex +1 ★ 7звёзд репо three.ws 3D Agent Tools nirholas MCP-сервер three.ws 3D Agent Tools с инструментами three.ws: генерация 3D-моделей из текста или картинки, автосвязывание скелета, аватары и рыночные данные. Часть вызовов бесплатна, остальные оплачиваются за вызов. CX Codex +1 ★ 284звёзд репо three.ws AgenC nirholas MCP-сервер three.ws AgenC подключает агента к ончейн-маркетплейсу задач и реестру агентов AgenC на Solana. Помогает находить оплачиваемую работу и проверять профили без приватных ключей. CX Codex +1 ★ 284звёзд репо three.ws Agent Payments nirholas MCP-сервер three.ws Agent Payments проводит платежи к x402-эндпоинтам через сессии с бюджетом и правилами доступа. Агент отправляет запросы, а кошелёк платформы подписывает транзакции. CX Codex +1 ★ 284звёзд репо

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

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