Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is concise, well-structured, and uses progressive disclosure effectively with a real one-level-deep reference. Its main weakness is actionability: the body gives strategic workflow guidance and names sources, but the executable query specifics live entirely in the reference file.
Suggestions
Add one or two concrete executable patterns to the body (e.g., a representative API/ID-lookup snippet or the exact evidence-output table columns) so the SKILL.md is actionable without forcing a reference hop.
Tighten workflow step 2 ("Pick the narrowest source that answers the evidence question") with a brief decision heuristic or mapping of entity type to primary source.
Surface the reference's evidence-output table column pattern directly in the workflow so the expected result shape is visible in the overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and well-organized with bullet lists and a short workflow; it assumes Claude's competence and avoids explaining biological concepts Claude already knows, so every token earns its place. | 3 / 3 |
Actionability | The body names concrete sources (Ensembl, ClinVar, COSMIC, GWAS Catalog, KEGG, Reactome, Open Targets, AlphaFold DB, RCSB PDB, STRING, CELLxGENE) but the executable specifics (API endpoints, query syntax, exact output handling) are delegated to the reference rather than present in the body, leaving the main instructions somewhat strategic. | 2 / 3 |
Workflow Clarity | Five clearly sequenced steps guide entity identification, source selection, provenance preservation, tabular output, and access/license caveats; the read-only evidence-gathering nature does not require destructive-operation validation loops, and step 5 acts as a caveat checkpoint. | 3 / 3 |
Progressive Disclosure | SKILL.md is a clear overview that points to a single, well-signaled, one-level-deep reference (references/database-evidence-sources.md, which exists), with content appropriately split between overview and source-specific detail. | 3 / 3 |
Total | 11 / 12 Passed |