matchms

Standardize mass spectrometry spectra and compute similarity scores for compound identification.

21|2|Updated Dec 8, 2025
One-click install
npx skills add https://github.com/silverstein/claude-scientific-skills-desktop --skill matchms-silverstein
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: matchms
Source: https://github.com/silverstein/claude-scientific-skills-desktop/tree/main/corpus/matchms
Command: npx skills add https://github.com/silverstein/claude-scientific-skills-desktop --skill matchms-silverstein

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you standardize mass spectrometry spectra, compute spectral similarity, and turn messy MS data into consistent, reproducible metabolomics workflows.

Core Features & Use Cases

  • Import & export common MS formats: Load spectra from mzML/mzXML, MGF, MSP, JSON (GNPS), and USI, then save processed outputs back to these formats.
  • Filtering, normalization, and QC: Harmonize metadata, normalize peak intensities, remove precursor-region peaks, and enforce quality constraints like minimum peak counts.
  • Similarity scoring for compound identification: Match query spectra to reference libraries using cosine-based and precursor-aware scoring, including neutral-loss comparisons and structural fingerprint similarity.
  • Use Case: You have an unknown set of LC-MS/MS spectra and a reference spectral library; normalize both, filter out low-quality spectra, compute cosine/modified-cosine similarity, and retrieve top candidate matches per query.

Quick Start

Tell the assistant: "Load my MGF spectra, apply default preprocessing, compute cosine and modified-cosine similarity against my reference library, and return the top 10 matches for each query."

Frequently Asked Questions about matchms

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I match unknown mass spectrometry spectra against a reference library?

To match unknown mass spectrometry spectra against a reference library, you import query and reference data, apply preprocessing like metadata harmonization and peak filtering, then compute cosine or modified-cosine similarity scores to retrieve top candidate matches.

Can I import and export mzML, MGF, and MSP files for metabolomics analysis?

Yes, you can import and export mzML, mzXML, MGF, MSP, JSON, and USI formats for metabolomics analysis. This allows you to load raw spectral data, process it, and save the cleaned outputs back into your required MS data formats.

What is spectral similarity scoring and how does it support compound identification?

Spectral similarity scoring compares normalized query spectra to reference libraries using cosine-based and precursor-aware scoring, including neutral-loss comparisons, to accurately rank and identify compounds in metabolomics workflows.

How do I normalize peak intensities and filter low-quality MS spectra?

You normalize peak intensities and filter low-quality MS spectra by applying preprocessing constraints that remove precursor-region peaks, harmonize metadata, and enforce minimum peak counts to ensure consistent, reproducible spectral data.

Does precursor-aware scoring work with neutral-loss comparisons for LC-MS/MS data?

Yes, precursor-aware scoring works with LC-MS/MS data by utilizing neutral-loss comparisons and structural fingerprint similarity alongside modified-cosine scoring to improve compound identification accuracy during library matching.