Content
85%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.
The workflow content is excellent: fully executable tool calls with explicit thresholds, validation checkpoints at every step, and an honest limitations section. The main weakness is structure — the whole skill is one long file, and the optional ThermoMPNN material (install instructions, five commercial SaaS vendors, licensing) should be split into a reference file with a pointer from SKILL.md.
Suggestions
Move the 'Optional: ThermoMPNN instead of DynaMut2' section (local install, SaaS vendor list, licensing) into references/thermompnn.md and keep only a 2-3 line pointer in SKILL.md with the decision rule for when it matters (near-threshold ΔΔG, double mutants, indels).
Trim editorial asides in the ThermoMPNN section ('Not as clean as DynaMut2's purely academic endpoint, which is why TU defaults to DynaMut2') to reduce token load without losing the guidance.
The reporting-format template duplicates information also implied by Steps 6-7; consider consolidating the mechanism-category table and the confidence grading into the report template section to avoid two passes over the same decision logic.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely efficient — domain-specific tool calls, threshold tables, and decision rules that Claude does not already know, with no padding explaining basic concepts. However the ~45-line optional ThermoMPNN section (vendor SaaS listings, conda install walkthrough, license notes) and chatty asides like 'Not as clean as DynaMut2's purely academic endpoint, which is why TU defaults to DynaMut2' are trimmable. This matches the score-4 anchor (efficient; minor instances of over-explanation that could be trimmed) rather than 5, since every token does not quite earn its place. | 4 / 5 |
Actionability | Every step has copy-paste-ready tool invocations with exact parameters (e.g. 'ESM_explain_variant_mechanism(sequence=..., position=175, ref_aa="R", alt_aa="H", window=8, top_k_features=5)'), numeric decision thresholds (pLDDT >70, ΔlogP < −1, ddG > +1 kcal/mol), a variant-string parsing regex, and a fill-in reporting template. This matches the score-5 anchor (fully executable, copy-paste ready, covering the common cases). | 5 / 5 |
Workflow Clarity | Steps 0–7 are clearly sequenced with explicit validation checkpoints: the reference-residue assert in Step 0 ('assert sequence[position - 1] == ref_aa'), the benign-score gating in Step 1, the pLDDT reliability gating in Step 2, and the honest evidence-grading and limitations sections in Step 7. This matches the score-5 anchor (clear sequence with explicit validation and feedback on conflicting signals); it is not a destructive/batch operation so no cap applies. | 5 / 5 |
Progressive Disclosure | The skill is a single monolithic ~290-line SKILL.md with no bundle files (no references/, scripts/, or assets/ exist). Section headers are good, but the advanced optional content — the entire ThermoMPNN local-install, SaaS-vendor, and license material — is inlined in the main file rather than split into a one-level-deep reference file. This matches the score-3 anchor (some structure, but content that should be separate is inline); it is above 2 because the in-file organization and navigation are solid, but below 4 because the optional material clearly belongs in its own file. | 3 / 5 |
Total | 17 / 20 Passed |