# threejs-world-generation

threejs-world-generation turns a written brief into one continuous Three.js world with terrain, regions, scattered props and a camera flight. Made for cinematic scenes rather than single models.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 78316 repo stars
- Author: calesthio
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/threejs-world-generation/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/threejs-world-generation

## What it does

The skill builds a single connected world from a brief: landscape, named regions, vegetation and a camera path. Everything hangs off one `world_spec` holding world scale, terrain resolution, elevation range and a seed, so a rebuild with the same seed reproduces the scene. Three to seven regions is the recommended count, each with its own silhouette or job in the layout.

Two quality tiers exist. `blockout` means procedural primitives and vertex colors for quick layout checks. `production` expects licensed local GLTF/GLB catalogs with at least eight models across four semantic categories and three PBR terrain layers; without an installed catalog the run stops at the asset gate. `threejs_asset_catalog` puts catalogs under `projects/<id>/assets/3d/catalogs/<catalog-id>/`, and `threejs_world` builds the scene from the spec.

Output stays editable: `world.json`, `world-spec.js`, `world-runtime.js` and `world-report.json`. Composing to video waits until the assets gate passes. Reference-grade frames come from Blender, with FFmpeg packaging the numbered sequence. A lone 3D object or a flat parallax scene is out of scope.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill threejs-world-generation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/threejs-world-generation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/threejs-world-generation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill threejs-world-generation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/threejs-world-generation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill threejs-world-generation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/threejs-world-generation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install calesthio/OpenMontage .agents/skills/threejs-world-generation
```

2. **Manually: put the files in place**
- File: `.github/skills/threejs-world-generation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill threejs-world-generation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/calesthio/OpenMontage --path .agents/skills/threejs-world-generation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/threejs-world-generation/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/threejs-world-generation/SKILL.md

## When to use it
- build terrain, regions and biomes from a written brief
- block out the world layout with primitives before a final render
- check that the camera path clears the terrain without clipping
- rebuild with the same seed and diff the frames
- hand the world to Blender while keeping the spec editable

## Example prompts
- Build a 3D world from this brief: a ridge to the north, forest in the valley, a 60-second camera fly-through.
- Rebuild the scene with the same seed and snapshot frames in `wireframe` mode to hunt for seams between regions.
- Install a model catalog with `threejs_asset_catalog`, then build the world at `production` tier.

## Similar
- [threejs-landscape](https://affpapa.org/en/nevibecode/skills/threejs-landscape.md) — skill · 1600 installs
- [geometry-nodes](https://affpapa.org/en/nevibecode/skills/geometry-nodes.md) — skill · 640 installs
- [procedural-blender-nodes](https://affpapa.org/en/nevibecode/skills/procedural-blender-nodes.md) — skill · ★ 101 repo stars
- [3d-wood-material](https://affpapa.org/en/nevibecode/skills/3d-wood-material.md) — skill · ★ 7995 repo stars
- [blender-nodes](https://affpapa.org/en/nevibecode/rules/blender-nodes.md) — rule · ★ 101 repo stars
- [world-labs-marble](https://affpapa.org/en/nevibecode/skills/world-labs-marble.md) — skill · 136 installs

From the same set: [calesthio/openmontage](https://affpapa.org/en/nevibecode/by/calesthio/openmontage.md) — 101 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
