Content
88%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 unusually actionable, well-sequenced body: every step is executable, validation (the repair pass) and error-recovery loops are explicit, and bulk reference material is properly deferred to fetch-on-demand URLs and a bundled script. The remaining room is trimming redundancy (repeated export-command variants) and moving the Windows CLI-discovery scripts out of the main file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — CLI flags, WSL2 registry scans, the .url-file workaround — with essentially no explanation of concepts Claude already knows. It falls short of lean level 5 because the export command recurs in near-duplicate variants across sections and the platform-specific CLI-location machinery (~90 lines of registry/PowerShell scripts) runs long inline. It is well above level 3, which would require unnecessary explanation or padding. | 4 / 5 |
Actionability | Fully executable throughout: copy-paste-ready commands like `drawio -x -f xml -o diagram.drawio diagram.mmd` and `drawio -x -f png -e -b 10 -o diagram.drawio.png diagram.drawio`, a working node URL one-liner, the repair-pass script, a complete PowerShell finder, and a troubleshooting table keyed to exact error strings ("GPU process isn't usable. Goodbye."). Matches the level-5 anchor with specific examples covering the common cases. | 5 / 5 |
Workflow Clarity | "The pipeline" gives a numbered Author → Deliver → Open sequence, the repair pass is an explicit validation checkpoint ("Run this right after writing XML to a .drawio file, before any layout, export or URL step"), and error recovery is covered by the troubleshooting table and the open-failure fallback ("If the open command fails, print the absolute path (or URL)"). Explicit validation plus feedback loops matches level 5. | 5 / 5 |
Progressive Disclosure | The bundled `scripts/find-shapes.js` exists and is referenced with its exact invocation, and the heavyweight Mermaid/XML material is correctly kept out as one-level, fetch-on-demand URLs with clear conditions ("Only when a diagram needs layers, tags, metadata and placeholders … also fetch the full XML reference"). It stops short of level 5 because ~90 lines of Windows CLI-location scripts are inlined in SKILL.md rather than split into a reference file, making the body a long single file. | 4 / 5 |
Total | 18 / 20 Passed |