publish-lego-instructions

name	publish-lego-instructions
description	Produce step-by-step building instructions for a model: a step-annotated MPD plus an instruction audit always, and an HTML/PDF booklet when a renderer is available. Use when asked for build instructions, a building guide or booklet, printable steps, Letter or A4 output, or to publish or export instructions for a generated or imported model.
license	GPL-3.0-or-later

Publish building instructions

Turns a model — a native 3D input or an existing .ldr/.mpd assembly — into a NAME-instructions/ bundle: a step-annotated MPD and an instruction audit always, and an HTML/PDF booklet with rendered step images when a renderer is available. Subassemblies and insertion-press auditing are always on; step density adapts to model size.

Requirements

Needs legolization 0.6.0 or newer — check with legolization --version. If it is missing or older, install the latest stable release with uv tool install legolization@latest (or pip install --upgrade legolization). Only if neither package manager is available, fall back to the standalone installer: curl -LsSf https://uvx.sh/legolization/install.sh | sh (PowerShell: irm https://uvx.sh/legolization/install.ps1 | iex). If installation fails, report the failure and stop.

Conversation contract

• Explain the likely outcome in plain language: the MPD and audit always arrive; the booklet depends on a renderer being available.
• If no renderer is installed and the user wants the booklet, offer the render-ldraw skill's setup flow (it asks consent before installing).
• Ask only when a choice materially changes the result and always recommend one option; is the right default.