Skip to content
Back to skills

Environment Artist

ASecurity

An environment artist's workflow for ts23d — scenes, streets, yards, dioramas, terrain, foliage and modular kits. Grid-based block-out, kit lists, reuse with ctx.use / defineFamily / definePart, tiling walls at true texture scale, composition and leading lines, breaking repetition with seeds, LOD at scene scale. Use when building a scene asset, a modular kit, terrain, a forest, a street, a level-dressing set or anything that composes many assets.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgorailsaws

Works with

  • cli

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add developerz-ai/ts23d --skill environment-artist --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Environment Artist?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Environment Artist
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/developerz-ai-environment-artist/badge)](https://www.skillsdirectory.com/skills/developerz-ai-environment-artist)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: environment-artist
description: An environment artist's workflow for ts23d — scenes, streets, yards, dioramas, terrain, foliage and modular kits. Grid-based block-out, kit lists, reuse with ctx.use / defineFamily / definePart, tiling walls at true texture scale, composition and leading lines, breaking repetition with seeds, LOD at scene scale. Use when building a scene asset, a modular kit, terrain, a forest, a street, a level-dressing set or anything that composes many assets.
---

# Environment artist

Use with the [author-recipe loop](../author-recipe/SKILL.md) and the playbooks under
[`buildings/`](../../../docs/playbooks/README.md) and [`nature/`](../../../docs/playbooks/README.md).
Definitions: [16-art-as-text](../../../docs/idea/16-art-as-text.md). ts23d ships **assets**, not
levels: a scene here is a GLB the engine places, not a game.

## When
A street, rail yard, plaza, ruin, forest patch, mountain diorama, interior set, or a modular kit
(walls, floors, corners, stairs, trims) meant to snap together in an engine.

## Workflow
| # | Environment stage | ts23d | Exit |
|---|---|---|---|
| 1 | Brief + reference board: era, climate, story, mood; real places for scale | dossier; playbooks (road-kerb, fences-walls, station-platform, terrain, trees) | a paragraph of story + scale references |
| 2 | Block-out on a grid with grey boxes; human scale first (doors 2.0–2.1 m, steps, kerbs) | scene asset with `box` / `mass`; grid constant `G` (e.g. 0.5 m or 1 m, *pick and state it*) | `t3d blueprint`: 1.8 m figure reads right |
| 3 | Kit list: what repeats (wall bay, window, pillar, corner, kerb run) | one `defineAsset` or `definePart` per kit piece; pivots at a corner on the grid | every piece's size is a multiple of `G` |
| 4 | Hero pieces: the 1–3 things the eye lands on | dedicated recipes; `ctx.use(hero, { prefix, at })` | hero reads in `hero.png` |
| 5 | Surfaces at true scale | `tiled` (walls, roofs, decks), `mass` (true-scale masonry courses), `opening` (recessed windows), `facade` + `split` grammar | brick course ≈ 75 mm, no stretched texture |
| 6 | Terrain and nature | `heightfield`/`terrainGrid` + `hydraulicErosion`/`thermalErosion` + `terrainColor`; `tree`/`trees` with species presets (`oak`, `pine`, `birch`, `palm`, `willow`) | slopes read, trees grounded |
| 7 | Set dressing and variation | `ctx.use(asset, { seed })` for unique instances; `ctx.rng.fork('props')`; `place` + `merge` | no visible clones side by side |
| 8 | Story and wear | `grime({ ground, zones })` near ground, drains, traffic; `weathered` strips; moss/dirt nature strips | wear follows water and feet |
| 9 | LOD at scene scale | `ctx.lod` drops whole layers (windows, props) at LOD2; `budget.triangles` for the scene; `sceneBudgetFindings` from three reference cameras | budgets met, silhouette holds, no `T3D_SCENE_BUDGET` |
| 9b | Real places | `bun run data osm --bbox … --name … --out recipes/<name>/data/…` once; `readOsm` → `cityBlock(ctx, OSM.buildings, { walls, roof, glass, ground, road, streets })`; credit `OSM.attribution` in `copyright` | footprint IoU ≥ 0.9, heights ±5 % (tests), ODbL credit in the GLB |
| 9c | Instances | repeated pieces (windows, lamps, trees) as one mesh × N: `toInstancedGlb({ name, base?, sets })` (EXT_mesh_gpu_instancing), `sceneManifest` counts them | validator 0 errors; draws collapse per (asset, LOD) |
| 10 | Present | `t3d hero --az … --el …` (a composed view), `t3d shot`, `t3d critique` | scores ≥ 8 |

## Vocabulary → measurable
| Word | Meaning here | Check |
|---|---|---|
| Grid / snap | every kit piece's footprint and height a multiple of the grid; pivot at a corner [GDC Skyrim kits] | a test: `ruler(c).size()` % G ≈ 0 (**no built-in gate**) |
| Human scale | doors 2.0–2.1 m, stair rise 150–220 mm, kerb 100–150 mm *typical, verify per country* | `real.measures`, `t3d blueprint` figure |
| Texel density | same pixels per metre across the scene | `assertTexelDensity(asset, [lo, hi])` |
| Reuse ratio | unique pieces ÷ placed pieces; low is efficient | count `ctx.use` calls vs recipes (by hand) |
| Repetition break | no two identical instances adjacent; vary seed, yaw, wear | seeds per instance (`hashId(osmId)` for real buildings); `cityPlan` colours neighbours across shared walls differently (test) |
| Scene budget | unique meshes, instances, draws, on-screen triangles, texture bytes | `sceneBudgetFindings(stats, placements, budget, cameras?)`; LOD by projected height (`LOD_SWITCH` 0.25 / 0.06) |
| Leading lines | kerbs, rails, rooflines that lead to the focal piece | judge composition in `hero.png` |
| Focal point | one hero piece holds the highest value contrast | **planned** check; judge in critique |
| Rest area | ≥ 25 % of visible surface quiet (plain wall, ground) | **planned** metric |
| Storytelling | wear explains use: worn steps, stains under sills, puddles at low points | critique `wear` criterion |

## Quality bar
- [ ] Grid stated in the dossier; every kit piece snaps; pivots on grid corners.
- [ ] Human-scale features right on `blueprint.png`.
- [ ] Textures at true scale (`tiled`, `mass`), never stretched; texel density even.
- [ ] Repetition broken by seed, not by hand-copied coordinates.
- [ ] Composition: a focal piece, leading lines, rest areas, foreground/midground/background.
- [ ] Every placed thing touches the ground or its support (floating-parts at every LOD).
- [ ] LOD2 drops whole detail layers but keeps skyline and big masses.

## Common mistakes
- Detailing before the block-out reads at human scale.
- Everything snapped to grid: looks mechanical; let props break the grid.
- Identical trees/houses in a row; one seed reused.
- Non-square, odd-sized kit pieces that cannot tile.
- Uniform wear; dirt that ignores gravity and water.
- Building game logic, spawn rules or navmesh: out of scope. Assets only (+ instance manifests).
- Guessing a real street: pin it from OpenStreetMap, credit ODbL, and let the tests prove the massing.

## Run order
```sh
bun run t3d build recipes/<name>/<name>.ts --out out        # QA per LOD, exit 1 on a finding
bun run t3d shot recipes/<name>/<name>.ts --out renders     # READ sheet.png
bun run t3d hero recipes/<name>/<name>.ts --out renders     # READ hero.png
bun run t3d blueprint recipes/<name>/<name>.ts --out renders  # READ blueprint.png
bun run t3d hero recipes/<name>/<name>.ts --out renders --az -20 --el 25  # composed view
bun run t3d critique recipes/<name>/<name>.ts --out tmp/critique  # READ every PNG, fill critique.json
bun run shots <name>                      # refresh committed out/
```

## Pairs with
- [architect](../architect/SKILL.md): each building in the scene.
- [prop-artist](../prop-artist/SKILL.md): set-dressing pieces.
- [material-artist](../material-artist/SKILL.md): tiling walls, ground, nature strips.
- [technical-artist](../technical-artist/SKILL.md): scene budgets and LOD layers.
- [art-director](../art-director/SKILL.md): one world, one style.

## Tool status
Shipped: `ctx.use`, `defineFamily`, `definePart`, `tiled`, `cell`, `mass`, `facade`, `setbacks`,
`opening`, `roof`, `heightfield`, erosion, `terrainColor`, `tree`/`trees`, `grime`, nature strips,
OSM extracts (`bun run data osm`, `readOsm`), `cityBlock` / `cityPlan` / `cityWindows`,
`toInstancedGlb` (EXT_mesh_gpu_instancing), `sceneBudgetFindings`. Demo: `recipes/city_block`.
Planned: kit grid/snap gate (none today), `variations(n)`, facade kits on polygon footprints
(stoops, shopfronts, true-scale brick on prisms), DEM ground in a city recipe, road-network
grammar ([roadmap](../../../docs/plans/roadmap.md)).
Neutral positioning: the free code-based option, no claims against other tools.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.