CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

scanpy

Performs Scanpy single-cell RNA-seq QC, normalization, HVG selection, PCA/UMAP/t-SNE, clustering, exploratory marker ranking, pseudobulk preparation, visualization, and Seurat or SingleCellExperiment RDS conversion to h5ad. Applies to established exploratory scRNA-seq workflows with explicit count and expression provenance; complementary skills cover scvi-tools models and AnnData format details.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-structured skill body: ready-to-run CLI scripts with exact invocations, a clearly sequenced workflow with written inspection/iteration checkpoints, and one-level-deep references to verified bundle files. The main costs are token redundancy — basic AnnData explanation, a duplicated script listing, and a Tips section that restates pitfalls — plus undifferentiated overlapping workflow references.

Suggestions

Merge the 'Bundled Resources' scripts file listing into the 'Script Toolkit' table (or replace it with a one-line pointer) to remove the duplicated script documentation and recover ~20 lines.

Delete or trim the 'Understanding AnnData Structure' and 'Loading Data' sections to only the non-obvious notes (e.g., '.raw' here is full log-normalized expression, NOT counts) since basic AnnData structure and sc.read_* calls are delegated to the anndata skill and already known.

Cut 'Tips for Effective Analysis' items that restate the pitfalls section ('Save checkpoints', 'Run QC script first', 'Consult references as needed') and clearly state when to read references/analysis_workflow.md versus references/standard_workflow.md so their overlapping scope is unambiguous.

DimensionReasoningScore

Conciseness

The core content is dense and skill-specific (the representation/inference contracts section, the Harmony 2 transpose-bug note, '.raw' vs 'layers["counts"]' semantics), but several sections pad or duplicate: 'Understanding AnnData Structure' explains basics Claude already knows and which the description routes to the anndata skill; 'Bundled Resources' re-lists the scripts already tabulated in 'Script Toolkit'; and 'Tips for Effective Analysis' repeats pitfalls (e.g., 'Save checkpoints' ≈ 'Save intermediate results'). This matches the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor, not 2, because the essential material is non-inferable and tightly written.

3 / 5

Actionability

Fully executable throughout: a complete script table with exact typical invocations, copy-paste one-shot and step-by-step command chains, a '--config params.json' reproducibility pattern, and real bundled assets to copy ('cp assets/analysis_template.py my_analysis.py'). Common cases are covered by ready-to-run CLI scripts, matching the copy-paste-ready 5 anchor.

5 / 5

Workflow Clarity

The seven-step workflow is clearly sequenced, and validation/feedback checkpoints are written explicitly rather than implied: 'inspect mitochondrial fraction and counts before choosing thresholds rather than copying defaults', 'inspect results/markers/*.csv, decide labels, write a mapping JSON, then: annotate.py', 'Check PCA variance ratio', and 'Try multiple clustering resolutions'. Error-recovery guidance is also present ('Long workflows can fail partway through' → save intermediate results), matching the explicit-validation-and-feedback-loops 5 anchor.

5 / 5

Progressive Disclosure

All referenced files exist and SKILL.md links are one level deep and clearly signaled ('Read references/r_interop.md for agent-run installation and conversion instructions'). Minor organization gaps remain: the script toolkit is documented twice (table in 'Script Toolkit' plus a file listing in 'Bundled Resources'), two overlapping workflow references (analysis_workflow.md vs standard_workflow.md) are not differentiated, and reference files cross-link to each other (e.g., to upstream-review.md), matching the 'minor organization gaps' 4 anchor rather than 5.

4 / 5

Total

17

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it enumerates concrete capabilities comprehensively, names a clear niche, and explicitly routes adjacent domains to complementary skills. Its main weaknesses are a 'when' clause framed as a scope constraint instead of natural trigger phrases, and omission of several covered capabilities (batch correction, annotation, trajectory) that users commonly mention.

DimensionReasoningScore

Specificity

Lists ten-plus concrete actions ('QC, normalization, HVG selection, PCA/UMAP/t-SNE, clustering, exploratory marker ranking, pseudobulk preparation, visualization, and Seurat or SingleCellExperiment RDS conversion to h5ad') with comprehensive coverage of the Scanpy workflow. No meaningful action is left unnamed, so this matches the comprehensive-coverage anchor rather than the 'minor gaps' anchor at 4.

5 / 5

Completeness

The 'what' is explicit and concrete, and a 'when' clause exists ('Applies to established exploratory scRNA-seq workflows with explicit count and expression provenance'), so the missing-'Use when' cap at 3 does not apply. However the 'when' is phrased as a scope constraint rather than concrete user-side trigger phrases (e.g., 'Use when analyzing .h5ad files or 10X output'), matching the 4 anchor ('when' could be more explicit or specific) rather than 5.

4 / 5

Trigger Term Quality

Good natural keyword coverage including 'single-cell RNA-seq', 'scRNA-seq', 'Scanpy', 'clustering', 'pseudobulk', 'Seurat', 'SingleCellExperiment', 'RDS', and 'h5ad'. A few natural terms users would say are missing — 'batch correction'/'integration', 'cell type annotation', and 'trajectory'/'pseudotime' — all of which the skill body actually covers, so it fits the 4 anchor ('a few natural terms missing') rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Scanpy-based single-cell RNA-seq analysis in Python) with distinct triggers, and the routing clause 'complementary skills cover scvi-tools models and AnnData format details' explicitly deflects the closest sibling skills. Overlap risk is actively managed, matching the minimal-conflict 5 anchor rather than the minor-overlap 4 anchor.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

K-Dense-AI/scientific-agent-skills

Path

skills/scanpy/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.