Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is actionable and workflow-clear with concrete commands and validation checkpoints, but it loses conciseness through a redundant Output/Report-Format overlap and a narrative Examples section, and its reference structure has duplication and an orphaned file.
Suggestions
Remove the 'Output' section or fold it into 'Report Format' to eliminate the restated report-contents redundancy and recover tokens.
Tighten the narrative 'Examples' section into brief one-line triggers, or move it entirely into references/example-use-cases.md.
Either link references/errors.md and references/examples.md from the body or remove them, so every bundle file is reachable and error-handling content lives in one place.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete bash commands, but the narrative 'Examples' section and the 'Output' section restate the 'Report Format' block, adding redundant tokens that could be tightened; not a 3 because not every token earns its place. | 2 / 3 |
Actionability | Provides executable find/grep/diff commands, a concrete report-format template, and action items with explicit file paths and line numbers, matching the 'fully executable, copy-paste ready' anchor. | 3 / 3 |
Workflow Clarity | Eight clearly sequenced steps include an explicit validation checkpoint ('confirm at least 3 data points per source... check the Error Handling table before continuing') with an error-recovery table, satisfying the feedback-loop anchor. | 3 / 3 |
Progressive Disclosure | Three references (how-it-works.md, best-practices.md, example-use-cases.md) are well-signaled and one level deep, but errors.md duplicates the body's Error Handling table and examples.md is unreferenced, so content is not cleanly split; not a 3 due to this duplication and orphaned file. | 2 / 3 |
Total | 10 / 12 Passed |