Content
71%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, highly actionable skill body with excellent executable code, honest failure handling, and a clear QC-first workflow ordering. Its weaknesses are verbosity from explaining biology and tool equivalents Claude already knows, an inlined tool catalog that belongs in a reference file, and a broken link to analysis_patterns.md on the decision tree's most-traveled path.
Suggestions
Create the missing analysis_patterns.md file (per-cell-type DE, correlation, PCA, ANOVA, cell communication) that the Workflow Decision Tree and Reference Documentation sections link to three times, or repoint those links to an existing reference — the dead link currently sits on the most common routing path.
Move the ~70-line ToolUniverse Integration tool catalog to a reference file (e.g., references/tooluniverse_tools.md), keeping only the 5-6 most-used tools inline, to cut body tokens without losing navigation.
Trim sections that re-teach knowledge Claude already has — the 'WHY each metric flags a problem' biology rationale (keep only the tissue-dependent cutoff guidance) and the Scanpy-vs-Seurat equivalents table — to tighten the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly high-value operational knowledge (MAD gating rules, tool parameter-validation quirks, pipeline ordering), but it includes unnecessary explanation of concepts Claude already knows — e.g., the 'WHY each metric flags a problem' section explaining membrane rupture enriching mitochondrial transcripts, the full Scanpy-vs-Seurat equivalents table, and generic statements like 'A database-verified answer is always more reliable than a guess'. At ~430 lines with a ~70-line inline ToolUniverse tool catalog, it could be meaningfully tightened. This matches the score-3 anchor ('mostly efficient but includes some unnecessary explanation or could be tightened') better than score 4, where over-explanation would be only minor. | 3 / 5 |
Actionability | Guidance is fully executable throughout: copy-paste-ready data-loading code, QC metric computation code, a complete end-to-end pipeline block (read -> QC -> normalize -> HVG -> PCA -> cluster -> annotate -> DE), statistical test snippets with exact function signatures, and concrete commands like `python scripts/scrna_qc.py data.h5ad --doublets` and a fully-parameterized `tu run run_deseq2_analysis` invocation. Even failure paths are executable ('print the install plan and stop'). This matches the score-5 anchor; code is real, not pseudocode, so score 3/4 anchors do not apply. | 5 / 5 |
Workflow Clarity | The sequence is clear and well-ordered: RULE ZERO (check pre-computed results before re-analysis), a workflow decision tree routing each question type to a reference, an explicit QC-before-downstream ordering with per-step removal reporting, and a troubleshooting table for error recovery. Checkpoints are mostly present (distribution visualization before cutoffs, --install-plan preflight, 'never report cutoffs you did not actually run'), but there is no explicit validate-output-then-retry loop after the pipeline (e.g., re-validate clustering after QC removal), which keeps it at score 4 rather than 5. It is clearly above score 3, where the sequence would exist but checkpoints would be missing. | 4 / 5 |
Progressive Disclosure | Structure is generally good — a decision tree pointing to eight one-level-deep references/*.md files, all of which exist — but the body links to `analysis_patterns.md` three times (the decision tree's 'Pattern 1' and 'Pattern 2' for the most common DE and correlation patterns, and the Reference Documentation section) and that file does not exist in the bundle, leaving a dead link on the primary navigation path. Additionally, the ~70-line ToolUniverse tool catalog is inlined in SKILL.md where it belongs in a reference file. This fits the score-3 anchor ('could be better organized; content that should be separate is inline') better than score 4's 'minor organization gaps', since a missing referenced file is a navigation failure, not a minor gap. | 3 / 5 |
Total | 15 / 20 Passed |