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

three — скилл для Claude Code: Three.js-сцены в HyperFrames

Держит Three.js-сцену в HyperFrames синхронной со временем ролика: адаптер шлёт hf-seek, а сцена рисует запрошенный кадр.

Apache-2.0 209 установок ★ 484 обновлён 2026-08-15

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

Что делает three

Скилл описывает подключение Three.js к HyperFrames через рантайм-адаптер three. Адаптер не владеет вашей сценой: он публикует время HyperFrames в window.__hfThreeTime и на каждый seek шлёт CustomEvent("hf-seek") с detail.time. Сцену, камеру, рендерер и материалы создавайте синхронно, где это возможно.

Движение считается от времени композиции, а не от системных часов. Для GLTF-клипов в примере вызывается mixer.setTime(time), несколько микшеров получают одно и то же значение. Модели, текстуры и HDRI грузятся до первого seek. Если оставить requestAnimationFrame источником движения, повторный рендер не совпадёт с первым: состояние сцены начнёт зависеть от того, сколько прошло реального времени.

После правок сцены проверка такая: npx hyperframes lint и npx hyperframes validate. В примере размер рендерера прибит к 1920×1080 и setPixelRatio(1), чтобы картинка не зависела от экрана, на котором её смотрят.

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

  • собрать 3D-сцену, которая повторяется кадр в кадр
  • привязать вращение камеры и объектов к времени HyperFrames
  • проиграть GLTF-клип на запрошенном времени через mixer.setTime
  • убрать свободный animation loop из рендера видео
  • прогнать lint и validate после правок сцены

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

  • Сделай Three.js-слой для HyperFrames: вращающийся икосаэдр, рендер строго по времени из hf-seek
  • Переведи анимацию GLTF на mixer.setTime(time) и убери requestAnimationFrame из рендера
  • Прогони npx hyperframes validate после того, как поправишь камеру

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

1Через Skills CLI (Vercel)

npx skills add boraoztunc/skills --skill three -a claude-code

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

~/.claude/skills/three/SKILL.md

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

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

Вопросы о three

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

Выполните npx skills add boraoztunc/skills --skill three -a claude-code. Файл скилла окажется по пути ~/.claude/skills/three/SKILL.md.

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

Описывает шаблоны Three.js и WebGL для HyperFrames: рендер по времени композиции, обработку hf-seek, работу с AnimationMixer и шейдерами.

Почему нельзя рендерить из requestAnimationFrame?

Потому что тогда кадр зависит от прошедшего реального времени, и повторный рендер даст другую картинку. Время берётся из hf-seek, а не из часов.

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

SKILL.md · Apache-2.0
---
name: three
description: Three.js and WebGL adapter patterns for HyperFrames. Use when creating deterministic Three.js scenes, WebGL canvas layers, AnimationMixer timelines, camera motion, shader-driven visuals, or canvas renders that respond to HyperFrames hf-seek events.
---

# Three.js for HyperFrames

HyperFrames supports Three.js through its `three` runtime adapter. The adapter does not own your scene. It publishes HyperFrames time and dispatches a seek event so your composition can render the exact frame.

## Contract

- Create the scene, camera, renderer, materials, and assets synchronously when possible.
- Render from HyperFrames time, not wall-clock time.
- Listen for the `hf-seek` event and render exactly that time.
- Load models, textures, and HDRIs before render-critical seeking. Do not fetch them at seek time.
- Avoid `requestAnimationFrame` or `renderer.setAnimationLoop` as the source of truth for render-critical motion.

The adapter sets `window.__hfThreeTime` and dispatches `new CustomEvent("hf-seek", { detail: { time } })` on each seek.

## Basic Pattern

```html
<canvas id="three-layer"></canvas>
<script type="module">
  import * as THREE from "https://cdn.jsdelivr.net/npm/[email protected]/+esm";

  const canvas = document.getElementById("three-layer");
  const renderer = new THREE.WebGLRenderer({ canvas, alpha: true, antialias: true });
  // Match these to your composition's frame size.
  renderer.setSize(1920, 1080, false);
  renderer.setPixelRatio(1);

  const scene = new THREE.Scene();
  const camera = new THREE.PerspectiveCamera(35, 1920 / 1080, 0.1, 100);
  camera.position.set(0, 0, 6);

  const mesh = new THREE.Mesh(
    new THREE.IcosahedronGeometry(1.4, 4),
    new THREE.MeshStandardMaterial({ color: 0x64d2ff, roughness: 0.38 }),
  );
  scene.add(mesh);
  scene.add(new THREE.HemisphereLight(0xffffff, 0x223344, 2));

  function renderAt(time) {
    mesh.rotation.y = time * 0.7;
    mesh.rotation.x = Math.sin(time * 0.6) * 0.16;
    renderer.render(scene, camera);
  }

  window.addEventListener("hf-seek", (event) => {
    renderAt(event.detail.time);
  });

  renderAt(window.__hfThreeTime || 0);
</script>
```

