SKILL.md
Miro Board Management
Trigger
Working with Miro whiteboards: creating boards, adding content, building diagrams, or running collaborative workflows like sprint planning or retrospectives.
Workflow
- Discover boards — Call
mirolistboardsormirofindboardto get the target board ID. Every subsequent operation needs a board ID.
- Read existing content — Use
mirogetboardfor an overview,mirolistitemsormirolistallitemsfor specific content, ormirosearch_boardto find items by text.
- Create items — Use the appropriate creation tool:
- mirocreatesticky for sticky notes (colors: yellow, green, blue, pink, orange, red, gray, cyan, purple) - mirocreateshape for shapes (rectangle, circle, triangle, rhombus, star, hexagon) - mirocreatetext for text labels - mirocreateframe for grouping sections - mirocreateconnector to connect items (requires source and target item IDs) - mirocreatecard for structured cards with descriptions - mirocreatemindmapnode for mindmap branches - mirobulk_create when adding multiple items at once
- Connect items — Save item IDs from creation responses. Use
mirocreateconnectorwith start and end item IDs.
- Organize — Use
mirocreateframeto group related items,mirocreategroupto lock items together, ormiroattachtagto categorize.
Workflow Templates
Sprint Board
Create a frame for each column (Backlog, In Progress, Review, Done), then add stickies for tasks.
Retrospective
Create three sections with colored stickies:
- Green: What went well
- Pink: What could improve
- Blue: Action items
Brainstorming
Create a central topic shape, then radiate stickies outward. Use connectors to show relationships.
Mermaid Diagrams
Use mirogeneratediagram to convert Mermaid syntax into visual diagrams on the board. Supports flowcharts and sequence diagrams.
Guardrails
- Always start with
mirolistboardsto get board IDs; never guess or hardcode them. - Save returned item IDs for subsequent connection and update operations.
- Use
mirobulkcreatefor 3+ items instead of individual create calls. - Keep confirmations short: "Added 3 stickies to Sprint Board" not lengthy descriptions.
- When updating items, read the current state first with
mirogetitem.