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.
A well-structured, actionable skill body with a clear 8-phase workflow and concrete tool/parameter guidance, but it is padded with conceptual reasoning sections Claude does not need and relies on reference files that are absent from the bundle.
Suggestions
Trim or move the Reasoning Framework, Evidence Grading, Interpretation Guidance, and Synthesis Questions sections into a separate reference file; keep only operationally essential guidance inline to improve token efficiency.
Provide the missing code_examples.md and report_template.md (or remove the dead links) so the 'Reference Files' pointers resolve to real bundle files.
Add explicit feedback loops for the QC and validation gates (e.g. 'if QC fails, re-examine low-quality spots and re-run') to lift workflow clarity toward full checkpoint coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The operational core (workflow, tool names, QC thresholds, params) is efficient, but the Reasoning Framework, Evidence Grading (T1-T4), Interpretation Guidance, and Synthesis Questions sections explain biology and statistics Claude largely already knows and could be tightened. | 3 / 5 |
Actionability | Provides concrete tool names with parameters (e.g. HuBMAP_search_samples(organ="LK", sample_category="block", registered_only=True)), specific QC thresholds, and executable scanpy snippets; minor gaps because the detailed per-phase code lives in a referenced code_examples.md. | 4 / 5 |
Workflow Clarity | The 8-phase workflow is clearly sequenced with an ASCII diagram and validation checkpoints (QC filters in Phase 1, FDR<0.05 in Phase 4, marker-gene validation in Phase 6, alignment verification), but explicit validate->fix->retry feedback loops are not spelled out. | 4 / 5 |
Progressive Disclosure | Good in-body structure with clear section headers and a dedicated 'Reference Files' section, but the 355-line body inlines content (tool catalog, reasoning framework) that belongs in separate files, and the two referenced files (code_examples.md, report_template.md) do not exist in the bundle — the references are dead. | 3 / 5 |
Total | 14 / 20 Passed |