agentsclimarketplace

Ms2 fragment pattern recognition

Skill HolobiomicsLab/asb-skill-collections/packs/metabolomics/lc-ms/skills/ms2-fragment-pattern-recognition

Use when you have data-dependent acquisition (DDA) MS2 spectra from HRMS measurements (ESI or APCI ionization) and need to prioritize potential PFAS features from a large pool of detected ions.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill ms2-fragment-pattern-recognition

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

  • 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.1 KB, ~1.3k tokens by cl100k_base, as published. Nobody here has run it

MS2 Fragment Pattern Recognition

Summary

Identifies and annotates diagnostic fragment patterns in tandem MS (MS2) spectra by computing characteristic mass differences between precursor and fragment ions, enabling prioritization of PFAS features in non-target HRMS workflows. This skill leverages fragment mass losses (e.g., CF₂ losses) and perfluoroalkyl chain signatures to screen and rank potential PFAS compounds.

When to use

Apply this skill when you have data-dependent acquisition (DDA) MS2 spectra from HRMS measurements (ESI or APCI ionization) and need to prioritize potential PFAS features from a large pool of detected ions. Use it specifically when vendor-independent mzML files with centroided MS2 spectra are available and you seek to combine fragment-level evidence with other prioritization approaches (MD/C-m/C, Kendrick mass defect) to rank candidates by chemical plausibility.

When NOT to use

  • Input spectra are profile (not centroided) mode — profile spectra require deconvolution before reliable mass difference computation.
  • MS2 data were acquired in data-independent acquisition (DIA) or MS1-only mode — diagnostic fragment patterns require high-resolution MS2 spectra paired to precursor ions.
  • Feature list is already curated or suspect-screened by external software — this skill is most valuable for untargeted discovery and de novo prioritization, not confirmation of known compounds.

Inputs

  • Centroided DDA MS2 spectra in mzML format (vendor-independent)
  • Feature detection results (m/z, retention time, precursor ion list)
  • Precursor ion m/z values with associated MS2 fragment lists

Outputs

  • Per-feature annotation table with diagnostic fragment assignments
  • Diagnostic fragment count and mass difference values per feature
  • Prioritization scores or flags based on fragment pattern matches
  • Annotated MS2 spectra with highlighted diagnostic fragment mass differences

How to apply

For each detected feature, extract all associated MS2 fragment m/z values from the DDA spectrum. Compute mass differences between the precursor ion m/z and each fragment m/z to detect characteristic losses (e.g., CF₂ = 50.0 Da, CF₃ or C₂F₅ losses). Match observed mass differences against a library of known PFAS diagnostic fragment patterns, recording both the mass difference values and the fragment count per feature. Annotate each feature with matched diagnostic fragments and report the diagnostic fragment count in a per-feature output table. Features with multiple characteristic PFAS fragment losses and CF₂-chain evidence receive higher priority scores in downstream filtering.

Related tools

  • pyOpenMS (Extract centroided MS2 fragment m/z values and precursor-fragment associations from mzML spectra) — https://github.com/OpenMS/OpenMS
  • PFΔScreen (Integrated platform applying MS2 fragment pattern recognition alongside MD/C-m/C and KMD analysis for PFAS prioritization) — https://github.com/JonZwe/PFAScreen
  • MSConvert (Convert vendor mass spectrometry raw files to vendor-independent mzML format for input to fragment analysis)

Evaluation signals

  • All precursor–fragment mass differences are computed and reported without missing or NaN values for valid centroided spectra.
  • Diagnostic fragment assignments match known PFAS characteristic losses (e.g., CF₂ within ±5 ppm mass tolerance, CF₃ or perfluoroalkyl chain fragments).
  • Features with multiple diagnostic fragments (≥2 characteristic mass differences) receive higher priority scores than features with zero or single matches.
  • MS2 spectra visualization confirms that highlighted fragment mass differences correspond to actual peaks in the centroided data.
  • Diagnostic fragment counts and mass difference annotations are correctly linked to precursor m/z in the output table without row misalignment.

Limitations

  • Fragment mass difference approach is most sensitive for PFAS with characteristic perfluorinated chains; compounds with partial fluorination or non-standard PFAS scaffolds may yield fewer diagnostic matches.
  • Centroiding artifacts or low-abundance fragments may be missed if MS2 signal intensity falls below noise threshold; performance depends on instrument resolution and acquisition settings.
  • Requires data-dependent acquisition with one collision energy per precursor; variable collision energies or dynamic settings may produce inconsistent fragment patterns across features.
  • Mass difference tolerance (e.g., ±5 ppm) must be tuned empirically; overly strict tolerances may cause false negatives; overly permissive tolerances may cause false positives and interfere with non-PFAS fragment matches.

Evidence

  • [other] For each detected feature, extract all associated MS2 fragment m/z values. Search for diagnostic fragment patterns by computing mass differences between precursor and fragment ions.: "For each detected feature, extract all associated MS2 fragment m/z values. Search for diagnostic fragment patterns by computing mass differences between precursor and fragment ions."
  • [other] Identify characteristic fragment mass differences indicative of PFAS compounds (e.g., CF2 loss, perfluoroalkyl chain fragments).: "Identify characteristic fragment mass differences indicative of PFAS compounds (e.g., CF2 loss, perfluoroalkyl chain fragments)."
  • [other] Annotate each feature with matched diagnostic fragments and mass difference values. Output per-feature hit table with diagnostic fragment assignments and diagnostic fragment counts.: "Annotate each feature with matched diagnostic fragments and mass difference values. Output per-feature hit table with diagnostic fragment assignments and diagnostic fragment counts."
  • [intro] PFΔScreen uses several techniques for prioritization such as the MD/C-m/C approach, Kendrick mass defect (KMD) analysis and fragment mass differences and diagnostic fragments in the MS2 data: "PFΔScreen uses several techniques for prioritization such as the MD/C-m/C approach, Kendrick mass defect (KMD) analysis and fragment mass differences and diagnostic fragments in the MS2 data"
  • [readme] Raw mass spectrometric data can be included vendor-independently in the mzML format (data-dependent acquisition with centroided spectra, mzML files can be generated via the MSConvert software tool).: "Raw mass spectrometric data can be included vendor-independently in the mzML format (data-dependent acquisition with centroided spectra, mzML files can be generated via the MSConvert software tool)."
  • [readme] Afterwards, MS2 spectra displayed by the RawDataVisualization tool (MS2 extractor), have highlighted fragment mass differences and diagnostic fragments, if some were detected.: "Afterwards, MS2 spectra displayed by the RawDataVisualization tool (MS2 extractor), have highlighted fragment mass differences and diagnostic fragments, if some were detected."

What ships with it

Read from the repository

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

Keep looking

Skills are one crate of 325,949. 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.