Name: miro-format
Rating: 72.8 (1 reviews)
Author: miroapp

miro-format

Use when the user wants a brand-new, standalone Miro item created as its own content — a document, table, diagram, timeline, kanban board, slide deck, prototyping container, activities board, or embed — not added onto a board they're already working on (e.g. "create a doc in Miro about X", "make me a Miro table for Y", "set up a kanban board for Z"). Prefer this over the document/diagram/table skills when no existing board is in play.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

The canonical home for this skill is miro-format in miroapp/miro-ai

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A concise, well-structured delegation skill that keeps the MCP server as the source of truth. Its main weakness is actionability: because it forwards all execution detail to the MCP tools, the body itself offers no executable examples or parameter guidance.

Suggestions

Add one or two illustrative example invocations of a Miro MCP format-creation tool (with representative parameters) so the body is actionable even before the MCP tools are inspected.

Add a brief post-creation verification step to the workflow (e.g., confirm the item was created at the intended location / report the resulting URL) to close the feedback loop.

Optionally note how to discover the available format-creation tool names (e.g., list/filter the MCP tools) so tool selection is more deterministic than 'pick the appropriate tool'.

Dimension	Reasoning	Score
Conciseness	Lean and efficient with no padding; it never explains what Miro is or how the MCP works, and every line (workflow steps, negative-use section) earns its place.	5 / 5
Actionability	Guidance is directionally concrete ("Pick the appropriate format-creation tool... and call it according to its description and parameter schema") but defers all executable specifics to the MCP server, providing no commands, parameters, or examples of its own.	3 / 5
Workflow Clarity	A clear 3-step sequence with a clarification checkpoint ("Ask if unclear") and a guard ("When not to use this skill"); minor gap is the absence of any explicit post-creation verification step, though the skill is non-destructive and delegates execution.	4 / 5
Progressive Disclosure	A simple sub-50-line skill with no need for external references, organized into well-signaled sections (Workflow, When not to use); per the simple-skill exception this scores 5 with just well-organized sections.	5 / 5
	Total	17 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-crafted description that is specific, trigger-rich, complete, and sharply differentiated from sibling skills. Third-person voice is maintained throughout, and the negative boundary (not for existing boards) is explicit.

Dimension	Reasoning	Score
Specificity	Enumerates many concrete format types ("a document, table, diagram, timeline, kanban board, slide deck, prototyping container, activities board, or embed") with comprehensive coverage of the standalone-item creation domain.	5 / 5
Completeness	Explicitly answers both what ("brand-new, standalone Miro item created as its own content") and when ("Use when the user wants...") with concrete trigger phrases.	5 / 5
Trigger Term Quality	Quotes natural phrases users would actually say ("create a doc in Miro about X", "make me a Miro table for Y", "set up a kanban board for Z") alongside the format vocabulary.	5 / 5
Distinctiveness Conflict Risk	Clear niche — standalone creation vs adding onto an existing board — and explicit disambiguation ("Prefer this over the document/diagram/table skills when no existing board is in play") minimizes conflict risk.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: miroapp/miro-ai
Path: codex-plugins/miro/skills/miro-format/SKILL.md
Commit: c2494b2

Reviewed: 11 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.