
ascii-diorama
Claude Code skill for tilt-shift ASCII miniature videos rendered with Three.js
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.
# copy the skill dir into your project: # .claude/skills/ascii-diorama/ (or ~/.claude/skills/ascii-diorama/ for all projects)
git clone https://github.com/JDhruv14/ascii-diorama
// compatibility
| Platforms | api, web |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | JavaScript |
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+
threeandesbuildinstalled 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
- Each material writes a surface class (grass, water, stone and so on) into the alpha channel of a half-float render target.
- 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.
- The glyph is drawn from a canvas-generated atlas, coloured with the graded render colour, over a dim blurred copy of the scene.
- 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):
| Asset | Source | Licence |
|---|---|---|
Textures: leafy_grass, coast_sand_01, aerial_rocks_02, castle_wall_slates, weathered_planks, bark_brown_02 | Poly Haven | CC0 |
| Fox model | PixelMannen, via Khronos glTF Sample Assets | CC0 |
| Fox rig and animation | tomkranis | CC BY 4.0, credit required |
| Fox glTF conversion | @AsoboStudio and @scurest | CC 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.
// embed badge
[](https://claudeers.com/ascii-diorama)
// retro hit counter
[](https://claudeers.com/ascii-diorama)
// reviews
// guestbook
// related in Developer Tools
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
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,…
Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA