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 well-structured, highly actionable tool-orchestration skill: exact tool signatures, parameter gotchas, and verified example calls make it effectively copy-paste executable. The main gaps are mild redundancy in the reasoning sections and inlining of per-tool API detail that could be progressively disclosed in a reference file.
Suggestions
Move the per-database tool listings (IPD-IMGT/HLA, HLA Ligand Atlas / MHC Motif Atlas parameter details in Phases 1-2) into a references/tool-api.md file, keeping SKILL.md to the workflow, tool names, and one example call per phase.
Deduplicate domain background: state the abacavir/HLA-B*57:01 drug-hypersensitivity example once (Phase 5's association table) and trim the overlapping explanation in the Reasoning Strategy section to a one-line pointer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is high-value operational content Claude cannot know (exact tool inputs/outputs, parameter gotchas like "NOT query" and the literal "HLA-I" string, IC50 thresholds, allele-availability warnings). Minor over-explanation remains: the Reasoning Strategy paragraph re-explains HLA biology, and the abacavir/HLA-B*57:01 hypersensitivity example appears twice (Reasoning Strategy and Phase 5). | 4 / 5 |
Actionability | Every tool is documented with name, inputs, and outputs, tricky parameters are explicitly called out, and the verified live examples (e.g., `IPD_search_hla_alleles({"name": "A*02:01"})`, `MHCMotifAtlas_get_allele_ligands({"allele": "A0201"})`) are copy-paste-ready calls covering the common cases. The "COMPUTE, DON'T DESCRIBE" directive reinforces executable analysis, and the absence of Python code is appropriate for an instruction-only tool-orchestration skill. | 5 / 5 |
Workflow Clarity | Phases 0-6 are clearly sequenced with per-phase objectives and workflows, and the Edge Cases & Fallbacks section provides error-recovery loops ("If allele not found: Check nomenclature...", "BVBRC empty results: Try broader organism name"). It stops short of 5 because there are no explicit validation checkpoints between phases (only the implicit "confirm species early" guideline). | 4 / 5 |
Progressive Disclosure | The single-file body is well-sectioned (database table, phase diagram, per-phase details, edge cases, limitations) with no nested references and no bundle files to mis-navigate. However, at 258 lines it far exceeds the simple-skill case, and roughly 150 lines of per-database tool API detail (Phase tool listings, IPD/ligand-atlas parameter specifics) are inlined where a references/TOOL_API.md file could offload them from the always-loaded context. | 4 / 5 |
Total | 17 / 20 Passed |