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

threert-scene-authoring — скилл для Claude Code: сцены ThreeRT

Скилл threert-scene-authoring для Claude Code и Codex помогает создавать сцены ThreeRT по фото или уровню Unreal. Включается при сборке сцены, переносе визуального стиля или поиске причин, почему картинка выглядит плоской.

MIT ★ 657 обновлён 2026-11-16

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

Что делает threert-scene-authoring

Скилл задаёт порядок работы над сценой ThreeRT: от фото и планировки до материалов, света, атмосферы, деталей и постобработки. Для проверки он предлагает рендерить ключевые ракурсы, сравнивать их с референсами и повторять правки; для переноса уровня из Unreal — сверять результат с рендером исходного уровня.

Материалы могут использовать PBR-текстуры и собственные функции на WGSL. Игровые сцены используют TypeScript, а внешние ресурсы берутся из путей репозитория под assets/; Poly Haven загружается командой node tools/fetch-polyhaven.ts. Для рендера и сравнения нужны команды проекта renderer/target/release/threert-render; захват существующего уровня Unreal выполняет bun ue5/capture.ts. Живая сцена должна держать целевые 60 fps.

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

  • собрать сцену ThreeRT по фото
  • перенести визуальный стиль уровня Unreal
  • добавить мокрые поверхности, свет и туман
  • найти причины плоского вида сцены
  • сравнить рендер с референсом по ракурсам

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

  • Создай городскую ночную сцену ThreeRT по этим фотографиям.
  • Перенеси визуальный стиль этого уровня Unreal в ThreeRT и сравни ракурсы.
  • Разбери, почему сцена выглядит плоской, и предложи правки материалов и освещения.

Как установить threert-scene-authoring

1Через Skills CLI (Vercel)

npx skills add meshy-dev/ThreeRT --skill threert-scene-authoring -a claude-code

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

~/.claude/skills/threert-scene-authoring/SKILL.md

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

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

Вопросы о threert-scene-authoring

Как установить threert-scene-authoring в Claude Code?

Выполни npx skills add meshy-dev/ThreeRT --skill threert-scene-authoring -a claude-code. Файл скилла находится по пути ~/.claude/skills/threert-scene-authoring/SKILL.md.

Что делает threert-scene-authoring?

Помогает создавать и улучшать сцены ThreeRT по фото или уровню Unreal. Описывает работу с материалами, освещением, атмосферой и проверкой рендера.

Как скилл помогает перенести уровень из Unreal?

Он предлагает захватить исходный уровень с фиксированных камер через MRQ, перенести генератор контента и сравнивать результат по ракурсам. Для захвата используется bun ue5/capture.ts.

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

SKILL.md · MIT
---
name: threert-scene-authoring
description: Author high-fidelity ThreeRT scenes and games (Three-like DSL in packages/scene, gameplay in packages/gameplay) that match photo references or an existing Unreal level — street/city/night/interior environments, PBR materials and WGSL material functions, wet surfaces, signage, lighting, fog, props, post grade — and verify them with the native renderer, the live viewport and UE5 ground truth. Use when building or upgrading a scene's visual quality, porting a level or look from Unreal, or reviewing why a scene looks flat/plain.
---

# ThreeRT scene authoring

Detail comes from **systems, not hand-placed meshes**: a material system that weathers every surface the same way,
procedural detail where geometry would be too expensive (windows, puddles, grime, LED pixels), many small coloured
lights, atmosphere, and clutter at human scale. The UE 5.8 Kabukichō session (docs/PARITY.md) got its richness this
way; every one of those techniques exists in our DSL and renders natively in real time.

## Workflow (follow in order; do not skip the review loop)

1. **References first.** Collect 3–6 photos of the target (keep CC-BY-SA / unlicensed ones out of git). Write down,
   per photo: palette (sign colours, light temperatures), materials (ground, facades, shutters), light sources and
   their colour spill, atmosphere (haze, wetness), clutter at eye level, and the camera (height, focal length).
