Diorama es un conjunto de skills para agentes de IA que construyen ilustraciones isométricas animadas para la web. Le pides una escena a tu agente y te entrega un único archivo HTML que funciona sin conexión: un pequeño mundo que se mueve y responde al puntero.
Se instala con npx skills add educlopez/diorama y funciona en cualquier agente compatible con Agent Skills, como Claude Code.
El problema que resuelve
Una buena ilustración da carácter a una landing, a una documentación o a un estado vacío, pero encargarla o dibujarla lleva tiempo, y animarla todavía más. Los agentes de IA saben escribir código, pero sin una guía las escenas salen planas y genéricas. Diorama les da el método: composición, luz, materiales y movimiento.
Qué construí
Cuatro skills que se instalan por separado:
- Diorama SVG: ilustraciones ligeras e interactivas en SVG sin dependencias, con seis temas (
toy,soft,mono,line,nightyprint) y tres tamaños: hero, tarjeta y mini. - Diorama Worlds: mundos en miniatura con Three.js, personas articuladas y una historia coordinada, con cuatro acabados en vivo: miniatura, pixel, halftone y blueprint.
- Diorama Pixel: viñetas pixel art a 320 × 240 con tramado Bayer y texturas procedurales, pintadas por un rasterizador propio en canvas, sin Three.js.
- Diorama Dither: un patio que llena el encuadre, con una estructura y una acción, a 360 × 280 con tramado ordenado y sombra dura. Reutiliza el motor de Pixel y le añade su propio acabado.
Decisiones clave
Cada escena es un solo HTML autocontenido: se abre sin servidor, sin claves de API y sin herramientas globales. Una figura SVG pesa unos 30 KB comprimida.
El agente no da la escena por buena al escribirla: la abre, revisa las vistas que exige la skill y comprueba que las piezas se tocan donde deben. Así lo que entrega es lo que se ve.
Resultados
- Más de 20 estrellas en GitHub y licencia MIT.
- Una galería en vivo en dioramas.dev donde cada figura responde al puntero, cambia de tema y se pausa en su fotograma fijo.
Enlace al proyecto: dioramas.dev
