Content
82%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 highly actionable, well-structured body: every workflow is backed by real, copy-paste-ready script commands, and the domain knowledge included (label vs auth, entity vs assembly) is genuinely non-obvious and tied to attribute choice. The main gaps are the absence of explicit verification/error-recovery steps in the workflows, a few concept entries that restate common knowledge, and an orphaned references/citation.bib that the body never points to.
Suggestions
Add a brief verification step to the search and download workflows (e.g., check results.json hit count with `--count_only` before fetching, and confirm expected files landed in OUTPUT_DIR, retrying/reporting failed IDs).
Either link references/citation.bib from the body (e.g., under Prerequisites or a References section) or remove it, so the bundle has no orphaned files.
Trim the concept glossary entries that restate widely known facts (Entity, Resolution) and keep only the PDB-specific distinctions (label vs auth, instance vs entity, assembly) to tighten token usage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-driven — mostly executable `uv run` invocations, operator lists, and API-specific gotchas (label vs auth, entity vs instance) that Claude genuinely does not know, matching anchor 4 rather than 5. A few concept entries lean on knowledge Claude partly has (e.g. "Resolution: Frequently used measure of structure quality (lower is better)", "Entity: A unique molecule found in a structure") and could be trimmed, but there is no padding and no generic-library tutorializing that would justify 3 or lower. | 4 / 5 |
Actionability | Every workflow gives complete, copy-paste-ready `uv run scripts/... --query '<full JSON/GraphQL>'` commands, and all four referenced scripts actually exist in scripts/. The examples span the common cases (attribute search with sort/count options, sequence, structure, motif, chemical-descriptor, full-text, batch download, GraphQL metadata), matching anchor 5 ("fully executable; copy-paste ready; specific examples cover the common cases"). | 5 / 5 |
Workflow Clarity | Each workflow is a clearly numbered sequence (fetch schema → grep schema → compose query; and equivalents for metadata), with soft checkpoints like "examine many lines... choose the best match", the `--count_only` sanity-check flag, and the core rule to explain queries so the user can correct bad assumptions; the provided scripts also embed rate limiting, per-file error handling, and a bulk-abort check. It falls short of anchor 5 because the body has no explicit result-verification or error-recovery step (e.g., checking results.json for zero hits, or what to do when a download fails), keeping it at anchor 4 ("clear sequence with most checkpoints present; minor validation gaps") rather than triggering the batch cap at 3, since downloads are non-destructive and failure handling is embedded in the script. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned (Prerequisites, Core Rules, then one section per workflow), all script references are one level deep and resolve to real files, and executable code is appropriately pushed into scripts/ rather than inlined. It is not a 5: references/citation.bib exists in the bundle but is never linked or signaled from the body (an orphaned, undiscoverable reference), and the sizable inline concept glossary and example-query blocks are candidates for a references/ file, matching anchor 4 ("good structure... minor organization gaps"). | 4 / 5 |
Total | 17 / 20 Passed |