miro-workshop-assistant
por simoneferrario
Coding Agents & IDEsResumen
Workshop photos/notes -> an editable Miro diagram (real FRAMES as containers + stickies + connectors)
Descripción
Qué hace esta skill
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.
Cuándo usarla
- 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
Flujo de trabajo de ejemplo
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
Requisitos
- MIRO_ACCESS_TOKEN environment variable
- MIRO_BOARD_ID environment variable
- Miro account with API access enabled
Instalación
clawhub install simoneferrario/miro-workshop-assistantEjecuta el comando de la CLI o pega el prompt en Claude Code, Cursor, Codex o el agente de programación que uses.