← all repositories
sloemo01/diorama

A playbook that makes agents build tiny worlds on spec

Diorama is a Three.js skill kit that turns an AI agent into a disciplined diorama builder — with QA scripts that treat screenshots as evidence.

★702 stars JavaScript Coding AssistantsCreative · Design
diorama
Too new to rank. Velocity needs a few days of history.
not enough history yet
star history

What it does

It defines a diorama as a repeatable product: a staged scene on a slab, a resettable three-quarter hero camera with free orbit, a 64-colour palette with ordered dither and inked contours, and toy-scale characters with real joint animation. The repo ships SKILL.md as the playbook plus copy-in templates, references and a verification harness — 153 files, about 1.3 MB. Three looks are supported: pixel (default), stroked toon, or pixel + stroke, chosen through a single up-front question.

The interesting bit

Everything is deterministic — the scene is a pure function of t, so any frame can be frozen and compared. That turns screenshots into evidence rather than lucky captures, and the QA harness demands per-entity frame proof before an agent shows you anything. It’s process engineering disguised as art tooling.

Key highlights

  • Two intake gates before the first mesh: which look, and whether models come from libraries or agent-modelled geometry (hybrid is the default)
  • Asset licensing is enforced with evidence trails in refs/SOURCES.md and CREDITS.md — commercial use and redistribution required
  • Educational mode gets a first-class exception: part pickers, reversible material overrides, and EdgesGeometry feature edges on live meshes
  • Motion graphics rules (arrows, flames, flow as geometry, not texture) were hardened by a frame-by-frame pass that caught real bugs — speared valve discs, double-headed chevrons, blown-out flashes
  • Installs as an agent skill with frontmatter, so a skills-aware agent can load it by name in later sessions

Caveats

  • The QA scripts need Node with three, esbuild and playwright-core; the media/ previews add roughly 20 MB you can delete
  • Updates overwrite rather than merge — your own edits to an installed copy need committing or patching first
  • The README is dense and rule-heavy; this is a playbook you read, not a library you skim

Verdict

Worth a look if you’re using AI agents for creative coding and want output you can actually verify instead of vibes-based renders. If you just want a quick Three.js scene starter, the ceremony will feel like a lot.

Frequently asked

What is sloemo01/diorama?
Diorama is a Three.js skill kit that turns an AI agent into a disciplined diorama builder — with QA scripts that treat screenshots as evidence.
Is diorama open source?
Yes — sloemo01/diorama is open source, released under the MIT license.
What language is diorama written in?
sloemo01/diorama is primarily written in JavaScript.
How popular is diorama?
sloemo01/diorama has 702 stars on GitHub.
Where can I find diorama?
sloemo01/diorama is on GitHub at https://github.com/sloemo01/diorama.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.