miro-workshop-assistant
by simoneferrario
Coding Agents & IDEsBrief
Workshop photos/notes -> an editable Miro diagram (real FRAMES as containers + stickies + connectors)
Description
What This Skill Does
Converts workshop photos or handwritten notes into structured Miro diagrams with real frames as containers, stickies, and connectors. Uses a local script (`miro-push.mjs`) and session keys to prevent duplicate pushes. Supports undo and full regeneration of pushed diagrams.
It creates proper Miro frames as containers instead of loose sticky notes, preserving the spatial structure of the original whiteboard so the output is immediately editable.
When to Use It
- Turning a whiteboard photo from a sprint retrospective into a Miro frame diagram
- Digitizing handwritten workshop notes with labeled swimlane containers
- Re-pushing a corrected diagram without leaving duplicates on the board
- Undoing a mistaken Miro push and replacing it with a regenerated version
- Mapping physical workshop outputs to a Miro architecture diagram
Example Workflow
User asks: Convert this workshop photo into a Miro diagram
- 1
Identifies candidate frames from titled rectangles and labeled areas in the photo
- 2
Assigns every sticky note to its nearest matching frame
- 3
Generates a Miro-ready JSON with a stable sessionKey and unique runId
- 4
Saves the JSON and runs
node miro-push.mjs apply <path> - 5
Reports frames, stickies, and connectors created, plus any assignment warnings
A structured Miro board with labeled frames, color-coded stickies assigned to the correct containers, and elbowed connectors representing flows
Requirements
- MIRO_ACCESS_TOKEN environment variable
- MIRO_BOARD_ID environment variable
- Miro account with API access enabled
Installation
clawhub install simoneferrario/miro-workshop-assistantRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.