# Rnaseq De

> Performs differential expression analysis on bulk RNA-seq or pseudo-bulk count matrices with QC, PCA, and contrast testing.

- Skill: `gabrielmoreira/rnaseq-de` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds add gabrielmoreira/rnaseq-de`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/rnaseq-de/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics, AI & ML, Data Analysis, SQL & Databases
- Tags: Bioinformatics, Count Matrix, Differential Expression, Ma Plot, Pca, Rna Seq, Volcano Plot
- License: MIT
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/gabrielmoreira/rnaseq-de

---


# 🧬 RNA-seq Differential Expression

This skill performs differential expression on bulk RNA-seq or pseudo-bulk count matrices.

## Core Capabilities

1. Input validation for count matrix and sample metadata
2. Pre-DE QC (library size, detected genes, low-count filtering)
3. PCA visualisation on normalized expression
4. Differential expression from formula + contrast
5. Volcano and MA plots
6. Markdown report with reproducibility files

## Input Contract

- Count matrix (`.csv` or `.tsv`): rows are genes, columns are samples, first column is gene identifier
- Metadata table (`.csv` or `.tsv`): one row per sample, must include `sample_id`
- Formula: e.g. `~ condition` or `~ batch + condition`
- Contrast: `factor,numerator,denominator` (e.g. `condition,treated,control`)

## Output Structure

```
rnaseq_de_report/
├── report.md
├── figures/
│   ├── pca.png
│   ├── volcano.png
│   └── ma_plot.png
├── tables/
│   ├── qc_summary.csv
│   ├── normalized_counts.csv
│   └── de_results.csv
└── reproducibility/
    ├── commands.sh
    ├── environment.yml
    └── checksums.sha256
```

## Usage

```bash
python rnaseq_de.py \
  --counts counts.csv \
  --metadata metadata.csv \
  --formula "~ batch + condition" \
  --contrast "condition,treated,control" \
  --output report_dir
```

## Safety

- Local-only processing
- Warn before overwriting existing output
- Report-level disclaimer required