Content
71%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.
A well-structured, actionable body with good workflow sequencing and validation, undermined by progressive-disclosure references to bundle files (reference.md, setup.sh) that are not actually present.
Suggestions
Add the missing `reference.md` file referenced for 'backends, REST endpoints, or disk/uninstall info', or remove the reference and inline the essential detail.
Add the missing `setup.sh` (or point to the repo-level `install/install.sh` consistently) so the 'Setup on a new device' workflow is executable.
Add an explicit output-verification step for batch parsing (e.g., confirm markdown was written per file) to lift workflow clarity from good to complete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean — tight decision tables, terse fallback bullets, and copy-paste code blocks — with only minor over-justification such as 'The local CLI is not an MCP, and the routing/fallback logic spans tools — so this guidance is needed on top of the raw MCP tool descriptions.' | 4 / 5 |
Actionability | Provides concrete executable commands ('pdf2md paper.pdf', 'bash scripts/batch-local.sh', 'bash "$(dirname "$0")/scripts/check.sh"') and token URLs; cloud/sciverse usage is given as natural-language MCP prompts rather than exact tool invocations, a minor gap. | 4 / 5 |
Workflow Clarity | Clear sequence (decision table → fallback → preflight → usage) with explicit validation checkpoints (check.sh preflight, retry-on-failure feedback loop for parses), satisfying the batch/destructive validation requirement; only minor gaps in output verification. | 4 / 5 |
Progressive Disclosure | Well-organized sections with clearly signaled one-level-deep references, but 'reference.md' and 'setup.sh' are referenced in the body and neither exists in the bundle, breaking navigation to the detail material. | 3 / 5 |
Total | 15 / 20 Passed |