CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

miro-automation

Automate Miro tasks via Rube MCP (Composio): boards, items, sticky notes, frames, sharing, connectors. Always search tools first for current schemas.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/miro-automation/SKILL.md

The canonical home for this skill is miro-automation in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

68%Weight 40%Scale 1-5

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

A well-structured, actionable reference for Miro automation with concrete tool sequences, parameters, and pitfalls. Its main weaknesses are missing validation/verification steps around batch and sharing operations, and minor redundancy plus a filler closing section.

Suggestions

Add verification checkpoints after batch and share operations (e.g., call MIRO_GET_BOARD_ITEMS or MIRO_GET_BOARD_MEMBERS to confirm the result before proceeding).

Remove the empty 'When to Use' section, which adds no information.

Deduplicate pitfalls between the workflow sections and 'Known Pitfalls', or move per-workflow detail into a reference file to slim SKILL.md.

DimensionReasoningScore

Conciseness

The body is lean reference material — tool sequences, parameter lists, and pitfalls — assuming Claude's competence without explaining known concepts. Minor over-explanation and redundancy keep it below the 5 anchor: pitfalls are repeated between workflow sections and the 'Known Pitfalls' section, and the closing 'When to Use' section ("This skill is applicable to execute the workflow or actions described in the overview.") is empty filler that earns nothing.

4 / 5

Actionability

Concrete, executable guidance throughout: exact tool slugs (MIRO_GET_BOARDS2, MIRO_CREATE_ITEMS_IN_BULK), parameter names, enum values ('viewer', 'commenter', 'editor'), and hex color formats. Below the 5 anchor because no concrete request/payload examples are shown and several details are deferred to 'check current schema', leaving minor gaps for a copy-paste-ready standard.

4 / 5

Workflow Clarity

Sequences are clearly ordered with prerequisites (resolve board_id via GET_BOARDS2, confirm connection ACTIVE before workflows), but the skill includes batch operations (MIRO_CREATE_ITEMS_IN_BULK) and outward-facing actions (MIRO_SHARE_BOARD) with no validation/verification steps after execution — no verify-created-items or confirm-membership checks. Per the rubric guideline, batch operations without validation cap workflow clarity at 3; the otherwise solid sequencing keeps it from dropping lower.

3 / 5

Progressive Disclosure

Good structure with well-organized sections (Prerequisites, Setup, five Core Workflows, Common Patterns, Known Pitfalls, Quick Reference) and no nested references — appropriate for a single-file skill that defers live schemas to RUBE_SEARCH_TOOLS. Below the 5 anchor because at ~210 lines the per-workflow detail and the Quick Reference table duplicate content that could be split into a separate reference file, leaving minor organization gaps.

4 / 5

Total

15

/

20

Passed

Description

66%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A concise, third-person description with a clearly stated niche and good capability keywords. Its main weakness is the complete absence of a 'when to use' clause, which caps completeness and weakens trigger quality, leaving users to infer when the skill applies.

Suggestions

Append an explicit trigger clause, e.g., 'Use when the user mentions Miro, whiteboards, sticky notes, or wants to create/share Miro boards.'

Convert the object list into concrete actions (e.g., 'create boards and sticky notes, add frames, connect items, share boards') to sharpen the what.

Add natural synonyms such as 'whiteboard' and 'collaborate' to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names a concrete domain ("Miro tasks via Rube MCP (Composio)") and lists several specific capability areas ("boards, items, sticky notes, frames, sharing, connectors"), plus an explicit behavior directive ("Always search tools first for current schemas"). It falls below the 5 anchor because it lists objects rather than comprehensive concrete actions (e.g., no 'create boards, add sticky notes, share boards' verbs), leaving minor coverage gaps.

4 / 5

Completeness

The 'what' is clear (automate Miro board/item/sticky-note/frame/sharing/connector tasks), but there is no 'Use when...' clause or equivalent trigger guidance — the second sentence ("Always search tools first for current schemas") is an agent instruction, not a trigger. Per the rubric guideline, a missing 'when' clause caps completeness at 3; it is not 4 because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Strong natural keywords: "Miro", "boards", "sticky notes", "frames", "sharing", "connectors" — terms a user asking for Miro help would naturally say. Below the 5 anchor because common variations like "whiteboard", "collaborate", or tool synonyms are missing, so a few natural trigger phrases are absent.

4 / 5

Distinctiveness Conflict Risk

"Miro" pins a clear niche with minimal conflict risk, and terms like "sticky notes" and "frames" reinforce it. Below the 5 anchor because generic whiteboard vocabulary ("boards", "sharing", "sticky notes") could still overlap with other whiteboard/collaboration skills, and no explicit trigger phrases sharpen the boundary.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/miro-automation/SKILL.md

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.