Content
92%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.
An exceptionally executable skill: every authoring, layout, export, and delivery route has copy-paste-ready commands including platform-specific edge cases (WSL2 path quoting, registry-based CLI discovery, the .url workaround for cmd.exe's fragment stripping), plus a failure-signature-keyed troubleshooting table. The only real cost is token duplication — the ELK framing and several convert/export commands are repeated across up to three sections — which is the one dimension keeping it off a clean sweep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — it assumes Claude's competence (no "what is draw.io" preamble, no library tutorials) and spends tokens almost exclusively on non-obvious gotchas (the broken direct .mmd→PNG export, the cmd.exe #-fragment stripping, the --disable-gpu retry). It misses anchor 5 due to real duplication: the ELK-layout framing ("the same layouts the editor's Arrange ▸ Layout menu applies / same engine the draw.io MCP app server uses") appears nearly verbatim in the intro, the ELK section, and the CLI section, and the convert/export commands are repeated across the pipeline, ELK, and CLI sections — trimming these would be pure token savings. | 4 / 5 |
Actionability | Every route ships copy-paste-ready commands: the Mermaid convert (`drawio -x -f xml -o diagram.drawio diagram.mmd`), exports (`-x -f png -e -b 10 -o ...`), layout presets and custom-JSON forms, a complete self-contained Node one-liner for URL generation, per-OS open commands, and a full PowerShell CLI-discovery script with registry fallback. Concrete input/output examples ("/drawio:drawio png flowchart for login" → `login-flow.drawio.png`) cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | The pipeline is an explicit numbered sequence (Author → .drawio → Deliver → Open) with a decision step up front (detect the CLI before choosing Mermaid vs XML), per-format delivery branches, and a hard ordering rule ("Always convert Mermaid to .drawio first, then export"). Validation and feedback loops are present: well-formedness rules stated before writing, a troubleshooting table mapping concrete failure signatures to fixes (retry with --disable-gpu, .url workaround for stripped fragments, fall back to local file on URL-length limits), and a graceful degradation path ("if the open command fails, print the absolute path"). | 5 / 5 |
Progressive Disclosure | The body is a clear overview-plus-operational core: the two heavyweight syntax references (Mermaid syntax, full draw.io XML reference) are pushed out to clearly signaled one-level-deep fetches ("fetch and follow the instructions at: https://.../mermaid-reference.md" and .../xml-reference.md) rather than inlined, sections are well-anchored and cross-linked, and what remains inline (pipeline, CLI location, ELK presets, troubleshooting) is the content needed on every run. There are no bundle files, and nothing in SKILL.md nests more than one level deep. | 5 / 5 |
Total | 19 / 20 Passed |