CtrlK
BlogDocsLog inGet started
Tessl Logo

scvi-tools

Deep generative models for single-cell omics. Use when you need probabilistic batch correction (scVI), transfer learning, differential expression with uncertainty, or multi-modal integration (TOTALVI, MultiVI). Best for advanced modeling, batch effects, multimodal data. For standard analysis pipelines use scanpy.

68

Quality

83%

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

78%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.

Well-structured, highly actionable content with excellent progressive disclosure — an overview body pointing to real, one-level-deep reference files, plus a fully executable canonical workflow. The main weakness is redundancy and re-explanation of known concepts (theoretical foundations, repeated 'raw counts' guidance, duplicated modality lists).

Suggestions

Replace the 'Theoretical Foundations' bullet list (variational inference, VAEs, amortized inference) with a single pointer to references/theoretical-foundations.md — these are concepts Claude already knows.

Deduplicate guidance: state 'use raw counts, not log-normalized' once (the code comment or Key Design Principles) instead of three times, and merge the overlapping modality lists in 'When to Use This Skill' and 'Core Capabilities'.

Add a light validation checkpoint to the workflow, e.g. checking training history/convergence and confirming the latent representation shape before running sc.pp.neighbors, to strengthen the feedback loop.

DimensionReasoningScore

Conciseness

The body is mostly efficient (compact model bullet lists that point to reference files), but it includes unnecessary material: the 'Theoretical Foundations' section re-explains variational inference, VAEs, and amortized inference — concepts Claude already knows — where a one-line pointer to the reference file would do, and guidance like 'use raw counts' appears three times (code comment, 'Key Design Principles', and 'Best Practices'), while the modality list appears in both 'When to Use This Skill' and 'Core Capabilities'. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the minor-trimming anchor at 4.

3 / 5

Actionability

The 'Typical Workflow' is a complete, copy-paste-ready script using the real API (scvi.model.SCVI.setup_anndata through sc.pp.neighbors/umap/leiden), and the DE, save/load, batch-correction, and installation examples are all fully executable with real arguments and inline guidance ('mode="change"', 'delta=0.25', 'layer="counts"'). This matches the 'fully executable, copy-paste ready, covers common cases' anchor.

5 / 5

Workflow Clarity

The typical workflow is a clearly sequenced 6-step pattern (load/preprocess → setup_anndata → train → extract → store → downstream) presented as runnable code with step comments, and it generalizes across models via the 'setup → train → extract' API principle. It stops short of 5 because there are no validation checkpoints or error-recovery guidance (e.g., checking training convergence or verifying the latent representation before downstream analysis), though training is not a destructive/batch operation so the 3-cap does not apply.

4 / 5

Progressive Disclosure

The body is a genuine overview: every model category is a short bullet list clearly signaled with 'See references/<file>.md for:', and all 8 referenced files exist, contain substantial standalone content, and are exactly one level deep (no references-to-references). Detailed material (model docs, DE methodology, workflows, theory) is appropriately split out, matching the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

17

/

20

Passed

Description

87%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: concrete capabilities with named models, an explicit 'Use when you need...' trigger clause, and explicit boundary guidance against scanpy. Keyword coverage of less-common modalities (CITE-seq, multiome, spatial) is the only notable gap.

DimensionReasoningScore

Specificity

The description names several concrete capabilities — 'probabilistic batch correction (scVI)', 'transfer learning', 'differential expression with uncertainty', 'multi-modal integration (TOTALVI, MultiVI)' — matching the 'several specific actions with minor gaps' anchor. It is not a 5 because coverage has gaps (no mention of spatial transcriptomics, ATAC-seq, or cell type annotation, all of which the skill supports) and 'advanced modeling' is mildly abstract; it is above a 3 because more than 1-2 concrete actions are explicitly named.

4 / 5

Completeness

It explicitly answers both questions: what ('Deep generative models for single-cell omics... probabilistic batch correction... differential expression with uncertainty... multi-modal integration') and when ('Use when you need probabilistic batch correction (scVI), transfer learning, differential expression with uncertainty, or multi-modal integration'). The trigger clause is explicit with concrete trigger phrases, matching the top anchor; it also adds boundary guidance ('For standard analysis pipelines use scanpy') beyond the anchor's requirements.

5 / 5

Trigger Term Quality

It includes natural phrases users would say — 'batch correction', 'batch effects', 'transfer learning', 'differential expression', 'multi-modal integration' — giving good keyword coverage. It misses common variations users might use such as 'CITE-seq', 'multiome', 'scRNA-seq', or 'integration' as a standalone trigger, so it falls just short of the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (deep generative/probabilistic models for single-cell omics with named models scVI, TOTALVI, MultiVI) and explicitly disambiguates from the closest competing skill: 'For standard analysis pipelines use scanpy.' That explicit carve-out minimizes conflict risk, matching the 'clear niche with distinct triggers' anchor rather than the minor-overlap anchor at 4.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
synthetic-sciences/openscience
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.