CtrlK
BlogDocsLog inGet started
Tessl Logo

pydeseq2

Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.

56

Quality

66%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/pydeseq2/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

82%

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, domain-specific description with excellent specificity and trigger term coverage for bioinformatics users. Its main weakness is the lack of an explicit 'Use when...' clause, which would help Claude know precisely when to select this skill. The technical terms are appropriate for the target audience and create a clear, distinctive niche.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about differential gene expression, DESeq2 analysis, comparing conditions in RNA-seq data, or generating volcano/MA plots from count matrices.'

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots'. These are precise, domain-specific analytical steps.

3 / 3

Completeness

The 'what' is well-covered (differential gene expression analysis with specific methods and outputs), but there is no explicit 'Use when...' clause or equivalent trigger guidance. The 'when' is only implied by the domain terms, which caps this at 2 per the rubric guidelines.

2 / 3

Trigger Term Quality

Includes strong natural keywords a bioinformatician would use: 'differential gene expression', 'DESeq2', 'RNA-seq', 'bulk RNA-seq counts', 'Wald tests', 'FDR correction', 'volcano plots', 'MA plots', 'DE genes'. Good coverage of domain-specific terms users would naturally say.

3 / 3

Distinctiveness Conflict Risk

Highly specific niche: Python-based DESeq2 differential gene expression from bulk RNA-seq. The combination of domain (RNA-seq), tool (DESeq2), language (Python), and specific outputs (volcano/MA plots) makes it very unlikely to conflict with other skills.

3 / 3

Total

11

/

12

Passed

Implementation

50%

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

The skill provides highly actionable, executable code for PyDESeq2 workflows covering a wide range of use cases. However, it is significantly over-verbose — it explains concepts Claude already knows, repeats information across sections, and inlines content that should live in the referenced supplementary files. The workflow lacks explicit validation checkpoints between steps, which is important for a multi-step analytical pipeline where silent errors can propagate.

Suggestions

Cut the content by at least 50%: remove 'When to Use This Skill', 'Overview' prose, explanations of what design formulas are, what p-values mean, and the 'What deseq2() does' enumeration. Claude knows these concepts.

Move the visualization code, troubleshooting section, and 'Common Analysis Patterns' into the referenced workflow_guide.md or a separate file, keeping only the Quick Start and core workflow in SKILL.md.

Add explicit validation checkpoints: verify sample/gene counts after loading, check that dds.deseq2() completed without warnings, validate results_df is non-empty before filtering, and verify size factors are reasonable before proceeding to statistical testing.

Remove the 'Key Reminders' section which largely repeats guidance already given inline in the workflow steps, or consolidate it into brief inline notes at the relevant steps.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines. It explains concepts Claude already knows (what design formulas are, what p-values mean, what volcano plots are), includes a 'When to Use This Skill' section that's unnecessary, explains what deseq2() does step-by-step, and has extensive sections like 'Key Reminders' that repeat information already covered. The 'Overview' and 'When to Use' sections alone waste significant tokens on obvious context.

1 / 3

Actionability

The skill provides fully executable, copy-paste ready code throughout — from data loading through statistical testing, visualization, and export. Code examples are complete with proper imports, and the command-line script usage is concrete with specific flags and arguments.

3 / 3

Workflow Clarity

The workflow is clearly sequenced (Steps 1-6) and covers the full pipeline. However, there are no explicit validation checkpoints between steps — no verification that data loaded correctly, no check that the model fit succeeded, no validation before exporting results. For a multi-step analytical pipeline where errors can silently propagate (e.g., wrong data orientation, failed convergence), this is a notable gap.

2 / 3

Progressive Disclosure

The skill references external files (references/api_reference.md, references/workflow_guide.md, scripts/run_deseq2_analysis.py) which is good progressive disclosure structure. However, the main SKILL.md itself contains enormous amounts of inline content (troubleshooting, visualization code, multiple analysis patterns, quality metrics) that should be in those reference files rather than in the main body, undermining the purpose of having references.

2 / 3

Total

8

/

12

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

skill_md_line_count

SKILL.md is long (558 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

Total

9

/

11

Passed

Repository
K-Dense-AI/claude-scientific-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.