Content
46%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 has a sound underlying workflow and well-organized external references, but it is weighed down by redundant boilerplate sections and lacks a validation checkpoint in its batch workflow. Tightening the templated filler and adding a verify step would materially improve it.
Suggestions
Remove the redundant 'When to Use' and 'Key Features' sections that restate the description, and delete the 'See ## Usage/Workflow above' filler lines, to cut padding and improve conciseness.
Add a validation checkpoint to the workflow (e.g., verify output language matches the request, confirm all three tables rendered as valid Markdown, and check the figure reference was inserted) before returning the final report.
Replace the broken external example path with a copy-paste-ready invocation using the script's real flags, e.g. `python scripts/main.py --desc "..." --egger "..." --begg "..." --trim "..." --lang English`.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Multiple padded sections add little: 'When to Use' echoes the description verbatim (and lowercased), 'Key Features' restates it again, and 'Example Usage'/'Implementation Details' carry 'See ## Usage/Workflow above' filler and generic boilerplate, making it noticeably verbose. | 2 / 5 |
Actionability | Concrete commands and a real script with flags (--desc/--egger/--begg/--trim/--lang) are referenced, but the body's example path points outside the package and never shows a full real-args invocation, leaving guidance incomplete. | 3 / 5 |
Workflow Clarity | The generate-description → generate-tables → assemble-report sequence is clear and inputs are enumerated, but this batch report-generation workflow has no explicit validation checkpoint, capping workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | Content is appropriately split with clearly signaled, one-level-deep references to the real references/prompts.md and scripts/main.py; minor gaps from redundant inlined boilerplate sections keep it just below a 5. | 4 / 5 |
Total | 12 / 20 Passed |