claudeers.
// Developer Tools

ascii-diorama

Claude Code skill for tilt-shift ASCII miniature videos rendered with Three.js

// Developer Tools[ api ][ web ][ claude ]#claude#devtools◷ MIT$open-sourceupdated 18 days ago
Actively maintained
95/100
last commit 19 days ago
last release none
releases 0
open issues 0

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up ascii-diorama (claude-skill project) into my current project.
Found on https://claudeers.com/ascii-diorama
Repo: https://github.com/JDhruv14/ascii-diorama
Homepage/docs: —
Detected install method: claude-skill → # copy this skill into .claude/skills/ascii-diorama/
Category: devtools. Platforms: api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-skill)
# copy the skill dir into your project:
# .claude/skills/ascii-diorama/   (or ~/.claude/skills/ascii-diorama/ for all projects)
// or clone
git clone https://github.com/JDhruv14/ascii-diorama

// compatibility

Platformsapi, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageJavaScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

ascii-diorama

A Claude Code skill for building tilt-shift ASCII miniatures: small, dense, living 3D worlds drawn entirely as coloured monospace characters.

The camera looks steeply down on a little Three.js diorama and sweeps slowly back and forth while the top and bottom of the view blur away like a scale model. Every pixel is drawn as a glyph:

  • grass as / | \ strokes that lean with the wind
  • water as ~ - with # foam
  • stone as — = #
  • trees as clusters of o * +

Each glyph takes its colour from the 3D render. Up close it reads as text, and from a distance as a painting. It runs live in the browser and loops forever.

What's inside

SKILL.md                   the skill: look, workflow, tuning, pitfalls
scripts/serve.mjs          live preview that rebuilds on every reload
scripts/fetch-assets.sh    downloads the starter scene's textures and model
templates/scene/main.js    a complete starter miniature (Three.js)

The starter scene is a line of red gates running down a green cliff to a turquoise sea. It has stone steps, lanterns, gold and red trees, white flower patches, rocks with rolling foam, a walking fox and drifting petals.

It contains every system a new scene needs:

  • terrain baking from real textures
  • a sea shader
  • instanced grass, leaves and flowers
  • path props
  • the glyph pass and tilt-shift

Swap what those systems build to make your own world, such as a harbour, a hill village, a gorge, a lighthouse or a rooftop garden.

Install

git clone https://github.com/JDhruv14/ascii-diorama ~/.claude/skills/ascii-diorama

Claude Code picks it up automatically. Ask for something like "an ASCII diorama of a fishing harbour", or run /ascii-diorama.

To update later:

git -C ~/.claude/skills/ascii-diorama pull

Requirements

  • Node.js 18+
  • three and esbuild installed in or above the scene folder:
    npm i three esbuild
    
  • A browser with WebGL 2

Use it by hand

Set up a scene from the starter:

mkdir -p my-scene && cp ~/.claude/skills/ascii-diorama/templates/scene/* my-scene/
bash ~/.claude/skills/ascii-diorama/scripts/fetch-assets.sh my-scene

Run it:

node ~/.claude/skills/ascii-diorama/scripts/serve.mjs my-scene

Open http://127.0.0.1:5173/. Reload the page after editing my-scene/main.js, and press Space to pause.

For a static copy, index.html, build/main.js and assets/ are everything the page needs.

How it works

  1. Each material writes a surface class (grass, water, stone and so on) into the alpha channel of a half-float render target.
  2. A full-screen shader splits the view into a 200×100 grid. For each cell it samples the render at the matching mip level, reads the class and measures the brightness gradient. It then picks a glyph from a per-class rule, with wind noise for grass and water and edge direction for stone.
  3. The glyph is drawn from a canvas-generated atlas, coloured with the graded render colour, over a dim blurred copy of the scene.
  4. A tilt-shift pass blurs the top and bottom bands on a golden-angle disc.

Asset licences

fetch-assets.sh downloads the following (none of these files are stored in this repo):

AssetSourceLicence
Textures: leafy_grass, coast_sand_01, aerial_rocks_02, castle_wall_slates, weathered_planks, bark_brown_02Poly HavenCC0
Fox modelPixelMannen, via Khronos glTF Sample AssetsCC0
Fox rig and animationtomkranisCC BY 4.0, credit required
Fox glTF conversion@AsoboStudio and @scurestCC BY 4.0, credit required

If what you publish shows the fox, credit tomkranis, @AsoboStudio and @scurest.

Licence

The code and skill text in this repository are released under the MIT License.

// faq

What is ascii-diorama?

Claude Code skill for tilt-shift ASCII miniature videos rendered with Three.js. It is open-source on GitHub.

Is ascii-diorama free to use?

ascii-diorama is open-source under the MIT license, so it is free to use.

What category does ascii-diorama belong to?

ascii-diorama is listed under devtools in the Claudeers registry of Claude-compatible tools.

20 views
★ 111 stars
unclaimed
updated 18 days ago

// embed badge

ascii-diorama on Claudeers
[![Claudeers](https://claudeers.com/api/badge/ascii-diorama.svg)](https://claudeers.com/ascii-diorama)

// retro hit counter

ascii-diorama hit counter
[![Hits](https://claudeers.com/api/counter/ascii-diorama.svg)](https://claudeers.com/ascii-diorama)

// reviews

// guestbook

0/500

// related in Developer Tools

🔓

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…

// devtoolsaffaan-m/⟨JavaScript⟩★ 307,864◷ MIT[ claude ]
🔓

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

// devtoolsDietrichGebert/⟨JavaScript⟩★ 187,728◷ MIT[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// devtoolssafishamsi/⟨Python⟩★ 147,800◷ MIT[ claude ]
🔓

Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA

// devtoolsgarrytan/⟨TypeScript⟩★ 140,465◷ MIT[ claude ]
→ see how ascii-diorama connects across the ecosystem