LaunchKit · 2026
Back to Skills

miro-workshop-assistant

Workshop photos/notes -> an editable Miro diagram (real FRAMES as containers + stickies + connectors)

0
593 downloads
by @simoneferrario

Setup & Installation

openclaw skills install @simoneferrario/miro-workshop-assistant

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install miro-workshop-assistant

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

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: Convert this workshop photo into a Miro diagram

AGENT
  1. 1Identifies candidate frames from titled rectangles and labeled areas in the photo
  2. 2Assigns every sticky note to its nearest matching frame
  3. 3Generates a Miro-ready JSON with a stable sessionKey and unique runId
  4. 4Saves the JSON and runs `node miro-push.mjs apply <path>`
  5. 5Reports frames, stickies, and connectors created, plus any assignment warnings
OUTPUT

A structured Miro board with labeled frames, color-coded stickies assigned to the correct containers, and elbowed connectors representing flows

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

MIRO_ACCESS_TOKEN environment variableMIRO_BOARD_ID environment variableMiro account with API access enabled