CtrlK
BlogDocsLog inGet started
Tessl Logo

miro-mcp

This skill teaches how to use Miro MCP tools effectively for creating diagrams, documents, tables, and extracting context from Miro boards. Use when the user asks about Miro capabilities, wants to create content on Miro boards, or needs to work with Miro board data.

73

2.37x
Quality

62%

Does it follow best practices?

Impact

88%

2.37x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/miro-mcp/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

75%

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

This is a solid description that clearly identifies its niche (Miro board operations) and includes an explicit 'Use when' clause with multiple trigger scenarios. Its main weaknesses are moderate specificity in the actions listed and missing some natural trigger terms users might use when wanting to work with Miro-like functionality. The Miro-specific focus provides excellent distinctiveness.

Suggestions

Add more specific concrete actions like 'create flowcharts, add sticky notes, organize frames, export board content' to increase specificity.

Include additional natural trigger terms users might say, such as 'whiteboard', 'sticky notes', 'mind map', 'canvas', or 'collaboration board'.

DimensionReasoningScore

Specificity

Names the domain (Miro MCP tools) and lists some actions (creating diagrams, documents, tables, extracting context), but these are somewhat general categories rather than highly specific concrete actions like 'create flowcharts', 'add sticky notes', or 'export board data'.

2 / 3

Completeness

Clearly answers both 'what' (creating diagrams, documents, tables, extracting context from Miro boards) and 'when' with an explicit 'Use when' clause covering three trigger scenarios: asking about Miro capabilities, creating content on Miro boards, or working with Miro board data.

3 / 3

Trigger Term Quality

Includes 'Miro' and 'Miro boards' which are strong trigger terms, plus 'diagrams', 'documents', 'tables'. However, it misses common variations users might say like 'whiteboard', 'sticky notes', 'flowchart', 'mind map', 'canvas', or 'collaboration board'.

2 / 3

Distinctiveness Conflict Risk

The Miro-specific focus creates a clear niche that is unlikely to conflict with other skills. The mention of 'Miro MCP tools' and 'Miro boards' makes it distinctly identifiable and unlikely to be confused with generic diagramming or document creation skills.

3 / 3

Total

10

/

12

Passed

Implementation

50%

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

This skill provides a comprehensive overview of Miro MCP tools with decent organization and useful reference tables. Its main weaknesses are the lack of concrete, executable tool invocation examples (showing actual parameters), some unnecessary explanations of concepts Claude already knows (markdown syntax, what MCP is), and missing validation steps in workflows. The content would benefit from being more concise and showing complete tool call examples rather than describing tool capabilities abstractly.

Suggestions

Add concrete tool invocation examples with actual parameters (e.g., show a complete `table_create` call with column definitions and a `diagram_create` call with all required parameters including positioning).

Remove the 'What is Miro MCP?' section and the supported markdown syntax list — Claude already knows these concepts. Use the saved space for executable examples.

Add validation/verification steps to workflows — e.g., after creating a diagram, call `board_list_items` to confirm it was created; after `doc_update`, call `doc_get` to verify changes.

Consider splitting detailed sections (diagram types, table operations, context extraction) into separate reference files and keeping SKILL.md as a concise overview with quick-start examples.

DimensionReasoningScore

Conciseness

The skill includes some unnecessary explanation (e.g., 'What is Miro MCP?' section explains what MCP is, which Claude already knows). The supported markdown section lists basic markdown syntax Claude is deeply familiar with. The best practices section is somewhat generic. However, much of the content is useful reference material like tool names, parameters, and board coordinate systems.

2 / 3

Actionability

The skill lists tools and describes what they do, but lacks concrete executable examples showing actual tool invocations with parameters. The diagram description examples are helpful, but there are no complete tool call examples (e.g., showing exact parameters for `table_create` with column type definitions, or `table_sync_rows` with key_column usage). The document example shows markdown content but not how to call `doc_create` with positioning parameters.

2 / 3

Workflow Clarity

The context extraction section has a clear 3-step workflow, but other multi-step processes lack explicit sequences. There are no validation checkpoints — for example, after creating a diagram or table, there's no step to verify the output was created correctly. The document editing workflow (doc_get -> doc_update) is not explicitly sequenced despite being a multi-step process that could fail.

2 / 3

Progressive Disclosure

The content is well-structured with clear headings and a quick reference table, but it's a long monolithic file (~180 lines) that could benefit from splitting detailed sections (e.g., diagram types, table operations) into separate reference files. There are no references to external files for deeper content. The quick reference table at the end is a good navigation aid.

2 / 3

Total

8

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
miroapp/miro-ai
Reviewed

Table of Contents

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.