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.

Install with Tessl CLI

npx tessl i github:miroapp/miro-ai --skill miro-mcp
What are skills?

70

Quality

62%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Optimize this skill with Tessl

npx tessl skill review --optimize ./claude-plugins/miro/skills/miro-mcp/SKILL.md
SKILL.md
Review
Evals

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 description has good structure with explicit 'Use when' guidance and clear platform-specific focus on Miro, making it distinctive. However, it could be stronger by listing more specific concrete actions and including additional natural trigger terms users might use when wanting to work with Miro boards.

Suggestions

Add more specific concrete actions like 'create sticky notes, draw connectors, build flowcharts, add shapes' instead of generic 'diagrams, documents, tables'.

Expand trigger terms to include related concepts users might say: 'whiteboard', 'collaborative board', 'sticky notes', 'visual collaboration', 'online whiteboard'.

DimensionReasoningScore

Specificity

Names the domain (Miro) and lists some actions ('creating diagrams, documents, tables, and extracting context'), but these are somewhat generic categories rather than highly specific concrete actions like 'fill forms' or 'merge documents'.

2 / 3

Completeness

Clearly answers both what ('creating diagrams, documents, tables, and extracting context from Miro boards') and when ('Use when the user asks about Miro capabilities, wants to create content on Miro boards, or needs to work with Miro board data') with explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes 'Miro' and 'Miro boards' as natural keywords users would say, but misses common variations like 'whiteboard', 'collaborative board', 'sticky notes', 'flowchart', or specific Miro features users might mention.

2 / 3

Distinctiveness Conflict Risk

The explicit focus on 'Miro' as a specific platform creates a clear niche that is unlikely to conflict with other diagramming or document skills, as the trigger is tied to the Miro product name.

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 comprehensive coverage of Miro MCP tools with good organization and useful reference tables. However, it lacks executable tool call examples, includes some unnecessary explanatory content, and could benefit from splitting detailed specifications into separate files. The workflow guidance is present but incomplete for multi-step operations.

Suggestions

Add concrete tool invocation examples showing actual parameters and expected responses, not just input format descriptions

Remove the 'What is Miro MCP?' section - Claude understands MCP; jump directly to available tools

Add validation/error handling guidance for operations that could fail (e.g., invalid board URLs, permission errors, malformed DSL)

Consider splitting detailed DSL format specifications and column type definitions into separate reference files

DimensionReasoningScore

Conciseness

The skill includes some unnecessary explanation (e.g., 'What is Miro MCP?' section explaining what MCP is, which Claude knows). The content is generally efficient but could be tightened - the tool listings are somewhat redundant with the quick reference table at the end.

2 / 3

Actionability

Provides good conceptual guidance and example markdown/DSL formats, but lacks executable code examples showing actual tool invocations. The examples show input formats but not complete tool call syntax or expected responses.

2 / 3

Workflow Clarity

The context extraction section has a clear 3-step workflow, but other multi-step processes (like creating and positioning multiple items, or table creation followed by row sync) lack explicit sequences. No validation checkpoints for operations that could fail.

2 / 3

Progressive Disclosure

Content is well-organized with clear sections and a helpful quick reference table, but everything is in one monolithic file. Complex topics like diagram DSL formats or table column type specifications could be split into separate reference files.

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.

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.