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
62%
Does it follow best practices?
Impact
88%
2.37xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/miro-mcp/SKILL.mdQuality
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'.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
b1d33ab
Table of Contents
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.