Export the diagram HTML at $1 to .svg and/or .png, following the procedure documented in skills/diagram-design/references/export.md. Treat that reference as the source of truth — don't reimplement the logic here. Run the packaged skills/diagram-design/scripts/export_svg.py and skills/diagram-design/scripts/export_png.py helpers for the requested formats. If --registry is present, also follow skills/diagram-design/references/export-registry.md to emit the metadata sidecar — a separate procedure from the SVG/PNG rasterization above.
Full argument string: $ARGUMENTS
Defaults
- With no format flag (nothing, or only
--scale/--output) and no--registry: produce both.svgand.pngnext to the source (e.g.diagram.html→diagram.svg+diagram.png).--svg-onlyor--png-onlyrestricts the image output to that one format. - PNG renders at
device_scale_factor=2. --registrygiven by itself, with neither--svg-onlynor--png-onlyalso present, produces only the registry JSON. The SVG/PNG defaults above do not also apply, and Playwright is never required for a registry-only call. To get an image alongside the registry, add--svg-onlyor--png-onlyexplicitly.
Flags
--svg-only— emit only the SVG. Skip Playwright entirely.--png-only— emit only the PNG.--scale=N— override the PNG device scale factor with a finite number from1to4, including fractional values such as1.25. Default2.--output=<path>— override the output base path; the format extension is appended. Applies to both formats when both are produced.--registry— emit<basename>.registry.json, a metadata sidecar of every block'sdata-block-*attributes. Followsskills/diagram-design/references/export-registry.md, a procedure independent of the SVG/PNG rasterization above — it never needs Playwright. Used alone (see Defaults), it is the only output produced. Combine with--svg-onlyor--png-onlyto also produce an image in the same call.
Required behaviour
- No source path provided → ask the user which
.htmlfile to export. Don't guess. - Source is
assets/index.html(the gallery, multiple SVGs in one file) → refuse and ask which specific diagram file. Per the reference's edge-case section. - Source has no
<svg>block → refuse and tell the user; don't write anything. - PNG requested but Playwright not installed → surface the install instruction from the reference verbatim and stop. Do not auto-install.
- PNG requested with a non-numeric or non-finite
--scale, or a value outside the inclusive 1–4 range → reject. Fractional values within that range are valid. - Both
--svg-onlyand--png-onlysupplied → reject them as mutually exclusive. --registryrequested but source has nodata-block-idattributes → refuse and tell the user; don't emit an empty or partial registry file. Per the export-registry reference's edge-case section.--registryis the only flag given (no--svg-only/--png-only) → emit only the registry JSON. Do not also produce SVG/PNG, and do not check for Playwright — a registry-only call must succeed on a host that doesn't have it installed at all.
After producing the outputs, report the file paths and sizes back to the user.