CtrlK
BlogDocsLog inGet started
Tessl Logo

miro-diagram

Use when the user wants to create or update a diagram on a Miro board.

58

2.37x
Quality

48%

Does it follow best practices?

Impact

56%

2.37x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./claude-plugins/miro/skills/miro-diagram/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%

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

This skill is admirably concise and well-structured for its size, but it sacrifices actionability almost entirely by deferring all specifics to the MCP server's tool descriptions. It reads more like a routing hint ('go ask the MCP server') than a skill that teaches Claude how to perform a task. The workflow is too generic to meaningfully guide behavior beyond basic conversational prompting.

Suggestions

Add at least one concrete example showing a specific Miro MCP tool call with realistic parameters (e.g., creating a flowchart or sequence diagram) so Claude has a copy-paste-ready reference.

Include a verification step in the workflow, such as confirming the diagram was created or checking for error responses from the MCP server.

List the specific diagramming tool names or categories available via the Miro MCP server so Claude doesn't have to discover them at runtime.

DimensionReasoningScore

Conciseness

The skill is very lean—no unnecessary explanations of what Miro is or how MCP works. It correctly assumes Claude's competence and delegates specifics to the MCP server's own tool descriptions.

3 / 3

Actionability

The skill provides no concrete commands, code, API calls, or specific tool names. It essentially says 'explore the MCP server and use whatever you find,' which is vague direction rather than executable guidance.

1 / 3

Workflow Clarity

There is a 3-step sequence, but it lacks any validation or verification steps (e.g., confirming the diagram was created successfully, handling errors). The steps are also quite generic—step 3 is essentially 'do the thing.'

2 / 3

Progressive Disclosure

For a simple, short skill under 50 lines with no need for external references, the content is appropriately organized with a clear header and workflow section. No bundle files are needed or referenced.

3 / 3

Total

9

/

12

Passed

Description

40%

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 minimal and action-light. While it correctly includes a 'Use when...' clause and mentions the specific platform (Miro), it fails to describe concrete capabilities beyond 'create or update a diagram.' It would benefit significantly from listing specific diagram types and operations supported, as well as additional trigger terms users might naturally use.

Suggestions

Add specific concrete actions the skill can perform, e.g., 'Creates flowcharts, mind maps, and org charts on Miro boards. Adds shapes, connectors, text, and sticky notes. Modifies existing diagram layouts and styling.'

Expand trigger terms to include natural variations users might say, such as 'flowchart', 'mind map', 'whiteboard', 'visual diagram', 'org chart', 'shapes', or 'Miro'.

Strengthen the 'Use when...' clause with more specific triggers, e.g., 'Use when the user mentions Miro, asks to create flowcharts, mind maps, or any visual diagrams on a whiteboard.'

DimensionReasoningScore

Specificity

The description mentions 'create or update a diagram' which names two actions but remains vague about what kind of diagrams, what capabilities are available, or what concrete operations can be performed. It lacks specific actions like 'add nodes, connect shapes, modify layouts.'

1 / 3

Completeness

It has a 'Use when...' clause addressing the 'when' question, but the 'what does this do' portion is very thin — it only says 'create or update a diagram' without describing specific capabilities or actions the skill performs.

2 / 3

Trigger Term Quality

Includes relevant keywords like 'diagram', 'Miro board', 'create', and 'update' which users might naturally say. However, it misses common variations like 'flowchart', 'mind map', 'whiteboard', 'shapes', 'nodes', or 'visual diagram' that users might use.

2 / 3

Distinctiveness Conflict Risk

The mention of 'Miro board' provides some distinctiveness from generic diagramming tools, but 'diagram' is broad enough that it could overlap with other diagramming or visualization skills. It doesn't clearly distinguish itself from other diagram-related skills.

2 / 3

Total

7

/

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.