Content
60%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 well-organized with strong actionability, a clear multi-phase workflow, and effective progressive disclosure to genuine bundle files. Its main weakness is conciseness: structural duplication, promotional padding, and a redundant summary add tokens without adding value.
Suggestions
Remove the duplicate '### Screening and Selection' section (the one whose bullets are copied from Search Strategy) and de-duplicate the 'Use multiple databases', 'Include preprint servers', and 'Document everything' bullets that appear under both Search Strategy and Screening.
Tighten the Visual Enhancement section: drop the promotional 'MANDATORY'/Nano Banana Pro framing and keep only the concrete generate_schematic.py command and the list of figure types.
Delete or sharply condense the Summary section, which restates eight points already covered in Best Practices and Pitfalls.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Noticeably verbose: the '### Screening and Selection' heading is duplicated (appearing twice) with three bullets copied verbatim from the Search Strategy section, the schematic block uses promotional padding ('Nano Banana Pro will automatically generate...'), and the final Summary recapitulates eight points already covered. | 2 / 5 |
Actionability | Provides concrete executable commands (parallel-cli search, verify_citations.py, generate_pdf.py --check-deps, generate_schematic.py with args) plus install snippets and real referenced scripts, with only minor gaps. | 4 / 5 |
Workflow Clarity | A clear seven-phase sequence is presented with validation present (Phase 6 citation verification and the 'Verify all citations' best practice), so the batch-operation cap does not apply; minor checkpoint and error-recovery detail is deferred to references. | 4 / 5 |
Progressive Disclosure | The body is an overview with well-signaled, one-level-deep references to real bundle files (core_workflow.md, search_and_citation.md, example_workflow.md, citation_styles.md, database_strategies.md, review_template.md); structure is good though the inline best-practices/pitfalls lists make the overview somewhat long. | 4 / 5 |
Total | 14 / 20 Passed |