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.
The skill is highly actionable with a well-sequenced workflow and good failure recovery, but it is a single ~290-line monolith that inlines reference material and repeats itself (taxonomy IDs three times, response-format notes twice). Splitting lookup tables into reference files and de-duplicating would raise both conciseness and progressive disclosure.
Suggestions
Consolidate the NCBI taxonomy ID listings (currently in Key Principles, Phase 0, and the 'Common Species Taxonomy IDs' table) into a single table, and remove the duplicate response-format notes between Phase 1 and the Tool Parameter Reference section.
Move the Tool Parameter Reference, species taxonomy table, and Interpretation Framework into a references/ file (e.g., references/tool_reference.md) and link to them from a lean SKILL.md overview, keeping only the workflow and decision logic inline.
Trim the 'Domain Reasoning: Dataset Quality Assessment' paragraph, which overlaps the Interpretation Framework section and re-explains instrument/quantification concepts (TMT compression, DIA vs DDA) that are already covered in the quality-tier table.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense and useful (parameter tables, decision logic, fallbacks), but there is real duplication and over-explanation: NCBI taxonomy IDs appear three times (Key Principles, Phase 0, and a dedicated 'Common Species Taxonomy IDs' table), response-format notes are repeated in Phase 1 and again in 'Tool Parameter Reference', and the 'Domain Reasoning' paragraph re-explains TMT/DIA/instrument-resolution concepts that largely reappear in the 'Interpretation Framework' section. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' (3) rather than the minor-trimming of level 4. | 3 / 5 |
Actionability | Every phase gives copy-paste-ready tool calls with exact parameter names, types, and formats (e.g., 'MassIVE_search_datasets(page_size=20, species="9606")', 'species as string, max 100', 'px_id in PXD format only'), plus a complete report template and per-failure fallbacks. Per the scoring notes, an instruction-only skill is not penalized for lacking code; this meets the 'fully executable, specific examples cover the common cases' anchor, not the 'minor gaps' of level 4. | 5 / 5 |
Workflow Clarity | The four phases are clearly sequenced with decision logic (Phase 0 routes accession vs. species vs. keyword queries to the right tools), and the 'Fallback Strategies' table provides explicit error-recovery loops (e.g., 'MassIVE_get_dataset fails for PXD accession -> Use ProteomeXchange_get_dataset instead'), matching the anchor with feedback loops for error recovery. Level 4 would require these recovery paths to be only mostly present; here every failure mode in the flow has a stated fallback. | 5 / 5 |
Progressive Disclosure | There is no bundle at all (no references/, scripts/, or assets/ directories) and the file is ~290 lines: the Tool Parameter Reference, the species taxonomy table, and the Interpretation Framework are reference material inlined in SKILL.md that would fit separate files. Section headers are clear, but content that should be separate is inline with no references signaled, matching anchor 3 rather than the 'content appropriately split' of level 4 or 5. | 3 / 5 |
Total | 16 / 20 Passed |