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 dense, well-structured orchestration skill: exact tool names with parameters, parameter-mistake gotchas, artifact filters, and graded evidence/interpretation thresholds make it immediately actionable. The gaps are minor — no worked example invocations, no failure-path guidance when a lookup returns nothing, and a tool inventory that could be split into a reference file.
Suggestions
Add one or two fully worked example invocations with real values (e.g., `PDBeSIFTS_get_best_structures(uniprot_id="P04637")` followed by `RCSBGraphQL_get_structure_summary(pdb_id=...)`) so the workflow phases are copy-paste executable rather than just named.
Add a short failure-path note per workflow — what to do when a phase returns no structures, no ligands, or low-confidence predictions (e.g., fall back to AlphaFold + Foldseek, or report the gap explicitly) to close the feedback-loop gap.
Consider moving the per-tool Tool Inventory and the Interpretation/Limitations tables into a reference file (e.g., references/tool_inventory.md) and keeping only the most-used tools inline, slimming SKILL.md to an overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and table-driven throughout — tool inventories with parameters ('`PDBeSIFTS_get_best_structures` (uniprot_id)'), a gotchas table ('`alphafold_get_prediction/summary` | `uniprot_id` | `qualifier`'), and threshold tables ('Resolution <2.0A (X-ray) / <3.0A (cryo-EM)') — with no explanations of concepts Claude already knows. Every section adds domain-specific knowledge Claude cannot infer, matching the level-5 anchor. | 5 / 5 |
Actionability | Guidance is highly concrete: exact tool names with parameter signatures, correct-vs-mistake parameter pairs, artifact filter lists ('GOL, EDO, SO4, PEG'), and numeric decision thresholds. However, there are no fully executable example invocations with real values (e.g., a sample `PDBeSIFTS_get_best_structures` call with a real UniProt ID like 'P04637' in context), so it sits at 'mostly executable with minor gaps' rather than copy-paste-ready level 5. | 4 / 5 |
Workflow Clarity | Three workflows are clearly phased (Workflow 1 Phases 0–5, Workflow 3 Phases 1–8) with decision rules ('Resolution <2.5A for drug design. X-ray > Cryo-EM > NMR > AlphaFold') and validation checkpoints such as Workflow 3's 'PDBeValidation quality → binding site well-resolved?'. It falls short of level 5 because there are no explicit error-recovery/feedback loops (what to do when a phase returns nothing, e.g., no co-crystal exists) even though the skill is read-only analysis rather than a destructive or batch operation, so the level-3 cap does not apply. | 4 / 5 |
Progressive Disclosure | The single file is well-organized into scannable sections (LOOK UP DON'T GUESS, Tool Inventory, Workflows, Gotchas, Evidence Grading, Interpretation, Limitations) with no nested references, and no bundle files exist so everything is appropriately self-contained. It is above level 3 (structure is good and nothing is buried), but at ~125 lines the tool inventory and interpretation tables are bulk reference material that could arguably live in a separate reference file, keeping it at 'good structure with minor organization gaps' rather than level 5. | 4 / 5 |
Total | 17 / 20 Passed |