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.

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'.

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' 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

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 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.

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.