Content
53%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.
The body is concise and well-structured with a clear routing table and usable XML scaffolding, but it delegates its main generation workflow to reference files that are missing and lacks a validation feedback loop for XML output.
Suggestions
Provide the referenced bundle files (references/generation.md and references/style-migration.md) or inline their key steps so the workflow is self-contained.
Add an explicit validation/feedback step for the generated XML (e.g. load in Draw.io or run an XML well-formedness check, then fix and re-check) to support the XML-manipulation workflow.
Include at least one complete end-to-end .drawio example (full mxfile) so the guidance is copy-paste executable rather than only skeletal.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it gives XML rules, a file skeleton, and style strings without explaining what Draw.io is — with only minor padding in the style list. | 4 / 5 |
Actionability | It provides a concrete copy-paste XML template and usable style strings, but the core generation and style-migration how-to is delegated to reference/generation.md and reference/style-migration.md, which do not exist in the bundle. | 3 / 5 |
Workflow Clarity | The Step 0 routing table clearly sequences mode selection, but for XML/document generation there is no validation or fix-retry feedback loop, and the downstream steps point to missing reference files, capping the score at 3. | 3 / 5 |
Progressive Disclosure | References are signaled one level deep in the routing table, but the referenced files (reference/style-migration.md, reference/generation.md) are absent, so the navigation structure is broken in practice. | 2 / 5 |
Total | 12 / 20 Passed |