Content
77%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.
An expert-level, highly actionable body: concrete tool calls, parameters, and verified-live failure modes that Claude could not know from training, organized into a clear phased workflow with fallback loops. The weaknesses are token efficiency (duplicated caveats and re-taught dN/dS basics) and a monolithic structure where the OMA/OrthoDB documentation should be split into reference files.
Suggestions
Move the detailed OMA and OrthoDB per-tool workflows (Phase 2 subsections) into one-level-deep reference files (e.g., references/oma.md, references/orthodb.md), keeping only the entry points and decision guidance in SKILL.md.
De-duplicate the OMA_resolve_xref and OrthoDB_search_groups failure-mode caveats, which appear nearly verbatim in both Phase 2 and the Limitations section — state each once and cross-reference it.
Trim the Conservation Reasoning Framework's explanation of what dN/dS ratios mean (standard knowledge) and keep only the skill-specific parts: the data path to Sequence_dn_ds, the null-dS caveat, and the PhastCons/GERP thresholds.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and dense with non-obvious, tool-specific intel (pagination semantics, silent ID-collision failure modes), but it includes explanation Claude already knows — e.g., 'A dN/dS ratio near 1 suggests neutral evolution ... dN/dS ratio > 1 indicates positive selection' — and the OMA/OrthoDB search caveats are stated nearly verbatim both in Phase 2 and again in Limitations. Trimming the duplicated caveats and the basic dN/dS interpretation would tighten it. | 3 / 5 |
Actionability | Fully executable guidance: exact tool names with concrete parameter examples ('Sequence_dn_ds(seq1="ATG...", seq2="ATG...")', 'OMA_get_protein(protein_id="P04637")', 'OrthoDB_search_groups(query=..., species=9606)'), required-vs-optional parameter flags, verified failure modes, and copy-paste-ready fallback paths covering the common cases. | 5 / 5 |
Workflow Clarity | A clear six-phase pipeline with an overview diagram, per-phase checkpoints (e.g., confirm a reference assembly exists before assuming gene lookups work; 'always confirm the group_nr in the response matches what you expect'), a dedicated Fallback Strategies section giving error-recovery loops per failure mode, and synthesis questions acting as an interpretation checklist. | 5 / 5 |
Progressive Disclosure | Headers and section structure are good, and the one bundle file (scripts/dnds.py) is properly referenced inline, but the skill is a monolithic ~290-line file: the detailed OMA and OrthoDB per-tool workflows (~100 lines of API-reference-style content with verified-live call traces) belong in one-level-deep reference files rather than inline in SKILL.md. | 3 / 5 |
Total | 16 / 20 Passed |