Content
68%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |