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.

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.mdandCREDITS.md— commercial use and redistribution required - Educational mode gets a first-class exception: part pickers, reversible material overrides, and
EdgesGeometryfeature 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,esbuildandplaywright-core; themedia/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.