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.
The description is functional and well-structured with a clear 'Use when' clause and distinct Miro-specific focus. Its main weakness is moderate specificity in the actions listed and limited trigger term coverage beyond the core 'Miro' keyword. The description would benefit from more concrete action verbs and additional natural language terms users might use when requesting Miro-related work.
Suggestions
Add more specific concrete actions like 'create flowcharts, add sticky notes, build mind maps, organize frames' instead of generic 'diagrams, documents, tables'.
Expand trigger terms to include natural variations users might say, such as 'whiteboard', 'sticky notes', 'canvas', 'collaboration board', or 'visual workspace'.
| 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' as a strong trigger term and mentions 'diagrams', 'documents', 'tables', and 'Miro boards', but 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 repeated mention of 'Miro' and 'Miro boards' makes it distinctly identifiable and unlikely to be confused with general 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.
The skill provides a comprehensive catalog of Miro MCP tools with decent organization and some useful examples, but falls short on actionability by not showing concrete tool invocations with actual parameters. It includes unnecessary explanations (basic markdown syntax, what MCP is) and lacks validation/error-handling workflows. The quick reference table is a strong element, but the content would benefit from executable examples and better progressive disclosure.
Suggestions
Add concrete tool invocation examples showing actual parameters (e.g., a complete `diagram_create` call with type, description, position, and parent_id parameters)
Remove the 'What is Miro MCP?' section and the supported markdown syntax list — Claude already knows these concepts
Add validation/verification steps to workflows, especially for document editing (read with doc_get, edit with doc_update, verify with doc_get) and table operations (sync rows then verify with table_list_rows)
Split detailed reference content (diagram types, table column types, context_get return types) into a separate REFERENCE.md file and link to it from the main skill
| 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 executable examples showing actual tool invocations with parameters. The diagram description examples are helpful, but there are no concrete examples of calling `diagram_create`, `table_create`, or `table_sync_rows` with actual parameters. The document example shows markdown content but not how to invoke `doc_create` with it. | 2 / 3 |
Workflow Clarity | The context extraction section has a clear 3-step workflow, but other multi-step processes lack explicit sequencing and validation. For example, creating and positioning diagrams in frames has no step-by-step flow. Document editing with `doc_update` using find-and-replace has no workflow showing how to read, edit, and verify. No validation or error recovery steps are mentioned anywhere. | 2 / 3 |
Progressive Disclosure | The content is reasonably well-structured with clear sections and a quick reference table, but it's a long monolithic document (~180 lines) that could benefit from splitting detailed sections (e.g., diagram types, table operations) into separate reference files. No external file references are provided for deeper content. | 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.
c660f77
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.