Automate Miro tasks via Rube MCP (Composio): boards, items, sticky notes, frames, sharing, connectors. Always search tools first for current schemas.
71
58%
Does it follow best practices?
Impact
94%
2.41xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/all-skills/skills/miro-automation/SKILL.mdQuality
Discovery
67%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 does a good job listing specific Miro-related capabilities and is clearly distinguishable from other skills due to its narrow domain focus. However, it lacks an explicit 'Use when...' clause, which limits completeness, and the trigger terms could be broader to capture more natural user language (e.g., 'whiteboard', 'visual collaboration').
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about Miro boards, whiteboards, visual collaboration, or managing Miro content.'
Include more natural user-facing trigger terms like 'whiteboard', 'visual collaboration', 'online board', or 'brainstorming board' to improve discoverability.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions/objects: boards, items, sticky notes, frames, sharing, connectors. Also includes a procedural instruction ('Always search tools first for current schemas'). | 3 / 3 |
Completeness | The 'what' is well covered (automate Miro tasks involving boards, items, sticky notes, etc.), but there is no explicit 'Use when...' clause or equivalent trigger guidance telling Claude when to select this skill. | 2 / 3 |
Trigger Term Quality | Includes relevant terms like 'Miro', 'boards', 'sticky notes', 'frames', 'connectors', and 'sharing', which are natural keywords. However, it misses common user variations like 'whiteboard', 'diagram', 'collaboration board', or 'visual collaboration'. The mention of 'Rube MCP (Composio)' is technical jargon unlikely to be used by end users. | 2 / 3 |
Distinctiveness Conflict Risk | The description is clearly scoped to Miro via a specific MCP integration (Rube/Composio), with distinct domain objects like sticky notes, frames, and connectors. This is unlikely to conflict with other 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 catalog of Miro operations with clear tool sequences and useful parameter documentation, but suffers from repetition (especially around board ID resolution and pitfalls) and lacks concrete executable examples. The workflows are well-sequenced but missing validation/error-recovery steps, and the content would benefit from being split across files to reduce the monolithic nature of the document.
Suggestions
Add concrete, copy-paste-ready MCP call examples (with actual JSON payloads) for at least the most common operations like creating a sticky note or sharing a board, rather than pseudocode numbered lists.
Consolidate the repeated pitfalls (board ID resolution appears in at least 4 places) into the single 'Known Pitfalls' section and reference it, reducing token waste.
Add explicit validation steps to core workflows—e.g., after creating items, call GET_BOARD_ITEMS to verify creation; after sharing, call GET_BOARD_MEMBERS to confirm access.
Consider splitting detailed parameter documentation and the quick reference table into a separate REFERENCE.md file, keeping SKILL.md as a concise overview with workflow guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is moderately efficient but contains significant repetition—pitfalls about board IDs are restated across multiple sections and again in 'Known Pitfalls.' The quick reference table is useful but some parameter listings duplicate information Claude could discover via RUBE_SEARCH_TOOLS (which the skill itself says to always call first). Several sections could be tightened. | 2 / 3 |
Actionability | Tool sequences and parameter names are clearly listed, which is helpful. However, there are no executable code/command examples—the 'Common Patterns' section uses pseudocode-style numbered lists rather than actual MCP call syntax. Key details like exact JSON payload structures for item creation are missing, and the skill repeatedly defers to 'check current schema' without providing concrete examples. | 2 / 3 |
Workflow Clarity | Multi-step workflows are clearly sequenced with numbered steps and labeled as Required/Optional/Prerequisite, which is good. However, there are no explicit validation checkpoints or error recovery steps—e.g., no guidance on what to do if board creation fails, if sharing returns an error, or how to verify items were actually created. The setup section has a basic verification flow but core workflows lack feedback loops. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and a useful quick reference table. However, it's a long monolithic document (~180 lines) with no bundle files to offload detailed content. The repeated pitfalls sections and detailed parameter listings for each workflow could be split into separate reference files. The single external link to Composio docs is appropriate but insufficient for the volume of inline detail. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
d065ead
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.