agentsclimarketplace

Differential metabolite abundance testing

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/differential-metabolite-abundance-testing

Curated, evidence-grounded skill and software-tool collections for scientific AI agents, generated by the AgenticScienceBuilder

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill differential-metabolite-abundance-testing

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 author says it does

Copied from the file, not written here

Use when you have preprocessed and normalized metabolite measurements from two or more distinct biological groups (e.

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

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

differential-metabolite-abundance-testing

License: restricted — no clear open-source license detected for the underlying tool; verify licensing before commercial use or redistribution. <!-- asb-license-banner -->

Summary

Apply statistical hypothesis testing to identify metabolites with significantly different abundance between two or more sample groups in a preprocessed MultiAssayExperiment object. This skill detects disease-specific or condition-specific metabolic signatures using Student's t-test with Benjamini-Hochberg multiple-testing correction.

When to use

You have preprocessed and normalized metabolite measurements from two or more distinct biological groups (e.g., tumor vs. normal, AKT1-high vs. MYC-high) in a MultiAssayExperiment object, and you want to identify which individual metabolites show statistically significant differences in abundance between groups. This is the appropriate entry point after quality control, imputation, and normalization are complete.

When NOT to use

  • Metabolite measurements have not yet been normalized and imputed — apply normalize_met and knn_impute first.
  • You are analyzing a single group or unpaired samples without a clear control or comparison group.
  • The input is already a filtered feature table of pre-selected metabolites; this skill is for unbiased testing across all measured metabolites.

Inputs

  • MultiAssayExperiment object containing normalized metabolite measurements
  • Sample group annotations (colData with group factor, e.g., 'tumor_groups')
  • Metabolite rowData with valid identifiers (metabolite names or IDs)

Outputs

  • Differential abundance test results table (metabolite name, unadjusted p-value, Benjamini-Hochberg adjusted p-value, difference in means, significance notation)
  • Ranked list of significantly different metabolites at chosen threshold

How to apply

Load the preprocessed MultiAssayExperiment object and subset samples to the groups of interest using the group factor (e.g., tumor_groups). Apply the MetaboDiff diff_test function with group_factors parameter set to the relevant column name and perform Student's t-test to compute p-values and mean differences for each metabolite. Apply Benjamini-Hochberg correction to all p-values to control for false discovery rate across the multiple metabolites tested. Extract the test results (unadjusted p-values, adjusted p-values, and effect sizes) from the metadata slot. Use standard significance thresholds (e.g., adjusted p < 0.05 or * / ** notation) to rank and report metabolites with the strongest evidence of differential abundance.

Related tools

  • MetaboDiff (Primary R package providing diff_test function for Student's t-test and p-value extraction from MultiAssayExperiment objects) — https://github.com/andreasmock/MetaboDiff
  • MultiAssayExperiment (Data container for storing and subsetting normalized metabolite assay data with associated sample and feature annotations)
  • R (Statistical computing environment for executing differential metabolomic analysis workflow)

Examples

diff_test(met, group_factors='tumor_groups')

Evaluation signals

  • Metabolites with known biological relevance to the comparison (e.g., Oleic acid, Arachidonic acid, Docohexaenoic acid in lipid metabolism studies) appear with expected significance thresholds (p < 0.05 adjusted).
  • Benjamini-Hochberg adjusted p-values are all ≥ unadjusted p-values and number of adjusted p-values < 0.05 is ≤ number of unadjusted p-values < 0.05.
  • Difference in means effect sizes are in the same direction and magnitude as biological expectations (e.g., higher abundance in one group vs. the other).
  • Summary table is complete with no missing p-values or effect size entries for tested metabolites.
  • Test results include both raw and adjusted p-values to enable two-level filtering (e.g., unadjusted p < 0.05 for exploratory review, adjusted p < 0.05 for stringent significance).

Limitations

  • Student's t-test assumes approximately normal distributions within groups; if normality is violated, results may be unreliable — check quality_plot and pca_plot before proceeding.
  • Benjamini-Hochberg correction assumes independence of metabolite tests; violation (e.g., correlated metabolites in same pathway) may inflate false discovery rate.
  • Small sample sizes per group reduce statistical power; effect sizes should be reported alongside p-values to distinguish true biological differences from noise.
  • Missing data imputed via knn_impute with cutoff=0.4 may introduce bias if missingness is non-random; results should be validated with sensitivity analysis.

Evidence

  • [methods] diff_test function application: "Apply diff_test function with group_factors='tumor_groups' to perform Student's t-test between the two groups with Benjamini-Hochberg p-value correction."
  • [methods] expected output format: "Extract test results (p-values and difference in means) from the metadata slot and verify that Oleic acid, Arachidonic acid, and Docohexaenoic acid appear with significance thresholds"
  • [intro] purpose of differential testing: "The MetaboDiff packages aims to provide a low-level entry to differential metabolomic analysis with R by starting off with the table of metabolite measurements."
  • [methods] Benjamini-Hochberg procedure: "The p-values are corrected for multiple testing by the Benjamini-Hochberg procedure."
  • [methods] MultiAssayExperiment data structure: "The function create_mae merges all objects into a so called MultiAssayExperiment object to simplify all downstream analysis."

What ships with it

Read from the repository

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

Keep looking

Skills are one crate of 326,984. 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.