2. **Blockout + camera.** Lay out the space at real scale (metres; street widths, 3.0–3.5 m floors, 2.2 m doors).
   Fix 2–4 hero viewpoints at eye height (1.6–1.7 m, 35–55° vertical fov) before adding detail.
3. **Material system.** Start from the standard material library (`SurfaceMaterial` for weathering on anything:
   world mapping, wet, puddles, grime, lit windows; `WetGroundMaterial`, `FacadeMaterial` with lit windows,
   `TriplanarMaterial`, `PaintMaterial`, `NeonSignMaterial`, `LedScreenMaterial`, `LightPanelMaterial`,
   `ShopWindowMaterial`, `RoadMarkingMaterial`): scanned PBR maps plus parameters, world-mapped where it matters,
   tints to vary one texture across buildings ([docs/MATERIAL_FUNCTIONS.md § Standard library](../../../docs/MATERIAL_FUNCTIONS.md)).
   See [materials](references/materials.md). A look the library doesn't cover is a `MaterialFunction` of its own,
   a WGSL body with named params and texture slots, like a UE material graph or Custom node; the library's functions
   are worked examples. `MeshStandardMaterial` itself is plain three.js: weathering, windows and animated emission
   are library materials, not material fields.
4. **Lighting.** Emissive surfaces are the main light at night (signs 300–700 nits, light boxes, shopfronts), plus a
   coloured point/spot light per shop/sign cluster for the spill pools (dozens–hundreds are fine: many-light sampling).
   Manual exposure. See [lighting & atmosphere](references/lighting-atmosphere.md).
5. **Atmosphere.** Height fog with volumetric scattering (halos, depth), a sky that reads behind silhouettes
   (`SkyGradient` with light-pollution glow and clouds at night), rain (`scene.wetness`, `scene.rain`).
6. **Life.** Emissive animation on a few signs (flicker / blink / marquee pan / LED screens), people, vehicles. Anything
   UE would do in an actor's Tick (neon groups flickering as they switch, rain / wetness ramps, fog moods, pulsing
   lights) goes in the game's `frame(f)` script. It runs on the render node every frame; handlers only commit the
   targets. See [frame scripts](references/frame-scripts.md).
7. **Clutter pass.** Poly Haven CC0 props at street level: AC units on facades, crates, bags, bins, chairs, barriers,
   hydrants, manholes; cables and poles overhead. See [assets](references/assets.md).
8. **Post grade.** Bloom threshold/size, slight fringe and grain, white balance, saturation/contrast via
   `render.overrides.post` (UE-equivalent fields).
9. **Review loop** — render every hero view, look at them next to the references, list the 3 biggest differences,
   fix, repeat (≥ 3 rounds). Check close-ups (window, ground, sign) not just the wide shot.
   See [review & performance](references/review-and-performance.md).
10. **Performance pass.** Live viewport ≥ 60 fps target (bench-live). The viewer and playground hold 60 fps with
    dynamic resolution (render scale 50–100 %, TSR-style upsampling), so measure the cost at `--scale 1` and trade
    features per the cost table before relying on the scale.

**Porting a look from an existing Unreal level?** Use the ground-truth loop in [ue-port](references/ue-port.md):
dump the level, capture it from fixed cameras with MRQ, port the content generator 1:1 (`PyRandom`, material
functions), and converge per view with `compare` / `compare-hdr`. Aim at UE's render of the level, never at a UE
render of your own approximation.

## Non-negotiables

- Physical units: metres, nits (emissive, sky, fog colour × intensity), candela (point/spot), lux (directional).
- No stretched textures: world mapping for architecture/ground, mesh UVs only for authored assets/signs.
- Every large flat surface gets at least two of: texture detail, grime, wetness, windows, decals/props.
- Light colour variety: warm 2700–3500 K interiors, cool 5000–6500 K fluorescents/LED, saturated neon accents.
- Wet night street = dark diffuse + glossy damp ground + mirror puddles that reflect the signs.
- Deterministic content from a seed (gameplay rooms replay setup); no Math.random in setup.
- Keep games self-contained TS files; external assets only via repo paths under `assets/` (fetched, not committed).

