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 highly actionable, well-sequenced body with executable commands and honest validation framing, held back by repeated MM/GBSA disclaimer padding and a bundled reference file (references/scoring_methods.md) that is never surfaced from the main skill.
Suggestions
Link references/scoring_methods.md explicitly (e.g. 'See [scoring_methods.md](references/scoring_methods.md) for method theory, feature definitions, and accuracy expectations') and move the Output Interpretation detail tables into it.
Consolidate the five separate MM/GBSA/ligand-heuristic disclaimers into the single 'MM/GBSA capability boundary' section and reference it once elsewhere.
Add an explicit post-run validation step to Workflow 4 (e.g. verify exit status and check screening_hits.csv row count against the library before reporting hits).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient — command blocks, tables, and JSON examples all earn their tokens — but the MM/GBSA boundary disclaimer is repeated at least five times (Key capabilities, Validation Warning, 'MM/GBSA capability boundary', Workflow 2, 'Ligand Heuristic Scores', Troubleshooting), which is unnecessary padding. It is not 2 because no section explains concepts Claude already knows, and not 4 because the repetition is substantial rather than a minor trim. | 3 / 5 |
Actionability | Every workflow is a complete, copy-paste-ready command with all flags shown (e.g. 'python scripts/predict.py --protein prepared_protein.pdb --poses docking_results/poses.sdf --output affinity.json'), plus install commands, quick verification snippets, a full 6-step pipeline, and concrete example outputs. Fully executable with the common cases covered. | 5 / 5 |
Workflow Clarity | Workflows are clearly sequenced (Workflow 5 numbers steps 1-6) with a general verification convention — 'Verify the exit status and record status before using a score', the _script_manifest.jsonl check, failed-record handling, and a Troubleshooting section. It is not 5 because the batch screening workflow (Workflow 4) has no embedded validate-after-run checkpoint or fix-and-retry loop; it is not 3 because exit-status/manifest verification and troubleshooting do provide real checkpoints for the batch path. | 4 / 5 |
Progressive Disclosure | Section structure is good (Overview → When to Use → Installation → Workflows → Script Reference → Output Format → Interpretation → Troubleshooting), but the bundled references/scoring_methods.md is never linked or mentioned anywhere in the body — a buried reference — and detailed content that belongs there (output interpretation tables, scoring-method detail) is inlined. It is not 2 because the body is well-sectioned rather than monolithic, and not 4 because an entire bundled reference file is undiscoverable from the entry point. | 3 / 5 |
Total | 15 / 20 Passed |