Content
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is well-sectioned and clearly scoped but remains abstract: it describes a process rather than giving executable commands, duplicates the workflow across two sections, and fails to point at the bundled scripts that actually exist. Adding concrete tool invocations and links to the bundled analyzer scripts would lift the weaker dimensions.
Suggestions
Replace abstract Instructions with concrete, executable commands (e.g. `top -b -n1`, `vmstat 1 5`, `iostat -x 1`, `ps aux --sort=-%mem`) so guidance is copy-paste ready.
Reference the bundled scripts from the body (e.g. 'Run scripts/data_analyzer.py <metrics_dir> to summarize collected data') so progressive disclosure actually connects to the bundle.
Collapse the redundant 'How It Works' and 'Instructions' sections and insert an explicit validate->fix->retry checkpoint after metric collection to remove padding and add a feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is padded with generic restatements ('comprehensive solution', 'leverages the plugin') and duplicates the same process across 'How It Works' and 'Instructions'; it is mostly readable but could be tightened considerably. Not a 1 because it avoids explaining concepts Claude already knows. | 2 / 3 |
Actionability | Names concrete tools (top, ps, vmstat, iostat) and metric types (heap, stack, RSS, connection pool) but provides no executable commands or code; 'Collect real-time metrics using system tools' describes rather than instructs. Not a 3 because nothing is copy-paste ready; not a 1 because it does give some concrete specifics. | 2 / 3 |
Workflow Clarity | Steps are sequenced in 'How It Works' and 'Instructions', but there are no validation checkpoints or validate-fix-retry loops; the 'Error Handling' section is a detached troubleshooting list rather than inline verification. Per the rubric, missing validation in batch/collection operations caps this at 2. | 2 / 3 |
Progressive Disclosure | The body is sectioned but never references the bundled scripts (data_analyzer.py and the others listed in scripts/README.md) or the assets dashboard template, so navigation to existing bundle materials is poor. Not a 1 because sections are organized and references are only one level deep where present. | 2 / 3 |
Total | 8 / 12 Passed |