Content
63%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 body delivers strong, concrete guidance with a clear multi-phase workflow and executable tool calls, but it is somewhat padded (intro redundancy, Workflow Overview/Phase Summaries overlap) and its progressive disclosure is undermined by references to bundle files that are not actually present.
Suggestions
Provide the referenced bundle files (code_examples.md, report_template.md) or remove the links, since following them currently leads nowhere.
Collapse the 'Workflow Overview' ASCII diagram and the 'Phase Summaries' into a single sequenced section to eliminate duplication and save tokens.
Move the long HuBMAP tool catalog and/or the Reasoning Framework into separate reference files to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with real domain specifics (tool names, QC thresholds, organ codes), but the intro paragraph restates the description and the ASCII 'Workflow Overview' overlaps heavily with the 'Phase Summaries' section, so it could be tightened. | 3 / 5 |
Actionability | Provides concrete executable guidance — parameterized tool calls like HuBMAP_search_samples(organ="LK", sample_category="block", registered_only=True, limit=5), explicit QC numbers, and runnable scanpy code blocks — with minor gaps where some phases are described only at a high level inline. | 4 / 5 |
Workflow Clarity | The Phase 1-8 sequence with an ASCII flow diagram and embedded thresholds (min 200 genes, 500 UMI, <20% MT, FDR<0.05) is clearly ordered with most checkpoints present, but explicit validate->fix->retry feedback loops are not spelled out. | 4 / 5 |
Progressive Disclosure | Sections are well-organized and reference links are clearly signaled one level deep, but the referenced files (code_examples.md, report_template.md) do not exist in any bundle directory, and large chunks that could be separate files (the HuBMAP tool catalog, the Reasoning Framework) are inlined. | 3 / 5 |
Total | 14 / 20 Passed |