Content
86%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 well-engineered skill body: executable, verified code examples; dense expert caveats rather than basics; and clean progressive disclosure into real, substantive reference files. The main improvement levers are consolidating the repeated motif-vs-occupancy caveats and adding explicit error-recovery guidance to the mutation workflow.
Suggestions
Consolidate the recurring 'motif does not establish occupancy' caveat into one clearly marked statement in the When-to-use section and trim its re-statements in the workflow and prediction sections.
Add a short fix-and-retry branch to the mutation workflow (e.g., what to do when the post-mutation rescan reveals a newly created overlapping sequon) to close the feedback-loop gap.
Trim the final verification-boundary paragraph to the two or three claims that are not already implied by the per-section scope statements.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes domain competence (no basic glycosylation biology, no library tutorials) and packs in genuinely non-obvious caveats like "EU N297 is not residue 297 of an isolated Fc FASTA" and "shielding encoded in a PDB B-factor column; those values are not crystallographic temperature factors". It falls at 4 rather than 5 because the motif-vs-occupancy caveat is repeated across several sections and the closing verification-boundary section partially restates scope already signaled elsewhere, leaving minor trimming opportunities. | 4 / 5 |
Actionability | Code examples are fully executable and copy-paste ready with real import instructions and runnable assertions (e.g., "assert [site['position'] for site in sites] == [1, 2]"), and every referenced function was verified to exist in scripts/glycoengineering_tools.py with matching signatures. The prediction table gives concrete thresholds and limits ("Default threshold 0.5", "Up to 2,000 sequences"), and the antibody table specifies exact mutations (N297Q/A/D, T299A) — matching the score-5 anchor. | 5 / 5 |
Workflow Clarity | The 6-step workflow is clearly sequenced and includes explicit verification ("rescan the full product for lost/created overlapping motifs", "Verify the actual product", "Confirm occupancy, folding, binding and antigenicity"), so the batch/destructive cap does not apply. It sits at 4 rather than 5 because error-recovery feedback loops — what to do when a rescan or validation check fails — are not detailed; checkpoints are present but there is no fix-and-retry guidance. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a genuine overview with well-signaled, one-level-deep references — "Read [references/glycoshield.md] for the pinned source, installation, direct Python API" and "Read [references/glycan_databases.md] for the live GlyTouCan SPARQL lookup" — each prefaced with what it contains, and both files (plus both scripts) were verified to exist with matching content. Bulk detail is appropriately split out rather than inlined, matching the score-5 anchor. | 5 / 5 |
Total | 18 / 20 Passed |