Content
75%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 dense, actionable body that sequences an eight-phase pipeline with concrete tool-call syntax and parameter gotchas, supported by fallback loops and edge-case guidance. Minor gaps in example code and explicit validation checkpoints keep it just short of the top anchor.
Suggestions
Add one copy-pasteable Python snippet under 'COMPUTE, DON'T DESCRIBE' (e.g. a pandas/scipy example over MGnify results) to match the actionability of the tool-call guidance.
Insert an explicit validation checkpoint between phases (e.g. 'confirm GTDB taxonomy returned before proceeding to quality assessment') to strengthen workflow feedback loops.
Consider moving the KEGG pathway table and MIMAG quality tiers into a references file to let the SKILL.md body breathe as an overview, improving progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean with bullets, tables, and code blocks and no padding about concepts Claude already knows; the 'Guiding principles' list is mildly motivational but brief enough to keep efficiency high. | 4 / 5 |
Actionability | Gives concrete tool calls with exact parameter syntax and gotchas (e.g. kegg_search_pathway(keyword=...) NOT query, hsa/ko prefixes, study_title="*IBD*"), but the 'COMPUTE, DON'T DESCRIBE' directive urges Python execution without providing any example code. | 4 / 5 |
Workflow Clarity | A clear eight-phase sequence with per-phase notes and explicit fallback loops (ENA to MGnify, GMrepo MeSH/taxon-ID) is present, though there are no explicit result-validation checkpoints before proceeding to the next phase. | 4 / 5 |
Progressive Disclosure | Well-organized sections with no nested references and all content inline at roughly 95 lines; with no bundle files and content concise enough inline, structure is good but exceeds the simple-skill threshold so it does not reach the top anchor. | 4 / 5 |
Total | 16 / 20 Passed |