¿Qué es Diorama?
Diorama es un manual que un agente de programación lee antes de construir una pequeña escena 3D en el navegador: un decorado sobre una losa, visto desde una cámara de tres cuartos que puedes orbitar, con figuras a escala de juguete que caminan, nadan o luchan. La escena se dibuja con Three.js y se acaba en uno de tres estilos: pixel art (una paleta de 64 colores con tramado y contorno entintado), toon con trazo, o ambos combinados.
El núcleo es SKILL.md, un archivo largo de instrucciones con frontmatter de skill (nombre, descripción, versión 5.7.0), para que Claude Code y otros agentes con soporte de skills puedan cargarlo por nombre. Alrededor hay archivos temáticos en references/ para sesiones largas, módulos JavaScript para copiar en templates/ (cámara, iluminación, rigs, agua, efectos) y ocho scripts de QA que controlan Chromium para capturar y puntuar fotogramas congelados.
Es JavaScript con licencia MIT de Nehal Kanak (sloemo), creado el 24 de octubre de 2026, con unas 656 estrellas y 61 forks. Se instala desde npm como @sloemo/diorama, que registró 1.913 descargas en la semana hasta el 17 de noviembre de 2026.
¿Merece la pena Diorama?
Diorama es menos una biblioteca de código que un contrato sobre cómo debe trabajar un agente, y esa es su fuerza. Antes de la primera malla, el agente debe hacer dos preguntas, qué estilo usar y si los modelos vienen de bibliotecas con licencia o se construyen a mano, y luego investigar el tema real en vídeo, registrar cada búsqueda de recursos en SOURCES.md y anotar las licencias en CREDITS.md. Los recursos no comerciales, sin obras derivadas o sin licencia declarada son un alto en seco. Pocas skills de agentes se toman la procedencia tan en serio.
El diseño de verificación es la otra razón para mirarlo. Cada escena es una función pura del tiempo, así que ?t=12.4 siempre muestra el mismo fotograma, y los scripts de templates/qa/ lo congelan, capturan y puntúan con playwright-core. El script frames.mjs graba cada actor por separado y lo marca como FROZEN, TELEPORT, EMPTY u OFFSCREEN, de modo que una figura que dejó de animarse no puede esconderse tras un vecino activo. Los agentes tienden a dar por buena una escena que nunca miraron; esto les obliga a aportar pruebas.
La pega: es pesado. La instalación por npm copia unos 155 archivos y 1,6 MB, y el prompt de instalación pide al agente leer todo SKILL.md, el índice de referencias, varias plantillas y los ejemplos antes de construir. Eso cuesta contexto en cada sesión nueva, y el README admite que las construcciones largas llegarán a la compactación de contexto, que resuelve guardando el estado en archivos. El prompt de instalación también pide a los agentes usar npm en lugar de clonar el repositorio para que el recuento de descargas refleje el uso, lo que hace de esa cifra una señal más blanda de lo que parece. El proyecto tiene tres semanas y media, no tiene versiones etiquetadas en GitHub y ha pasado por muchas versiones de la skill muy deprisa.
Nuestra opinión: para una ilustración puntual o la explicación de un mecanismo, el proceso compensa los tokens, porque los scripts de QA detectan los problemas que un revisor humano encontraría más tarde. Para visuales rápidos y desechables, Teardown o un prompt simple pesan menos; Diorama justifica su coste cuando la escena tiene varios actores en movimiento.
Dónde se gana su sitio
Un desarrollador de juegos indie que prepara el ambiente de un nivel
Obtener una escena animada en pixel art de un lugar sin modelarla yo
Instala la skill, nombra un tema y el agente lo investiga, rellena DESIGN.md, busca modelos CC0 o CC-BY y ejecuta los scripts de QA antes de enseñar fotogramas. El coste es tiempo de agente y tokens; el código es gratis.
Un profesor de ingeniería que crea una explicación web de un motor de cuatro tiempos
Mostrar un mecanismo que funcione y que los alumnos puedan desmontar con clics
Pide una escena educativa: el modo educativo añade una tarjeta lateral, piezas clicables con explicaciones breves, selección por teclado y comprobaciones de que la simplificación no ha borrado piezas que funcionan.
Una diseñadora de marketing en un estudio pequeño que hace clips en bucle para redes
Convertir un guion en una escena animada corta con créditos seguros para publicar
El agente registra cada recurso y su licencia en CREDITS.md y rechaza los no comerciales, y luego entrega fotogramas congelados y tiras de movimiento para revisarlos antes de publicar nada.
Antes de decidirte
- Puesta en marcha
- Pega el prompt de instalación del README en un agente con acceso a shell; ejecuta npx @sloemo/diorama en una carpeta (Node 18+), verifica el número de archivos, lee el manual e informa antes de construir.
- Integraciones
- Three.js r170; frontmatter de skill para agentes de programación con soporte de skills; QA con playwright-core y Chromium, más dos utilidades en Python; media de demostración opcional de @sloemo/diorama-media (20 MB).
- Datos y privacidad
- Todo se ejecuta en local en tu proyecto; según el README, la copia no instala nada global ni ejecuta nada después. La búsqueda de recursos pasa por el acceso web de tu propio agente. Licencia MIT.
- Límites
- Consume mucho contexto en construcciones largas; sin versiones etiquetadas; la calidad depende de que el agente siga un manual largo, y las escenas mostradas son demos del propio autor.
Lo bueno
- Se distribuye como SKILL.md que los agentes con skills cargan por nombre
- Escenas deterministas: cualquier instante muestra el mismo fotograma
- Ocho scripts de QA, con veredictos por actor y fotograma
- Reglas de licencia estrictas y registro de cada recurso importado
Lo malo
- El manual es grande y consume contexto al inicio de cada sesión
- Tres semanas y media de vida, sin versiones etiquetadas en GitHub
- Estilo propio fijo; otros estilos obligan a pelear con el manual
- El prompt de instalación empuja a usar npm para subir las descargas
Ideal para
Desarrolladores que quieren que un agente produzca escenas animadas en Three.js con un estilo pixel o toon coherente y demuestre que cada fotograma funciona.
Alternativas a Diorama
Diorama: preguntas frecuentes
- ¿Merece la pena Diorama?
- Diorama convierte una petición vaga de una escena 3D bonita en una construcción disciplinada, con investigación, un estilo fijo y comprobaciones fotograma a fotograma, y a cambio pide mucho contexto al agente. Le damos un 3.8 sobre 5.
- ¿Cuánto cuesta Diorama?
- Gratis y de código abierto (MIT). Pagas el agente de programación y el modelo que lo usan.
- ¿Qué inconvenientes tiene Diorama?
- El manual es grande y consume contexto al inicio de cada sesión; tres semanas y media de vida, sin versiones etiquetadas en GitHub; estilo propio fijo; otros estilos obligan a pelear con el manual; el prompt de instalación empuja a usar npm para subir las descargas.
- ¿Para quién es Diorama?
- Desarrolladores que quieren que un agente produzca escenas animadas en Three.js con un estilo pixel o toon coherente y demuestre que cada fotograma funciona.
- ¿Es Diorama seguro para los datos de la empresa?
- Todo se ejecuta en local en tu proyecto; según el README, la copia no instala nada global ni ejecuta nada después. La búsqueda de recursos pasa por el acceso web de tu propio agente. Licencia MIT.
- ¿Cuáles son las mejores alternativas a Diorama?
- Las alternativas más cercanas que hemos analizado son teardown, motionmaxxing y HyperFrames.
Respuestas comprobadas el 18 nov 2026.