miro-workshop-assistant
oleh simoneferrario
Coding Agents & IDEsRingkasan
Workshop photos/notes -> an editable Miro diagram (real FRAMES as containers + stickies + connectors)
Deskripsi
Apa yang Dilakukan Skill Ini
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.
Kapan Menggunakannya
- 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
Contoh Alur Kerja
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
Persyaratan
- MIRO_ACCESS_TOKEN environment variable
- MIRO_BOARD_ID environment variable
- Miro account with API access enabled
Instalasi
clawhub install simoneferrario/miro-workshop-assistantJalankan perintah CLI-nya, atau tempel prompt ke Claude Code, Cursor, Codex, atau coding agent apa pun yang Anda pakai.