← ClaudeAtlas

sysmap-to-mirolisted

Turn a codebase or system description into native, editable Miro objects — components become shapes (or provider icons), connections become connectors, boundaries become titled white zones — with a selectable icon set (aws | gcp | azure | custom | none). Uses archify to build and validate the system map, then materializes it on a Miro board. Use when the user says "system map on miro", "editable architecture on miro", "put the diagram on a miro board", or "turn this repo into a miro board".
songstack/sysmap-to-miro · ★ 0 · DevOps & Infrastructure · score 65
Install: claude install-skill songstack/sysmap-to-miro
# sysmap-to-miro Turn a codebase or system description into **editable Miro objects** — not a screenshot. Shapes (or AWS/GCP/Azure icons) from components, connectors from connections, titled white zones from boundaries. ## Prerequisites - **archify** available (the [archify](https://github.com/tt-a1i/archify) skill), or an existing archify `*.architecture.json` IR. - A **connected Miro MCP** (`/mcp` → authenticate `claude.ai Miro`). - Node ≥ 18 for the bundled converter. ## Workflow 1. **Get the IR.** Use archify to produce and validate an `*.architecture.json` (components, connections, boundaries, with geometry), or use one supplied. 2. **Build the board plan:** ``` node bin/ir-to-miro.mjs <ir.architecture.json> --iconset <none|aws|gcp|azure|custom> ``` Emits frames, nodes (x/y/w/h, type, label, sublabel, and `icon` when an icon set is chosen), and connectors (label, style, emphasis). 3. **Create the board.** Confirm the name with the user first, then `board_create` (`invocation_source: "skill"`). Keep the returned board URL. 4. **Materialize — ORDER MATTERS (see Rendering rules):** 1. **Frames + title first.** `layout_create` the boundary frames (`fill=#ffffff` for white zones) plus a title/subtitle TEXT. Frames MUST be created before any node — Miro has no API "send to back", so later items render on top. 2. **Nodes on top.** - `iconset: none` → a `SHAPE` per node (`layout_create`), typed shape/colour. - `iconset