agentsclimarketplace

Fragmentation pattern spectral matching

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/fragmentation-pattern-spectral-matching

Use when when you have detected m/z values from LC-IM-MS/MS that match a candidate CCS prediction database but require structural confirmation. Apply this skill to disambiguate isomers (e.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill fragmentation-pattern-spectral-matching

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

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

fragmentation-pattern-spectral-matching

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

Summary

Match experimental MS/MS fragmentation spectra against theoretical or database spectra to confirm molecular structure identity and isomer stereochemistry. This skill filters candidate identifications by spectral similarity and fragmentation pattern coherence, enabling high-confidence assignment of sterol isomers in LC-IM-MS/MS data.

When to use

When you have detected m/z values from LC-IM-MS/MS that match a candidate CCS prediction database but require structural confirmation. Apply this skill to disambiguate isomers (e.g., sterol double-bond position and stereochemistry) that have identical or near-identical m/z and CCS values but produce distinguishable fragmentation patterns under MS/MS ionization.

When NOT to use

  • When input is already a curated sterol metabolite library or authenticated reference spectrum collection — no additional matching is needed.
  • When experimental MS/MS spectra are of poor signal-to-noise ratio or heavily fragmented such that major diagnostic peaks are absent — spectral matching will be unreliable.
  • When sterol candidates differ only in fatty-acid chain composition (not double-bond position or stereochemistry) — MS/MS fragmentation patterns may be too similar to discriminate.

Inputs

  • Experimental MS/MS fragmentation spectrum (m/z, intensity pairs) for a detected feature
  • Theoretical MS/MS fragmentation spectra database indexed by sterol structure and N-Me fragmentation pattern
  • CCS-filtered candidate list (m/z and structure proposals pre-selected by ion mobility and mass accuracy)

Outputs

  • Annotated sterol identification records (structure, double-bond position, stereochemistry)
  • Fragmentation pattern match scores (e.g., cosine similarity or equivalent metric)
  • Composite confidence score combining CCS and spectral match quality
  • Tissue-specific quantitative sterol data (intensity linked to matched feature)

How to apply

After m/z matching and CCS tolerance filtering, extract the experimental MS/MS fragmentation spectrum for each candidate feature. Compare it against theoretical MS/MS spectra generated from N-Me derived fragmentation patterns using RDKit-based MS/MS calculation that models double-bond position-specific cleavage. Score spectral similarity using a standard metric (e.g., cosine similarity or dot product). Filter candidates to retain only those whose fragmentation pattern match quality exceeds a defined threshold (specific cutoff not disclosed in article); use the quality of spectral match as a confidence scoring component alongside CCS match quality. Annotate the final identification with the matched sterol structure (including double-bond position and stereochemistry) and a composite confidence score reflecting both CCS and spectral agreement.

Related tools

  • RDKit (MS/MS calculation engine that recognizes double bond positions and generates theoretical fragmentation spectra based on N-Me derived fragmentation rules for sterol lipids)
  • Python (Primary scripting language for implementing fragmentation pattern matching and spectral similarity scoring) — https://github.com/Chen-micslab/QCCAssisted4DSterol
  • Jupyter Notebook (Notebook environment in which fragmentation pattern matching functions are implemented and executed) — https://github.com/Chen-micslab/QCCAssisted4DSterol

Evaluation signals

  • Spectral match score for accepted identifications should be well above random baseline (i.e., substantially higher than matches to unrelated sterol structures)
  • Identified sterol structures should exhibit fragmentation patterns consistent with known N-Me cleavage rules (e.g., breaks flanking or adjacent to double-bond positions)
  • Confidence scores derived from fragmentation matching should correlate with external validation (e.g., reference standards or orthogonal chromatographic methods) where available
  • Rejected candidates should show spectral match scores below threshold, with fragmentation patterns inconsistent with assigned structure
  • Identified sterol isomers with different double-bond positions or stereochemistry should produce visibly distinct MS/MS spectra in diagnostic peak positions

Limitations

  • The skill is only validated on N-Me derived unsaturated sterol lipids; applicability to other sterol modifications or lipid classes is untested
  • Spectral matching relies on the completeness and accuracy of the theoretical MS/MS database; missing or mis-calculated fragmentation patterns will reduce sensitivity
  • Isomers with very similar fragmentation patterns (e.g., long-chain aliphatic sterols differing only in chain length) may not be resolved by MS/MS matching alone
  • The specific spectral match threshold and confidence scoring formula are not provided in the article; implementation requires parameter optimization on reference data

Evidence

  • [other] Filter candidate identifications by CCS tolerance and MS/MS fragmentation pattern matching.: "Filter candidate identifications by CCS tolerance and MS/MS fragmentation pattern matching."
  • [readme] The script recognises double bond positions and generates MS/MS based on N-Me fragmentation patterns.: "The script recognises double bond positions and generates MS/MS based on N-Me fragmentation patterns."
  • [other] Annotate matched features with sterol structure (including double-bond position and stereochemistry) and assign confidence scores based on CCS and spectral match quality.: "Annotate matched features with sterol structure (including double-bond position and stereochemistry) and assign confidence scores based on CCS and spectral match quality."
  • [readme] The script is written on the basis of RDkit's built-in functions.: "The script is written on the basis of RDkit's built-in functions."

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.