matchms

Match mass spectra to reference libraries using configurable similarity metrics and MGF/MSP/JSON formats.

48|6|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/qinyan-ai/qinyan-academic-skills --skill matchms-qinyan-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: matchms
Source: https://github.com/qinyan-ai/qinyan-academic-skills/tree/main/skills/06-%E5%8C%96%E5%AD%A6%E4%BF%A1%E6%81%AF%E4%B8%8E%E8%8D%AF%E7%89%A9%E5%8F%91%E7%8E%B0/matchms
Command: npx skills add https://github.com/qinyan-ai/qinyan-academic-skills --skill matchms-qinyan-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Mass spectrometry data analysis is often bottlenecked by manual, error-prone spectral library matching; MatchMS offers an automated framework to identify compounds by comparing spectra against reference libraries.

Core Features & Use Cases

  • Import/export mass spectrometry data in standard formats (MGF, MSP, GNPS JSON)
  • Compute diverse spectral and structural similarities (CosineGreedy, ModifiedCosine, NeutralLossesCosine, FingerprintSimilarity)
  • Build reproducible analysis pipelines and perform large-scale library searches for unknown spectra
  • Enrich spectra with chemical information and annotate compounds to support downstream interpretation
  • Use cases include metabolite identification, library searching, quality control, and comparative studies.

Quick Start

Install matchms, load your library and query spectra, then run a CosineGreedy search to identify unknown compounds.

Frequently Asked Questions about matchms

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

FAQPage Schema
How do I identify unknown metabolites from mass spectrometry data?

To identify unknown metabolites from mass spectrometry data, you can match query spectra against reference libraries using automated spectral matching. This process compares your experimental mass spectra to known references for high-throughput compound annotation.

What mass spectrometry data formats can I import for spectral matching?

For spectral matching, you can import and export mass spectrometry data in standard formats including MGF, MSP, and GNPS JSON. These formats allow you to load reference libraries and query spectra to identify unknown compounds.

Which similarity metrics are best for mass spectrometry library search?

For mass spectrometry library search, you can compute similarities using CosineGreedy, ModifiedCosine, NeutralLossesCosine, or FingerprintSimilarity metrics. These diverse spectral and structural similarity calculations support accurate compound identification.

Can I build a reproducible pipeline for high-throughput metabolomics workflows?

Yes, you can build reproducible analysis pipelines for high-throughput metabolomics workflows. These pipelines perform large-scale library searches to annotate unknown spectra and enrich them with chemical information to support downstream interpretation.

Does this spectral matching approach work for comparative metabolomics studies?

Yes, spectral matching supports comparative metabolomics studies. Use cases include metabolite identification, library searching, quality control, and comparative studies by applying flexible processing pipelines across your mass spectrometry data.

Why should I use automated spectral matching instead of manual library searching?

Automated spectral matching accelerates compound identification by replacing manual, error-prone library comparisons. It provides a reproducible framework to match mass spectra against reference libraries, ensuring high-throughput and accurate annotation of unknowns.