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 domain-specific, actionable guidance (thresholds, tool parameters, interpretation rules) with a clearly sequenced multi-phase workflow, but it is padded by triple restatement of the same pipeline and its reference architecture is broken — both linked reference files are missing from the bundle. Trimming the redundant sections and shipping the referenced files (or moving HuBMAP detail into one) would lift it substantially.
Suggestions
Remove the redundancy between the 'Workflow Overview' ASCII diagram, 'Phase Summaries', and 'Core Capabilities' — keep one canonical phase description and cut the other two to reclaim significant tokens.
Add the missing code_examples.md and report_template.md files to the bundle (or remove the links), since Phase 8 and the Reference Files section currently point to nonexistent files.
Move the ~100 lines of HuBMAP dataset/sample/donor tool documentation into a separate reference file (e.g., references/hubmap.md) and keep only the tool names and fallback note in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The same 8-phase pipeline is restated three times — the 'Workflow Overview' ASCII diagram, the 'Phase Summaries' section, and the 'Core Capabilities' bullets — which is noticeable redundancy, though much of the domain-specific material (QC cutoffs, Moran's I thresholds, tool parameters) is genuinely additive. Not 4: the triplication and ~100 lines of HuBMAP tool detail exceed 'minor instances of over-explanation'. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: specific thresholds ('min 200 genes, 500 UMI, <20% MT', 'FDR < 0.05', 'Moran's I > 0.3'), tool calls with parameters and documented return shapes (e.g., HuBMAP_search_samples with organ/sample_category/limit), and runnable scanpy snippets. Not 5: the full pipeline code is delegated to code_examples.md, which is not present in the bundle, leaving the core analysis loop described rather than copy-paste ready. | 4 / 5 |
Workflow Clarity | The 8-phase sequence is clearly ordered with checkpoints — QC gates in Phase 1, alignment verification, FDR filtering in Phase 4, marker-gene validation in Phase 6, and a Quantified Minimums checklist plus T1-T4 evidence grading for interpretation. Not 5: there are no error-recovery feedback loops (e.g., what to do when QC filters remove too many spots or alignment fails); checkpoints state 'verify' without recovery steps. | 4 / 5 |
Progressive Disclosure | References are clearly signaled and one level deep ('[code_examples.md](code_examples.md)', '[report_template.md](report_template.md)'), but neither file exists in the bundle — the links are broken — and ~100 lines of HuBMAP tool documentation that clearly belong in a separate reference file are inlined in SKILL.md. Not 4: broken reference targets plus inlined reference-grade content are more than 'minor organization gaps'. | 3 / 5 |
Total | 14 / 20 Passed |