Was ist Diorama?
Diorama ist ein Regelwerk, das ein Coding-Agent liest, bevor er eine kleine 3D-Szene im Browser baut: eine Kulisse auf einer Platte, gesehen aus einer Dreiviertel-Kamera, die du drehen kannst, mit Figuren im Spielzeugmaßstab, die laufen, schwimmen oder kämpfen. Die Szene wird mit Three.js gezeichnet und in einem von drei Looks fertiggestellt: Pixel-Art (eine Palette mit 64 Farben, Dithering und Tuschekontur), Toon mit Strich oder beides kombiniert.
Kern ist SKILL.md, eine lange Anweisungsdatei mit Skill-Frontmatter (Name, Beschreibung, Version 5.7.0), sodass Claude Code und andere skillfähige Agenten sie per Namen laden können. Drumherum liegen Themendateien in references/ für lange Sitzungen, JavaScript-Module zum Kopieren in templates/ (Kamera, Licht, Rigs, Wasser, Effekte) und acht QA-Skripte, die Chromium steuern, um eingefrorene Frames abzufotografieren und zu bewerten.
Es ist MIT-lizenziertes JavaScript von Nehal Kanak (sloemo), angelegt am 24. Oktober 2026, mit rund 656 Sternen und 61 Forks. Installiert wird es von npm als @sloemo/diorama, das in der Woche bis zum 17. November 2026 1.913 Downloads verzeichnete.
Lohnt sich Diorama?
Diorama ist weniger eine Codebibliothek als ein Vertrag darüber, wie ein Agent arbeiten soll, und genau das ist seine Stärke. Vor dem ersten Mesh muss der Agent zwei Fragen stellen, welcher Look und ob Modelle aus lizenzierten Bibliotheken kommen oder von Hand gebaut werden, dann das echte Motiv auf Video recherchieren, jede Asset-Suche in SOURCES.md festhalten und Lizenzen in CREDITS.md eintragen. Assets mit Nichtkommerziell-, Keine-Bearbeitung- oder ohne angegebene Lizenz sind ein harter Stopp. Wenige Agenten-Skills nehmen Herkunft so ernst.
Das Prüfdesign ist der andere Grund, es sich anzusehen. Jede Szene ist eine reine Funktion der Zeit, also zeigt ?t=12.4 immer dasselbe Frame, und die Skripte in templates/qa/ frieren es ein, fotografieren es und bewerten es über playwright-core. Das Skript frames.mjs zeichnet jeden Akteur einzeln auf und markiert ihn als FROZEN, TELEPORT, EMPTY oder OFFSCREEN, sodass sich eine Figur, die nicht mehr animiert ist, nicht hinter einem bewegten Nachbarn verstecken kann. Agenten melden gern Erfolg bei Szenen, die sie nie angesehen haben; hier müssen sie Belege liefern.
Der Haken: Es ist schwer. Die npm-Installation kopiert rund 155 Dateien und 1,6 MB, und der Installationsprompt verlangt vom Agenten, vor dem Bauen SKILL.md vollständig, den Referenzindex, mehrere Vorlagen und die Beispiele zu lesen. Das kostet in jeder neuen Sitzung Kontext, und das README räumt ein, dass lange Builds an die Kontextkomprimierung stoßen, was es löst, indem der Zustand in Dateien liegt. Der Installationsprompt weist Agenten außerdem an, npm statt eines Klons des Repositorys zu nutzen, damit die Downloadzahl die Nutzung abbildet, was diese Zahl zu einem weicheren Signal macht, als sie aussieht. Das Projekt ist dreieinhalb Wochen alt, hat keine getaggten GitHub-Releases und ist sehr schnell durch viele Skill-Versionen gegangen.
Unser Fazit: Für eine einmalige Illustration oder die Erklärung eines Mechanismus lohnt der Prozess die Tokens, weil die QA-Skripte die Probleme finden, die sonst später ein Mensch beim Prüfen findet. Für schnelle Wegwerf-Visuals sind Teardown oder ein einfacher Prompt leichter; Diorama verdient seinen Aufwand, wenn die Szene mehrere bewegte Akteure hat.
Wo es sich lohnt
Ein Indie-Spieleentwickler, der die Stimmung eines Levels skizziert
Eine animierte Pixel-Art-Szene eines Ortes bekommen, ohne sie selbst zu modellieren
Den Skill installieren und ein Motiv nennen; der Agent recherchiert es, füllt DESIGN.md, besorgt CC0- oder CC-BY-Modelle und lässt die QA-Skripte laufen, bevor er Frames zeigt. Die Kosten sind Agentenzeit und Tokens; der Code ist kostenlos.
Ein Ingenieurslehrer, der eine Web-Erklärung eines Viertaktmotors baut
Einen funktionierenden Mechanismus zeigen, den Studierende per Klick zerlegen können
Eine Lernszene anfordern: Der Lernmodus des Regelwerks ergänzt eine Seitenkarte, anklickbare Teile mit kurzen Erklärungen, Auswahl per Tastatur und Prüfungen, dass Vereinfachung keine funktionierenden Teile gelöscht hat.
Eine Marketingdesignerin in einem kleinen Studio, die Loop-Clips für Social Media macht
Aus einem Szenario eine kurze animierte Szene mit veröffentlichungssicheren Credits machen
Der Agent trägt jedes Asset mit seiner Lizenz in CREDITS.md ein, lehnt nichtkommerzielle ab und übergibt dann eingefrorene Frames und Bewegungsstreifen zur Prüfung, bevor etwas veröffentlicht wird.
Bevor du dich festlegst
- Einrichtung
- Den Installationsprompt aus dem README in einen Agenten mit Shell-Zugriff einfügen; er führt npx @sloemo/diorama in einen Ordner aus (Node 18+), prüft die Dateizahl, liest das Regelwerk und berichtet, bevor er baut.
- Integrationen
- Three.js r170; Skill-Frontmatter für skillfähige Coding-Agenten; QA über playwright-core und Chromium plus zwei Python-Helfer; optionale Demo-Medien aus @sloemo/diorama-media (20 MB).
- Daten und Datenschutz
- Alles läuft lokal in deinem Projekt; laut README installiert der Kopierschritt nichts global und führt danach nichts aus. Die Asset-Recherche läuft über den Webzugang deines eigenen Agenten. MIT-Lizenz.
- Grenzen
- Kontextintensiv bei langen Builds; keine getaggten Releases; die Qualität hängt davon ab, dass der Agent einem langen Regelwerk folgt, und die gezeigten Szenen sind Demos des Autors.
Was gut ist
- Kommt als SKILL.md, das skillfähige Agenten per Namen laden
- Deterministische Szenen: jeder Zeitpunkt zeigt dasselbe Frame
- Acht QA-Skripte, darunter Urteile pro Akteur und Frame
- Strenge Lizenzregeln und Protokoll für jedes importierte Asset
Was nicht
- Großes Regelwerk kostet zu Beginn jeder Sitzung Kontext
- Dreieinhalb Wochen alt, ohne getaggte GitHub-Releases
- Fester Hausstil; andere Looks heißen gegen das Regelwerk arbeiten
- Installationsprompt drängt auf npm, um Downloadzahlen zu erhöhen
Am besten für
Entwickler, die einen Coding-Agenten animierte Three.js-Szenen in einheitlichem Pixel- oder Toon-Stil bauen lassen und für jedes Frame einen Beleg wollen.
Alternativen zu Diorama
Diorama: häufige Fragen
- Lohnt sich Diorama?
- Diorama macht aus einer vagen Bitte um eine hübsche 3D-Szene einen disziplinierten Bau mit Recherche, festem Look und Prüfung Frame für Frame, und verlangt dafür viel Kontext vom Agenten. Wir bewerten es mit 3.8 von 5.
- Was kostet Diorama?
- Kostenlos und Open Source (MIT). Du zahlst für den Coding-Agenten und das Modell, die es nutzen.
- Welche Nachteile hat Diorama?
- Großes Regelwerk kostet zu Beginn jeder Sitzung Kontext; Dreieinhalb Wochen alt, ohne getaggte GitHub-Releases; Fester Hausstil; andere Looks heißen gegen das Regelwerk arbeiten; Installationsprompt drängt auf npm, um Downloadzahlen zu erhöhen.
- Für wen eignet sich Diorama?
- Entwickler, die einen Coding-Agenten animierte Three.js-Szenen in einheitlichem Pixel- oder Toon-Stil bauen lassen und für jedes Frame einen Beleg wollen.
- Ist Diorama sicher für Firmendaten?
- Alles läuft lokal in deinem Projekt; laut README installiert der Kopierschritt nichts global und führt danach nichts aus. Die Asset-Recherche läuft über den Webzugang deines eigenen Agenten. MIT-Lizenz.
- Was sind die besten Alternativen zu Diorama?
- Die nächsten Alternativen, die wir getestet haben, sind teardown, motionmaxxing und HyperFrames.
Antworten geprüft am 18. Nov. 2026.