Content
70%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Well-structured workflow with strong sequencing, validation, and a clean reference hierarchy, but it is held back by inline redundancy and abstract (rather than executable) figure/table generation examples in the body.
Suggestions
Consolidate the duplicated dependency/install guidance — step 0 and the 'Missing dependency behavior' section restate the same probe-and-install flow; reference it once and keep the rest lean.
Add one complete runnable pubfig and one pubtab snippet inline (or clearly point to the recipes as the copy-paste source) so the core artifact step is executable, not just descriptive.
Trim 'Output style rules' and 'Recommended response shape' where they restate steps 5–7 to reduce token cost without losing the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids explaining concepts Claude already knows, but repeats material across step 0, the 'Missing dependency behavior' section, and 'Output style rules' (install/probe behavior and route rules stated multiple times), so it could be tightened rather than earning the lean level 3. | 2 / 3 |
Actionability | Environment probe and install commands are copy-paste ready, but the core artifact-generation guidance is abstract in-body ('one pubfig call + one save_figure(...)') with no complete runnable snippet, leaving the main deliverable incomplete per the level 2 anchor. | 2 / 3 |
Workflow Clarity | A clearly numbered 0–7 sequence with explicit validation checkpoints (availability probe, re-probe after install) and a QA checklist plus install→re-check→degrade feedback loop matches the level 3 anchor. | 3 / 3 |
Progressive Disclosure | The Resources section signals one-level-deep references with per-file descriptions, and every referenced path (references/*.md, references/source-guides/*.md, scripts/ensure_publication_tooling.py) exists, giving clear navigation off a concise overview. | 3 / 3 |
Total | 10 / 12 Passed |