Diorama

Diorama is a set of AI agent skills that build animated isometric illustrations: SVG figures, 3D miniature worlds, and pixel-art and dithered scenes, each in a single HTML file.

Published on October 16, 2026

Views

0 views

Reading time:
Reading time: 2 min
Diorama

Diorama is a set of AI agent skills that build animated isometric illustrations for the web. Ask your agent for a scene and it hands back a single HTML file that works offline: a small world that moves and answers the pointer.

Install it with npx skills add educlopez/diorama. It works in any agent that supports Agent Skills, such as Claude Code.

The problem it solves

A good illustration gives a landing page, a doc or an empty state its character, but commissioning or drawing one takes time, and animating it takes longer. AI agents can write the code, but without guidance their scenes come out flat and generic. Diorama gives them the method: composition, light, materials and motion.

What I built

Four skills, installed separately:

  • Diorama SVG: lightweight, interactive, dependency-free SVG illustrations, with six themes (toy, soft, mono, line, night and print) and three sizes: hero, card and mini.
  • Diorama Worlds: Three.js miniature worlds with articulated people and one coordinated story, in four live finishes: miniature, pixel, halftone and blueprint.
  • Diorama Pixel: 320 × 240 pixel-art vignettes with Bayer dithering and procedural textures, drawn by a custom canvas rasterizer, with no Three.js.
  • Diorama Dither: a yard that fills the frame, one structure and one action, at 360 × 280 with ordered dithering and hard shadows. It reuses the Pixel kernel and adds its own finish.

Key decisions

Every scene is one self-contained HTML file: it opens with no server, no API keys and no global tools. An SVG figure weighs about 30 KB gzipped.

The agent does not call a scene done when it writes it: it opens the output, checks the views the skill requires and verifies the pieces touch where they should. What it hands over is what you see.

Results

  • More than 20 stars on GitHub, MIT licensed.
  • A live gallery at dioramas.dev where every figure answers the pointer, switches theme and pauses on its still frame.

Project link: dioramas.dev