Breath biomarker discovery
Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/breath-biomarker-discovery
Use when you have GC–MS data from human breath samples and need to identify marker metabolites for disease diagnosis, phenotyping, or biomarker discovery without a predefined target list. Your data is noisy or conventional peak picking has produced high false-positive rates.From its SKILL.md
npx -y skills add HolobiomicsLab/asb-skill-collections --skill breath-biomarker-discoveryAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 15 stars15 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
8.4 KB, ~1.3k tokens by cl100k_base, as published. Nobody here has run it
breath-biomarker-discovery
License: restricted — no clear open-source license detected for the underlying tool; verify licensing before commercial use or redistribution. <!-- asb-license-banner -->
Summary
Automated identification of multivariate chemo-/biomarker features in untargeted GC–MS analysis of human breath samples using image processing and machine learning on two-dimensional MS maps (m/z vs retention time). This skill bypasses conventional peak picking to reduce false detections and enable detection at parts per billion levels.
When to use
You have GC–MS data from human breath samples and need to identify marker metabolites for disease diagnosis, phenotyping, or biomarker discovery without a predefined target list. Your data is noisy or conventional peak picking has produced high false-positive rates. You want to detect signals at very low abundance (ppb level) across the full m/z–retention time space simultaneously rather than targeting known compounds.
When NOT to use
- Your input is already a curated feature table or peak list; NPFimg operates on raw or minimally processed MS maps.
- You are performing targeted metabolomics with a predefined analyte list; NPFimg is designed for untargeted discovery.
- Your breath samples are from a disease or condition outside the validation scope (aroma odor and human breath); generalization to other matrices is untested.
Inputs
- GC–MS dataset from human breath samples (raw or processed as two-dimensional m/z vs retention time map)
- NetCDF or vendor-native MS data format containing chromatographic and mass spectrometric dimensions
Outputs
- Structured table of marker feature predictions with m/z values, retention times, and feature scores
- Visualization of identified marker features on the m/z–retention time space
- Discriminated analyte profiles without conventional peak picking artifacts
How to apply
Load the two-dimensional MS map (m/z vs retention time axes) from your breath GC–MS dataset into NPFimg. Apply the image processing and machine learning pipeline to process the MS map and discriminate analytes, which treats the chromatogram–MS space as an image rather than performing conventional peak picking. Use NPFimg's automated detection algorithm to identify marker features, outputting m/z values, retention times, and feature scores for each candidate biomarker. Visualize the identified markers on the m/z–retention time plane to confirm spatial coherence. Compare results against XCMS or other standard tools to validate lower error rates in both signal acquisition and marker identification; the paper reports NPFimg achieves superior reliability in this comparison.
Related tools
- NPFimg (Primary tool for image processing and machine learning-based marker feature identification on two-dimensional MS maps) — github.com/poomcj/NPFimg
- XCMS (Reference/comparison tool for conventional peak picking and marker identification; NPFimg demonstrates lower error rates in head-to-head evaluation)
Evaluation signals
- Identified marker features cluster spatially on the m/z–retention time plane, indicating they represent distinct analytes rather than noise artifacts.
- Feature scores and retention times are reproducible across replicate breath samples from the same subject.
- Comparison with XCMS output shows NPFimg produces fewer false-positive peaks and false-negative marker omissions, quantified by error rates.
- Detected m/z values and retention times match known breath metabolites or literature references at ppb-level sensitivity.
- Marker features export as a well-formed table with non-null m/z, retention time, and feature score columns; no missing values in critical fields.
Limitations
- Feasibility is demonstrated only on GC–MS breath data and aroma odor case studies; generalization to other breath disease states or sample matrices is not yet validated.
- The method requires well-resolved two-dimensional MS maps; highly complex mixtures with severe co-elution may degrade discrimination.
- No changelog or version history is available in the repository, limiting traceability of method refinements.
- The README indicates further details will be updated; current documentation is minimal and relies on the full published paper for methodology.
Evidence
- [intro] NPFimg processes a two-dimensional MS map (m/z vs retention time) to discriminate analytes and identify and visualize the marker features.: "NPFimg processes a two-dimensional MS map (m/z vs retention time) to discriminate analytes and identify and visualize the marker features."
- [intro] Our approach allows us to comprehensively characterize the signals in MS data without the conventional peak picking process, which suffers from false peak detections.: "Our approach allows us to comprehensively characterize the signals in MS data without the conventional peak picking process, which suffers from false peak detections."
- [intro] The feasibility of marker identification is successfully demonstrated in case studies of aroma odor and human breath on gas chromatography–mass spectrometry (GC–MS) even at the parts per billion level.: "The feasibility of marker identification is successfully demonstrated in case studies of aroma odor and human breath on gas chromatography–mass spectrometry (GC–MS) even at the parts per billion"
- [intro] Comparison with the widely used XCMS shows the excellent reliability of NPFimg, in that it has lower error rates of signal acquisition and marker identification.: "Comparison with the widely used XCMS shows the excellent reliability of NPFimg, in that it has lower error rates of signal acquisition and marker identification."
- [intro] NPFimg shows potential applicability to untargeted metabolomics of human breath.: "NPFimg shows potential applicability to untargeted metabolomics of human breath."
- [intro] NPFimg automatically identifies multivariate chemo-/biomarker features of analytes in chromatography–mass spectrometry (MS) data by combining image processing and machine learning.: "NPFimg automatically identifies multivariate chemo-/biomarker features of analytes in chromatography–mass spectrometry (MS) data by combining image processing and machine learning."
- [readme] We present a method named NPFimg, which automatically identifies multivariate chemo-/biomarker features of analytes in chromatography–mass spectrometry (MS) data by combining image processing and machine learning.: "We present a method named NPFimg, which automatically identifies multivariate chemo-/biomarker features of analytes in chromatography–mass spectrometry (MS) data by combining image processing and"
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.
Gives 0 of the 12 instructions most healthcare skills give in ~1.3k tokens
Counted across 147 of the 152 authors here whose files we hold, read 2026-08-07
- Export trial data to CSV formatin 11 of 147, across 2 files
- Retrieve trial details using an NCT IDin 11 of 147, across 2 files
- Split clinical datasets strictly by patientin 11 of 147, across 3 files
- Use the ClinicalTrials.gov API v2in 10 of 147, across 1 file
- Search trials by condition, drug, location, status or phasein 10 of 147, across 1 file
- Use maximum page size for bulk data retrievalin 10 of 147, across 1 file
- Extract and summarize key study informationin 10 of 147, across 1 file
- Combine multiple filters for targeted searchesin 10 of 147, across 1 file
- Print and review dataset statistics before modelingin 8 of 147, across 1 file
- Start model development with simple baselinesin 8 of 147, across 1 file
- Match preprocessing processors directly to data typesin 8 of 147, across 1 file
- Monitor validation metrics for task type and class imbalancein 8 of 147, across 1 file
Said here and by no other author read
- load two dimensional ms maps into NPFimg
- apply the image processing pipeline
- run automated marker feature detection
- output mass charge retention times and scores
- visualize markers on the mass retention plane
- validate results against standard tools
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.