Content
86%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-engineered body: fully executable quick-start commands with precise flag and output semantics, a clearly sequenced six-step analysis contract with named validation checks, and a verified one-level-deep reference structure. The only slack is minor: a few misconception-correction sentences Claude could be trusted to know, light repetition between the analysis contract and pitfall sections, and a long citation procedure.
Suggestions
Trim or relocate sentences that correct general statistical misconceptions Claude already holds (e.g., the padj < alpha interpretation sentence and the ORA/preranking caveats paragraph) into workflow_guide.md, keeping only the PyDESeq2-specific behavior in the body.
Deduplicate the analysis contract against the later sections — count provenance and prefilter guidance appear in both "Analysis contract" and "Normalization and shrinkage pitfalls"; state each rule once and cross-reference.
Condense the 16-line citation-fetching procedure to its essential rule (cite current version, DOI resolves to latest) and move the network-fetch steps into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely non-inferable, version-specific guidance ("lfc_shrink() changes both the LFC and the lfcSE. It leaves existing Wald statistics and p-values unchanged"; "Integer checks alone cannot establish raw-count provenance") that earns its tokens, and it assumes Claude's competence throughout. However, a few sentences correct misconceptions Claude likely already holds ("A padj < alpha rule ... is not the probability that an individual result is false"), some analysis-contract points are restated in later pitfall sections, and the 16-line citation-fetching procedure pads the tail — matching anchor 4 (minor over-explanation that could be trimmed) rather than anchor 5 (every token earns its place). | 4 / 5 |
Actionability | The Quick start is copy-paste ready: an exact isolated-environment install ("uv venv --python 3.13 .venv-pydeseq2; uv pip install ... 'pydeseq2==0.5.4' 'anndata==0.13.4'") and a fully specified driver invocation with all flags ("--counts counts.csv --metadata metadata.csv --design '~batch + condition' --contrast condition treated control --min-counts 10 --alpha 0.05 --n-cpus 1 --plots --output results/"). Behavior of every flag (--no-transpose, --no-shrink, --shrink-coeff) and every output file is concretely described, and edge cases route to verified Python patterns in the references — covering the common cases exactly as anchor 5 requires. | 5 / 5 |
Workflow Clarity | The "Analysis contract" gives a clear, correctly ordered six-step sequence (establish design → validate/align → prefilter → full-rank formula → fit with diagnostics → explicit contrast test/export) with checkpoints ("Inspect warnings, convergence and normalization assumptions before interpreting results") and a documented validation surface (the driver "rejects duplicate source CSV headers, unequal sample sets, invalid count values, zero-count samples, missing contrast annotations, and unidentifiable designs") plus resolution guidance. It falls short of anchor 5 only in lacking an explicit validate→fix→retry feedback loop for driver-rejected inputs; resolution is directed ("Resolve unmatched IDs and missing design annotations explicitly; never silently take an intersection") but not loop-structured. | 4 / 5 |
Progressive Disclosure | Verified against the actual bundle: all four referenced files (core_workflow_steps.md, analysis_patterns.md, workflow_guide.md, api_reference.md) and the driver script exist, and references are one level deep — the only links beyond SKILL.md are sibling cross-links and external upstream URLs, with no nested chains. The "Detailed workflows" section signals each reference with a one-line scope description, and the split is appropriate: overview, contract, quick start, and pitfalls in the body; fit code, analysis patterns, and deep API detail in the references. This matches anchor 5 (clear overview, well-signaled one-level-deep references, easy navigation). | 5 / 5 |
Total | 18 / 20 Passed |