CtrlK
BlogDocsLog inGet started
Tessl Logo

scanpy

Scanpy is a scalable Python toolkit for analyzing single-cell RNA-seq data, built on AnnData. Apply this skill for complete single-cell workflows including quality control, normalization, dimensionality reduction, clustering, marker gene identification, visualization, and trajectory analysis.

55

Quality

64%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/scanpy/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%Scale 1-5

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

This skill provides a comprehensive and mostly actionable guide to Scanpy single-cell analysis with good executable code examples. However, it suffers from significant verbosity — explaining concepts Claude already knows, duplicating information across sections, and inlining content that should live in the referenced bundle files. The workflow is well-sequenced but lacks explicit validation checkpoints and feedback loops that would be important for a multi-step analytical pipeline where early decisions propagate downstream.

Suggestions

Remove sections that explain things Claude already knows: the AnnData structure explanation, the 'When to Use This Skill' section, and basic concept explanations. Trust Claude to know what AnnData attributes are.

Add explicit validation checkpoints after key steps: e.g., after QC filtering ('verify remaining cell count and distribution'), after normalization ('check library size distribution is uniform'), after clustering ('verify cluster sizes are reasonable and not dominated by batch effects').

Reduce duplication between the SKILL.md body and the referenced bundle files — the inline standard workflow largely duplicates what references/standard_workflow.md would contain. Keep only a concise quick-start example inline and point to the reference for the full workflow.

Consolidate the 'Common Pitfalls', 'Tips for Effective Analysis', and 'Key Parameters to Adjust' sections into a single concise reference table or checklist to reduce redundancy.

DimensionReasoningScore

Conciseness

The skill is noticeably verbose. It explains AnnData structure (adata.X, adata.obs, etc.) which Claude already knows, includes a 'When to Use This Skill' section that largely repeats the overview, has redundant 'Tips for Effective Analysis' and 'Common Pitfalls' sections with overlapping advice, and the 'Key Parameters to Adjust' section restates information already shown in code examples. The 'Additional Resources' section with external URLs adds little value for Claude.

2 / 5

Actionability

The skill provides extensive executable code examples covering the full workflow from data loading through saving results. Code is copy-paste ready with real function calls and realistic parameters. Minor gaps include the QC script reference (scripts/qc_analysis.py) which isn't bundled, and some steps like batch correction are only briefly mentioned without complete examples.

4 / 5

Workflow Clarity

The workflow is clearly sequenced with numbered steps (1-7) covering the standard analysis pipeline. However, there are no explicit validation checkpoints or feedback loops — for instance, after filtering there's no step to verify the filtered dataset looks reasonable, after clustering there's no validation step, and the QC section says 'check QC plots carefully' but doesn't specify what to look for or what to do if thresholds seem wrong. Given this is a multi-step analytical workflow where bad QC decisions propagate downstream, the lack of validation/feedback loops is notable.

3 / 5

Progressive Disclosure

The skill references multiple bundled files (scripts/qc_analysis.py, references/standard_workflow.md, references/api_reference.md, references/plotting_guide.md, assets/analysis_template.py) with clear descriptions of each. However, no bundle files were actually provided, so these references are unverifiable. Additionally, the SKILL.md itself is quite long (~300 lines) and inlines substantial content (the full standard workflow, common tasks, key parameters) that overlaps significantly with what the referenced standard_workflow.md and api_reference.md would contain, suggesting poor content splitting.

3 / 5

Total

12

/

20

Passed

Description

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

This is a strong skill description that clearly identifies its domain (Scanpy/single-cell RNA-seq analysis) and lists comprehensive workflow steps. The description is well-structured with both a 'what' and 'when' component, though the trigger guidance could be more explicit with user-facing language. Adding common synonyms and abbreviations (scRNA-seq, UMAP, t-SNE) would improve discoverability.

Suggestions

Add common synonyms and abbreviations users might use: 'scRNA-seq', 'UMAP', 't-SNE', 'Leiden clustering', 'gene expression', 'cell type annotation'

Rephrase the 'when' clause to be more explicit with user-facing triggers: 'Use when the user mentions scanpy, single-cell analysis, scRNA-seq, or AnnData objects'

DimensionReasoningScore

Specificity

Lists several specific actions: quality control, normalization, dimensionality reduction, clustering, marker gene identification, visualization, and trajectory analysis. These are concrete bioinformatics workflow steps, though it could be more specific about what each entails (e.g., UMAP, t-SNE, Leiden clustering).

4 / 5

Completeness

Clearly answers 'what' (analyzing single-cell RNA-seq data with specific workflow steps) and has a 'when' clause ('Apply this skill for complete single-cell workflows including...'). The 'when' could be more explicit about user-facing trigger phrases like 'when the user mentions scanpy, single-cell analysis, or scRNA-seq'.

4 / 5

Trigger Term Quality

Includes strong domain-specific trigger terms like 'single-cell', 'RNA-seq', 'Scanpy', 'AnnData', 'clustering', 'marker gene', 'trajectory analysis'. Missing some natural synonyms like 'scRNA-seq', 'gene expression', 'UMAP', 't-SNE', 'Leiden', 'cell type annotation' that users might commonly say.

4 / 5

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: Scanpy-based single-cell RNA-seq analysis. The combination of 'Scanpy', 'AnnData', and 'single-cell RNA-seq' creates a very specific domain that is unlikely to conflict with other skills.

5 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation9 / 11 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

9

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.