mirage-router SKILL.md skillA

mirage-router from paraldameta/mirage-engine is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add paraldameta/mirage-engine/mirage-router@git:20261025.cd36420

Pins git:20261025.cd36420 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
paraldameta/mirage-engine
Path
agent/mirage-router/SKILL.md
Versions recorded
1
Latest version
git:20261025.cd36420, committed Oct 25, 2026
Size
2,735 bytes
Repository stars
16
License
MIT

Entry point for building 3D web worlds with the Mirage engine (code-only three.js worlds for AI agents). Use when the user says "Mirage", "build a world / scene / town / level in code", "site plan", "world module", "walkable 3D scene", or when the project has @mirage/* dependencies or a plan.js with regions/footprints/viewpoints. Detects the project state and routes to mirage-brief-to-plan, mirage-module, mirage-parallel-build, mirage-playtest, mirage-game or mirage-ship.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Mirage router

Mirage builds whole 3D places as code: a **site plan** (`plan.js`, every shared position in metres) plus
**modules** (`modules/*.js`, one per part of the world) that the loader builds in order. No model files, no editor.
Agents build modules in parallel and verify the result with scripted playtests in the real Chrome.

## 1. Find the engine and the project

```bash
# the Mirage repo root: has packages/world and packages/tools
ls packages/world/src/loader.js packages/tools/src/playtest.mjs 2>/dev/null || ls node_modules/@mirage
# a Mirage project (a world): any of these
grep -l '"@mirage/' package.json; ls plan.js modules/index.js NOTES.md 2>/dev/null
```

Mirage is not on npm yet: a world lives in a clone of the repo as `examples/<name>` (npm workspaces link
`@mirage/*`). Below, `$MIRAGE` = the repo root. Read once per session: `$MIRAGE/docs/world-protocol.md` (100 lines).

## 2. Route

| state / request | skill |
|---|---|
| no plan yet, or "here is my idea", a brief, a mood, references | **mirage-brief-to-plan** (writes the brief, plan, module list, per-module briefs, scaffold) |
| write or fix one module; "add a pier / walls / trees" | **mirage-module** |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add paraldameta/mirage-engine/mirage-router@sha256:6954719ea451fb26

The line at the top of this page pins the label git:20261025.cd36420, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_gi4jje4zdtzjt4bn.svg)](https://markdownregistry.com/a/art_gi4jje4zdtzjt4bn)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 25, 2026.

versioncommittedcommitsizeaudit
git:20261025.cd36420 latest2026-10-25 cd36420 2,735 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2735 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

paraldameta/mirage-engine · 16 stars · license MIT · pushed 2026-11-09 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_gi4jje4zdtzjt4bn
GET https://markdownregistry.com/api/v1/resolve?ref=paraldameta/mirage-engine/mirage-router
GET https://markdownregistry.com/api/v1/blob/6954719ea451fb26bf835f7dc1b96a421739133eccc73b39d1b9bf69461aaed3

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from paraldameta/mirage-engine

mirage-brief-to-plan SKILL.md skill
paraldameta/mirage-engine · agent/mirage-brief-to-plan/SKILL.md · Turn a one-paragraph idea into a Mirage world's direction before any building ("先定方向再建设") - a brief (idea, mood…
git:20261025.cd36420 · audit A · 16 stars
mirage-game SKILL.md skill
paraldameta/mirage-engine · agent/mirage-game/SKILL.md · Make a Mirage world playable as a small game with @mirage/game - interactables (pick up, use, open, light), inventory…
git:20261108.e7f6fbe · audit A · 16 stars
mirage-module SKILL.md skill
paraldameta/mirage-engine · agent/mirage-module/SKILL.md · Write or fix one Mirage world module (modules/<name>.js) that follows the world protocol - positions only from the site…
git:20261104.ba0858e · audit A · 16 stars
mirage-parallel-build SKILL.md skill
paraldameta/mirage-engine · agent/mirage-parallel-build/SKILL.md · Lead several agents building one Mirage world at the same time, one module each - the coordination contract (site plan…
git:20261025.cd36420 · audit A · 16 stars
mirage-playtest SKILL.md skill
paraldameta/mirage-engine · agent/mirage-playtest/SKILL.md · The agent self-test loop for a Mirage world - build, run it in the real Chrome, drive it with a scripted JSON scenario…
git:20261025.cd36420 · audit A · 16 stars
mirage-ship SKILL.md skill
paraldameta/mirage-engine · agent/mirage-ship/SKILL.md · Package and prepare a Mirage world for release - one standalone HTML file that opens from disk, size budgets, a static…
git:20261025.cd36420 · audit A · 16 stars

Every file in paraldameta/mirage-engine

Browse by kind, by grade A, or by owner.