matchms

Compare unknown mass spectra to reference libraries using matchms similarity scoring.

1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/SciMate-AI/scicli --skill matchms-scimate-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: matchms
Source: https://github.com/SciMate-AI/scicli/tree/main/internal/skills/bundled/claude-scientific-skills/skills/matchms
Command: npx skills add https://github.com/SciMate-AI/scicli --skill matchms-scimate-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Mass spectrometry spectral matching for metabolomics: identifies unknowns by comparing experimental spectra to a reference library and annotating chemical information.

Core Features & Use Cases

  • Import and harmonize metadata from common formats (MGF, MSP, mzML) for consistent comparisons.
  • Compute multiple spectral similarity metrics (CosineGreedy, CosineHungarian, ModifiedCosine, NeutralLossesCosine) and optional structural fingerprints for improved ranking.
  • Facilitate end-to-end workflows: library matching, QC, annotation, and reproducible pipelines.

Quick Start

Run a processing pipeline to compute cosine similarity between a reference library and a set of queries.

Frequently Asked Questions about matchms

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

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

Spectral matching identifies unknowns by scoring experimental spectra against a reference library. You can compute similarity using CosineGreedy, ModifiedCosine, or NeutralLossesCosine to annotate chemical information and rank potential matches.

Can I import and normalize MGF and MSP files for metabolomics library search?

Yes, you can import MGF, MSP, and mzML files. Metadata harmonization applies default filters, normalization, and peak filtering to ensure consistent spectral comparisons across different file formats in your metabolomics pipeline.

What is the difference between CosineGreedy and ModifiedCosine for spectral similarity?

CosineGreedy computes standard cosine similarity, while ModifiedCosine allows matching peaks with shifted precursor masses. NeutralLossesCosine adds neutral loss comparisons, and structural fingerprinting can further improve metabolite ranking accuracy.

Does matchms support mzML format for metabolite annotation workflows?

Yes, mzML is supported alongside MGF and MSP. The processing pipeline harmonizes metadata from these formats to facilitate end-to-end workflows including library matching, quality control, and reproducible metabolite annotation.

How do I build a reproducible spectral matching pipeline for metabolomics?

Apply a standard processing pipeline with default_filters, normalization, peak filtering, and a chosen similarity function. Optional fingerprinting and validation steps can be added to ensure reproducible library curation and annotation results.

When should I use NeutralLossesCosine instead of standard cosine similarity?

NeutralLossesCosine is useful when comparing spectra where neutral losses carry diagnostic structural information. It complements CosineGreedy and ModifiedCosine by scoring similarity based on fragmentation patterns beyond direct peak matching.