Skip to content
TakoAPI
Back to skills

miro-workshop-assistant

by simoneferrario

Coding Agents & IDEs
593Downloads reported by clawskills.sh
1Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

User asks: Convert this workshop photo into a Miro diagram

AGENT
  1. 1

    Identifies candidate frames from titled rectangles and labeled areas in the photo

  2. 2

    Assigns every sticky note to its nearest matching frame

  3. 3

    Generates a Miro-ready JSON with a stable sessionKey and unique runId

  4. 4

    Saves the JSON and runs node miro-push.mjs apply <path>

  5. 5

    Reports 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

  • MIRO_ACCESS_TOKEN environment variable
  • MIRO_BOARD_ID environment variable
  • Miro account with API access enabled

Installation

clawhub install simoneferrario/miro-workshop-assistant

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links