```css
#three-layer {
  width: 100%;
  height: 100%;
  display: block;
}
```

## AnimationMixer Pattern

For GLTF or authored clip animation, seek the mixer directly:

```js
function renderAt(time) {
  mixer.setTime(time);
  renderer.render(scene, camera);
}
```

If several mixers exist, seek all of them from the same `time`.

## Good Uses

- Deterministic 3D objects, product spins, particles with seeded data, and shader plates.
- Camera moves derived from `time`.
- GLTF animation clips when assets are local and loaded before validation completes.

## Avoid

- Using `Date.now()`, `performance.now()`, or clock deltas to update scene state.
- Leaving render-critical work inside a free-running animation loop.
- Loading remote models or textures at render time.
- Device-pixel-ratio dependent output. Pin renderer size and pixel ratio for video renders.
- Post-processing passes that depend on previous frame history unless you can reconstruct state from time.

## Validation

After editing a Three.js composition:

```bash
npx hyperframes lint
npx hyperframes validate
```

## Credits And References

- HyperFrames adapter source: `packages/core/src/runtime/adapters/three.ts`.
- Three.js `WebGLRenderer` docs: https://threejs.org/docs/pages/WebGLRenderer.html
- Three.js `AnimationMixer.setTime()` docs: https://threejs.org/docs/pages/AnimationMixer.html

© boraoztunc · Apache-2.0 · boraoztunc/skills

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
react-three-fiber freshtechbro Скилл react-three-fiber обучает агента строить декларативные 3D-сцены в React через Three.js, настраивать хуки рендера и загружать модели через Suspense. CX Codex +1 4 300установок three-best-practices three-agent-skills Скилл three-best-practices для Claude Code с правилами оптимизации Three.js. Срабатывает при написании, ревью и отладке кода с 3D-сценами, WebGL/WebGPU, шейдерами и TSL. CX Codex +1 1 700установок three-js sanjeed5 Задаёт стандарты разработки на Three.js: обработка ошибок WebGL, ленивая загрузка ассетов, оптимизация цикла отрисовки. Включается в работу над **/*.{js,jsx} файлами 3D-приложений. CX Codex +1 ★ 3 589звёзд репо react-three-fiber-architect Claude Design Skillstack Субагент react-three-fiber-architect для проектирования 3D-сцен на React Three Fiber: разбирает архитектуру, ищет узкие места рендера и предлагает план оптимизации. CX Codex ★ 1 428звёзд репо 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звёзд репо title-sequence-3d charlie947 Скилл title-sequence-3d для Claude Code собирает кинематографичный 3D-опенер на Three.js в одном HTML-файле. Генерирует яркую заставку с неоновыми вывесками и логотипами для видеоролика или рассылки. CX Codex +1 3 400установок

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

Весь набор →
hyperframes-cli Скилл hyperframes-cli оркестрирует создание HTML-видео через npx hyperframes: от инициализации проекта до визуального аудита и сборки MP4. CX Codex +1 216установок lottie Учит агента встраивать анимации Lottie и dotLottie в HyperFrames так, чтобы таймлайн можно было перемотать на любой кадр. CX Codex +1 212установок waapi Скилл waapi помогает настроить анимации через Web Animations API для детерминированного рендера в HyperFrames без использования сторонних библиотек вроде GSAP. CX Codex +1 211установок contribute-catalog Скилл contribute-catalog для Claude Code и Codex ведёт создание блока или компонента HyperFrames от идеи до PR в публичный каталог. Задачи: caption styles, VFX, переходы и lower thirds. CX Codex +1 211установок typegpu Скилл для создания GPU-композиций с TypeGPU и WebGPU в HyperFrames: фрагментные шейдеры WGSL, вычислительные пайплайны, стеклянные эффекты и частицы на canvas. CX Codex +1 207установок linear-local-first-architecture Скилл linear-local-first-architecture задаёт агенту архитектуру веб-приложения, которое реагирует мгновенно: данные живут в IndexedDB, правки применяются локально, синхронизация идёт фоном. CX Codex +1 201установок conductor-rewrite-performance Скилл conductor-rewrite-performance для Claude Code оптимизирует React-интерфейсы локальных десктопных приложений на Tauri, устраняя каскадные перерендеры и задержки при стриминге сообщений. CX Codex +1 186установок minimal-zine-poster Скилл minimal-zine-poster для Claude Code превращает идею, фразу или фото в промпт для минималистичного журнального постера и генерирует изображение. Создаёт обложки эссе и зинов. CX Codex +1 126установок

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

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