agentsclimarketplace

Lipid abundance differential analysis

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/lipid-abundance-differential-analysis

Use when you have a preprocessed and normalized lipid abundance matrix with batch identifiers and experimental group assignments, and you need to compare lipid levels across treatment conditions (e.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill lipid-abundance-differential-analysis

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as CC-BY-4.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

7.4 KB, ~1.1k tokens by cl100k_base, as published. Nobody here has run it

lipid-abundance-differential-analysis

Summary

Identifies differentially abundant lipids across simple and complex experimental designs by applying batch effect correction and statistical testing to normalized lipid abundance matrices. This skill enables detection of lipids with significant fold-changes while controlling for systematic batch variation and multiple-testing error.

When to use

Apply this skill when you have a preprocessed and normalized lipid abundance matrix with batch identifiers and experimental group assignments, and you need to compare lipid levels across treatment conditions (e.g., disease vs. control, or multi-factor designs) while accounting for known technical batch effects that could confound biological signals.

When NOT to use

  • Input is raw, unpreprocessed mass spectrometry data; use preprocessing and normalization steps first.
  • No batch structure is present in the experiment; batch correction is unnecessary and may introduce spurious corrections.
  • Samples lack explicit experimental group assignments or design is purely descriptive with no comparison groups defined.

Inputs

  • preprocessed normalized lipid abundance matrix (rows=lipids, columns=samples)
  • batch identifiers per sample
  • experimental group/treatment assignments per sample
  • experimental design metadata (e.g., multi-factor covariates, repeated measures structure)

Outputs

  • ranked differential lipid table (CSV format with columns: lipid_id, lipid_class, log2_fold_change, p_value, adjusted_p_value, batch_corrected_group_means)
  • filtered list of differentially abundant lipids meeting significance threshold
  • batch-corrected abundance estimates per lipid per group

How to apply

First, apply batch effect correction using ComBat or similar method to remove systematic batch variation while preserving biological signal in the normalized abundance matrix. Then perform differential abundance testing using limma or edgeR, which support complex experimental designs (multi-factor, repeated measures) and generate linear model estimates. Calculate log2 fold-change, raw p-values, and FDR-corrected p-values (adjusted p-value) for each lipid across all treatment group comparisons. Rank lipids by statistical significance and effect size, then filter for differentially abundant lipids meeting your significance threshold (typically adjusted p < 0.05). Finally, annotate results with lipid structural properties (class, chain length, saturation) and batch-corrected mean abundances per group for biological interpretation.

Related tools

  • ComBat (batch effect correction to remove systematic batch variation while preserving biological signal)
  • limma (linear modeling for differential abundance testing supporting complex experimental designs)
  • edgeR (differential abundance testing with support for complex experimental designs as alternative to limma)
  • ADViSELipidomics (Shiny application integrating batch correction, differential abundance testing, and visualization) — https://github.com/ShinyFabio/ADViSELipidomics
  • LIPID MAPS (lipid species classification and annotation of differential results)

Examples

library(ADViSELipidomics); run_ADViSELipidomics()  # or programmatically: limma::lmFit(batch_corrected_matrix, design_matrix) %>% limma::eBayes() to obtain log2_fc, p_value, adj.P.Val for each lipid

Evaluation signals

  • Batch effect correction visually removes systematic clustering by batch in PCA or heatmap plots while preserving group separation.
  • Adjusted p-values (FDR-corrected) follow expected distribution; false discovery rate control is demonstrated (e.g., q-value histogram peaked near 0).
  • Differentially abundant lipids show consistent direction and magnitude of fold-change across replicates within treatment groups after batch correction.
  • Ranked results include complete annotations (lipid class, chain length, saturation, batch-corrected means per group) enabling biological interpretation.
  • Comparison of results before and after batch correction shows that batch-corrected log2 fold-changes are more stable and replicate-consistent than uncorrected values.

Limitations

  • Batch effect correction (e.g., ComBat) may be ineffective if batch and biological group structure are confounded; experimental design must allow batch and treatment effects to be separable.
  • Linear models (limma, edgeR) assume normality and homogeneity of variance; heavily non-normal or zero-inflated lipid abundances may violate assumptions.
  • Complex experimental designs require explicit specification of the design matrix; incorrect specification will produce biased fold-change and p-value estimates.
  • Results depend critically on accurate batch assignment; missing or misclassified batch identifiers will lead to incomplete or erroneous batch correction.

Evidence

  • [intro] batch effect correction mechanism: "ADViSELipidomics implements a mechanism to identify differentially abundant lipids across simple and complex experimental designs by applying batch effect correction as part of the analysis workflow."
  • [other] workflow steps including batch correction and statistical testing: "Apply batch effect correction using ComBat or similar method to remove systematic batch variation while preserving biological signal. 3. Perform differential abundance testing using limma or edgeR"
  • [other] output format and annotation requirements: "Export ranked differential lipid table as CSV with columns: lipid_id, lipid_class, log2_fold_change, p_value, adjusted_p_value, batch_corrected_group_means."
  • [other] significance threshold specification: "filtering for differentially abundant lipids meeting significance threshold (adjusted p < 0.05)"
  • [readme] capability for complex designs: "it allows the identification of differentially abundant lipids in simple and complex experimental designs, dealing with batch effect correction."

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 326,871. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.