Content
92%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A lean, actionable skill body with concrete executable examples and clear validation checkpoints. The main gap is progressive disclosure: the references/citation.bib bundle file is provided but never signaled from the skill, leaving it orphaned.
Suggestions
Add a one-line pointer to references/citation.bib (e.g., in Prerequisites or a References section) so the bundled citation file is discoverable and Claude knows when to use it.
State the intended run order of the three scripts explicitly (fetch → analyze_plddt + analyze_pae → interpret) to make the data-flow pipeline unambiguous rather than implied.
Consider trimming the duplicated "Do NOT use when" list in Overview since the description frontmatter already carries a "Do not use if" guard, keeping only the body-specific distinctions (Foldseek, RCSB PDB, custom-sequence AlphaFold).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: it never explains what AlphaFold, pLDDT, or mmCIF are, and assumes Claude's competence. Sections earn their place; it is not the verbose concept-padded anchor, and the slight repetition of the anti-trigger list is the body expanding the description rather than fluff. | 3 / 3 |
Actionability | Provides copy-paste-ready executable commands with real identifiers — e.g. "uv run scripts/fetch_structure.py P00520 -o /path/to/output/" and "uv run scripts/analyze_plddt.py ./data/AF-P00520-F1-metadata.json" — plus concrete path guidance, matching the fully-executable anchor. | 3 / 3 |
Workflow Clarity | A clear fetch → analyze → interpret sequence with explicit validation checkpoints: the license-file existence check in Prerequisites and the mandatory "Check the script output for any [!] WARNING lines" step in Interpreting the Output form a checklist for a non-destructive fetch/analyze task. | 3 / 3 |
Progressive Disclosure | The three scripts are well-signaled one level deep, but references/citation.bib exists as a bundle file and is never referenced or navigated to from the body — a reference present but not clearly signaled, which the bundle-structure guideline penalizes. | 2 / 3 |
Total | 11 / 12 Passed |