mirage-ship SKILL.md skillA

mirage-ship 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-ship@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-ship/SKILL.md
Versions recorded
1
Latest version
git:20261025.cd36420, committed Oct 25, 2026
Size
3,042 bytes
Repository stars
16
License
MIT

Package and prepare a Mirage world for release - one standalone HTML file that opens from disk, size budgets, a static deploy folder for any host, a playtest of the shipped file, and the credits / licence checklist. Never uploads or publishes; the user does that after an explicit OK. Use when the user says "ship it", "package", "single file", "make a build", "deploy", "put it online", "share a link", "release", or a world is finished and needs a deliverable.

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

# Ship

Shipping = a file or folder the user can open, check and publish **themselves**. You never upload, push, publish
or log in anywhere, and you never paste keys or tokens. If the user asks you to publish, prepare everything, print
the exact command, and wait for an explicit "yes, publish it" in chat — even then only run what they named.

## 1. Single file (the default deliverable)

```bash
cd $MIRAGE/examples/<world>
node ../../packages/tools/src/package.mjs .        # -> release/<world>.html  (prints size: inlined assets + code)
node ../../packages/tools/src/playtest.mjs scenarios/playtest.json release/<world>.html --out out/playtest-release
```

The shipped file must pass the same scenario as `dist/` (it runs from file://, no server, no network).

## 2. Budgets (check the packager's printout)

| | budget | typical |
|---|---|---|
| single file, code-only world | ≤ 5 MB | 0.8–1 MB code (three.js + Mirage) |
| + `@mirage/game` | ≤ 5 MB | + 2.24 MB (Rapier WASM, inlined) |
| + photo textures | say so in the README | ~1.3 MB per five 1K WebP sets |
| frame cost, walk, M-series | `plan.budget.frameMs` (8 ms) | 3–5 ms |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add paraldameta/mirage-engine/mirage-ship@sha256:446ac5bd215dd874

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_6cqyvre7jbkvy4fv.svg)](https://markdownregistry.com/a/art_6cqyvre7jbkvy4fv)

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 3,042 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 (3042 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_6cqyvre7jbkvy4fv
GET https://markdownregistry.com/api/v1/resolve?ref=paraldameta/mirage-engine/mirage-ship
GET https://markdownregistry.com/api/v1/blob/446ac5bd215dd8744de857c032ab043bbdfc4aa9b19e51b615adbf00271776bb

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-router SKILL.md skill
paraldameta/mirage-engine · agent/mirage-router/SKILL.md · Entry point for building 3D web worlds with the Mirage engine (code-only three.js worlds for AI agents). Use when the…
git:20261025.cd36420 · audit A · 16 stars

Every file in paraldameta/mirage-engine

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