Quality control threshold optimization
Curated, evidence-grounded skill and software-tool collections for scientific AI agents, generated by the AgenticScienceBuilder
npx -y skills add HolobiomicsLab/asb-skill-collections --skill quality-control-threshold-optimizationAssembled 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 when you have extracted a peak feature table (CSV or tabular format) with mass-to-charge ratios, retention times, and intensity values across multiple samples, and you need to distinguish genuine differential metabolic signals from instrumental noise or low-abundance background before.
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.1 KB, 862 tokens by cl100k_base, as published. Nobody here has run it
Quality Control Threshold Optimization
Summary
A systematic approach to filter extracted mass spectrometry peak features by applying signal-to-noise thresholds and feature prevalence criteria to identify differential metabolic ion peaks suitable for downstream metabolite identification. This skill bridges raw peak extraction and statistical annotation by removing low-abundance or noisy peaks that would confound group-wise comparisons.
When to use
When you have extracted a peak feature table (CSV or tabular format) with mass-to-charge ratios, retention times, and intensity values across multiple samples, and you need to distinguish genuine differential metabolic signals from instrumental noise or low-abundance background before performing statistical group comparisons or metabolite identification.
When NOT to use
- Input data is already a curated, vendor-validated metabolite list rather than raw extracted peaks
- Analysis goal is untargeted feature discovery without group-wise comparison (threshold optimization is predicated on differential signal detection)
- Peak table has already undergone aggressive filtering by upstream preprocessing; re-filtering risks removing true signal
Inputs
- Peak feature table (CSV or tabular format) with mass-to-charge ratios, retention times, and intensity values
- Experimental group assignments for all samples
- Signal-to-noise threshold parameters
- Feature prevalence thresholds (minimum sample detection fraction)
Outputs
- QC-filtered peak feature table with passing features annotated
- QC filter application log (which thresholds were applied to each feature)
- Differential intensity summary statistics (fold-change and/or p-values for group comparisons)
How to apply
Load the extracted peak feature table and sequentially apply two classes of quality control filters: (1) abundance and noise filters using signal-to-noise thresholds to remove low-intensity or noisy peaks, and (2) feature prevalence criteria to exclude peaks present in only a small subset of samples. After filtering, identify peaks with significant differential intensity patterns between experimental groups using statistical comparison methods (fold-change or p-value thresholds). Retain only candidate peaks that pass all QC criteria and export the filtered table with annotations documenting which QC filters were applied and which peaks survived. The rationale is that removing noisy, low-abundance, or sporadically detected features reduces false positives in downstream metabolite annotation while preserving genuine differential signals.
Related tools
- MetaQC (Applies quality control filtering to extracted peak features according to signal-to-noise and prevalence thresholds) — https://github.com/zjuRong/openNAU
- MARC (Performs downstream metabolite annotation and reference database matching on QC-filtered peaks) — https://github.com/zjuRong/openNAU
Evaluation signals
- QC-filtered feature table has fewer rows than input (low-abundance and noisy peaks removed)
- Exported feature table includes explicit annotations documenting which QC filters were applied to each peak
- Differential peaks identified show statistically significant fold-change or p-value signals that would be confounded if low-abundance noise were retained
- Signal-to-noise ratio distribution of retained peaks is visibly shifted toward higher quality compared to discarded peaks
- Feature prevalence of retained peaks meets or exceeds the specified threshold in a minimum fraction of samples per group
Limitations
- Threshold selection (signal-to-noise cutoff, prevalence fraction, fold-change/p-value bounds) is not fully automated and requires expert review or prior knowledge of expected metabolite abundance ranges
- Aggressive thresholds may remove rare or condition-specific metabolites that have genuine biological significance despite low or sporadic detection
- Quality control filtering is most effective when sample replication is adequate; sparse or unbalanced group designs reduce statistical power for differential detection
Evidence
- [intro] extraction and filtering rationale: "It includes the extraction of raw mass data and quality control for the identification of differential metabolic ion peaks."
- [other] workflow steps for filtering: "Apply quality control filters to remove low-abundance or noisy peaks according to signal-to-noise thresholds and feature prevalence criteria."
- [other] differential detection method: "Identify peaks with significant differential intensity patterns between experimental groups using statistical comparison (e.g., fold-change or p-value thresholds)."
- [other] output documentation requirement: "Export the QC-filtered feature table with annotations indicating which QC filters were applied and which peaks survive for downstream identification."
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.