## Commands

```bash
node tools/fetch-polyhaven.ts --set kabukicho            # CC0 textures + models -> assets/polyhaven/
node tools/build-scenes.ts <id>                          # scenes/*.ts + games -> out/bundles/<id>.js
renderer/target/release/threert-render render out/bundles/x.js -o /tmp/x.png --spp 128 [--camera '{"position":[..],"target":[..],"fov":55}']
renderer/target/release/threert-render compare ref.png /tmp/x.png   # ΔE / PSNR / SSIM
node tools/bench-live.ts --scenes x --frames 1,16,256 [--scale 0.6]   # real-time cost + convergence
node tools/bundle-game.ts games/x/x.game.ts && renderer/target/release/threert-render play out/bundles/x.js   # game in the node runtime
bun ue5/capture.ts <scratch>.uproject job.json           # UE ground truth of an existing level (MRQ stills)
renderer/target/release/threert-render compare-hdr ue.exr ours.raw <ev> --heat heat.png   # radiometric parity
```

© meshy-dev · MIT · meshy-dev/ThreeRT

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
level-design gamedev-skills Скилл level-design для Claude Code помогает проектировать игровые уровни, проверяя их проходимость и темп. CX Codex +1 14 800установок performance-optimization gamedev-skills Скилл performance-optimization для Claude Code находит причины низкой частоты кадров и рывков в Godot, Unity, Unreal и Roblox. Подключается для профилирования игры и выбора самой затратной проблемы. CX Codex +1 14 200установок game-developer https://github.com/Jeffallan Скилл game-developer для разработки игр в Unity и Unreal Engine. Помогает строить системы игровой логики, настраивать физику, многопользовательские сети, шейдеры и оптимизировать производительность до 60+ FPS. CX Codex +1 7 100установок substance-3d-texturing freshtechbro Скилл substance-3d-texturing для работы с Substance 3D Painter: помогает писать PBR-материалы, выгружать текстуры под Three.js, Babylon.js, Unity и Unreal и автоматизировать экспорт через Python API. CX Codex +1 2 700установок blender-export RobLe3 Скилл blender-export для Claude Code и пяти других платформ, который экспортирует сцены Blender в glTF/GLB, FBX, OBJ, USD и STL с нужными настройками под каждую цель. CX Codex +1 2 600установок mashup-mods rehan-remade Скилл mashup-mods для создания кросс-игровых модов: от Minecraft внутри Skyrim до скейтбординга в MW2. Охватывает passthrough-моды, портирование контента и встраивание одной игры в другую. CX Codex +1 2 000установок

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

authoring-claude-md sammcj Скилл authoring-claude-md помогает создавать и поддерживать CLAUDE.md и файлы правил в .claude/rules/, которые хранят контекст проекта — архитектурные решения, нестандартные соглашения и решения проблем, с которыми ИИ встречается регулярно. CX Codex +1 ★ 173звёзд репо plugin-authoring ivan-magda Скилл plugin-authoring помогает создавать, проверять и отлаживать плагины Claude Code. Он пригодится при работе с манифестами, командами, скиллами, субагентами и хуками. CX Codex +1 ★ 71звёзд репо agent-qa-authoring vostride Скилл agent-qa-authoring помогает создавать и проверять тесты, наборы тестов и хуки agent-qa. Он пригодится, когда агент должен менять конфигурацию и запускать тесты по правилам проекта. CX Codex +1 ★ 819звёзд репо homebrew-cask-authoring connorads Скилл homebrew-cask-authoring помогает писать, проверять и обновлять формулы Homebrew Cask для macOS и Linux с учётом критериев приёмки репозитория. CX Codex +1 128установок

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

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