miro-geometry

Calculate center-based Miro board coordinates to prevent item overlap and frame escapes.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/sih3rron/skills --skill miro-geometry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: miro-geometry
Source: https://github.com/sih3rron/skills/tree/main/miro-geometry
Command: npx skills add https://github.com/sih3rron/skills --skill miro-geometry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides clear, actionable guidance to prevent coordinate mistakes, overlapping items, and frame containment errors when programmatically placing or arranging content on a Miro board using MCP tools or the miroctl CLI.

Core Features & Use Cases

  • Coordinate system rules: Explains Miro's center-origin Cartesian system, inverted Y-axis, and that item coordinates refer to item centers.
  • Frame handling and tool differences: Details frame-relative coordinates for miroctl and board-absolute coordinates for Miro MCP, with formulas to convert between frame bounds and item centers.
  • Layout patterns and spacing: Supplies typical item sizes, recommended gaps, grid/row/column layout formulas, and recommended frame padding to avoid overflow.
  • Use case: Calculate positions for a grid of sticky notes inside a frame using miroctl without items escaping the frame or overlapping.

Quick Start

Ask the skill to calculate center coordinates and safe positions for items and frames before placing them with Miro MCP or miroctl.

Frequently Asked Questions about miro-geometry

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent overlapping items when placing content on a Miro board programmatically?

To prevent overlapping items on a Miro board, calculate center-based coordinates, apply recommended spacing guidelines, and use layout formulas for grids and rows before placing items with Miro MCP tools or miroctl.

Why do my programmatically placed Miro frames and items overlap or escape their boundaries?

Items escape Miro frames or overlap due to uncalculated center coordinates, insufficient padding, or mixing up frame-relative and board-absolute positioning systems without applying the correct conversion formulas.

Does Miro MCP use the same coordinate system as miroctl for positioning frames?

No, Miro MCP uses board-absolute coordinates while miroctl uses frame-relative coordinates, requiring specific formulas to convert between frame bounds and item centers to ensure accurate layout placement.

How do I calculate positions for a grid of sticky notes inside a Miro frame using miroctl?

Calculate positions for a Miro sticky note grid by applying center-origin Cartesian rules, accounting for the inverted Y-axis, and using the provided item sizes, recommended gaps, and frame padding formulas.

What is the best way to handle the inverted Y-axis when calculating Miro layout coordinates?

The best way to handle Miro's inverted Y-axis is to treat item coordinates as referring to item centers within a center-origin Cartesian system, adjusting calculations upward for negative Y values to avoid layout overlaps.