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.
An unusually well-researched body: exact tool signatures, live-verified examples with real IDs and outputs, honest limitations, and explicit retry/validation guidance. The main weaknesses are structural — everything is inlined in one long out-of-sequence file with several gotchas restated in multiple sections.
Suggestions
Move the per-database tool inventory and the deep workflow details (Workflows 4-9) into one-level-deep reference files (e.g. references/tool-inventory.md, references/workflows.md), keeping SKILL.md as a concise overview with well-signaled links — the tool inventory alone is ~80 lines of inline content that belongs in a bundle file.
Renumber and reorder the workflows into document order — they currently appear as 1, 4, 5, 5b, 6, 7, 8, 2, 9, 3, which makes the multi-workflow process hard to follow sequentially.
State each gotcha once in a canonical location and cross-reference it elsewhere: the PDBe_get_compound_structures fallback gotcha is fully restated in Workflow 2, the Tool Parameter Gotchas table, and Limitations; similarly trim the ~20 repetitions of "(verified live)" to a single note that all examples were verified.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is overwhelmingly tool-specific knowledge Claude would not have — exact parameter names, gotchas ("`alphafold_get_prediction/summary` | `uniprot_id` | `qualifier`"), and verified live examples — with cross-references used in places ("see gotcha below", "see Workflow 5b below"). It is not a 5 because of genuine redundancy: "(verified live)" appears roughly twenty times and the `PDBe_get_compound_structures` gotcha is fully restated in three places (Workflow 2, the gotcha table, and Limitations). It is not a 3 because there is no padding and no explanation of concepts Claude already knows. | 4 / 5 |
Actionability | Mostly executable guidance: exact tool names with parameter signatures, a mistake-vs-correct gotcha table, and literal verified invocations like "`CATH_get_domain_summary(domain_id="1cukA01")`" and "`InterPro_get_member_signature(member_database="pfam", accession="PF00069")`". It falls short of the 5 anchor because several workflow phases are high-level labels without concrete calls (e.g. Workflow 3's "Phase 5: AlphaFold + Foldseek structural comparison", Workflow 1's bare phase arrows), leaving minor gaps. | 4 / 5 |
Workflow Clarity | Workflows have clear phased sequences with explicit decision criteria ("Resolution <2.5A for drug design. X-ray > Cryo-EM > NMR > AlphaFold... Holo > apo") and validation/trust gates plus feedback loops ("retry 1-2 times before reporting an entry is missing", PDBeValidation quality gating, BMRB validation before trusting shifts). It misses the 5 anchor because the workflows are presented out of order in the document (1, 4, 5, 5b, 6, 7, 8, then 2, 9, 3), which breaks the coherence of the overall process. | 4 / 5 |
Progressive Disclosure | Section headers are clear and navigation within the file is decent, but the entire skill is a single ~310-line file: the ~80-line tool inventory and the per-database workflow details (Workflows 4-9) are content that clearly belongs in separate reference files, and no references/ bundle exists. This matches the 3 anchor (structure present but content that should be separate is inline) rather than the 2 anchor, which requires minimal structure. | 3 / 5 |
Total | 15 / 20 Passed |