matchms

Match mass spectra against reference libraries to identify compounds.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/Hung-3008/agusta --skill matchms-hung-3008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: matchms
Source: https://github.com/Hung-3008/agusta/tree/main/.agents/skills/matchms
Command: npx skills add https://github.com/Hung-3008/agusta --skill matchms-hung-3008

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Mass spectrometry data analysis is complex and time-consuming; this Skill provides a self-contained framework to load, harmonize, filter, and compare spectra to identify compounds via library matching.

Core Features & Use Cases

  • Import and standardize spectra from multiple formats (MGF, MSP, mzML, JSON)
  • Compute spectral similarities (CosineGreedy, ModifiedCosine, NeutralLossesCosine) and perform library matching
  • Build reproducible workflows with pipelines and metadata harmonization to support metabolomics studies
  • Real-world use case: identify unknown metabolites by matching query spectra against a curated library

Quick Start

Process a sample library and a set of queries with the default pipeline to obtain cosine-based matches.

Frequently Asked Questions about matchms

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

FAQPage Schema
How do I match mass spectra to a reference library for metabolite identification?

To match mass spectra for metabolite identification, you can load LC-MS/MS data, compute spectral similarity scores like CosineGreedy or ModifiedCosine, and compare query spectra against a curated reference library.

What mass spectrometry file formats can I import and standardize for metabolomics pipelines?

You can import and standardize mass spectrometry data from MGF, MSP, mzML, and JSON formats, harmonizing spectra metadata to build reproducible metabolomics pipelines and library search workflows.

Which spectral similarity scoring methods work best for LC-MS/MS library searching?

Spectral similarity scoring methods for LC-MS/MS library searching include CosineGreedy, ModifiedCosine, and NeutralLossesCosine, allowing you to match query spectra against reference libraries and identify unknown compounds.

Do I need a specific Python environment to process mass spectrometry data and perform spectral matching?

Yes, processing mass spectrometry data and performing spectral matching requires a Python environment with matchms installed, along with optional chemistry tools for molecular fingerprinting and InChI or SMILES derivations.

Can I build reproducible workflows for unknown metabolite identification from mass spectrometry data?

You can build reproducible workflows for unknown metabolite identification by loading query spectra, filtering and harmonizing metadata, and applying library matching with spectral similarity scoring to identify compounds.

What is the best way to filter and harmonize spectra metadata before computing spectral similarity?

The best way to filter and harmonize spectra metadata before computing spectral similarity is to import data from supported formats like MGF or mzML, standardize the metadata fields, and apply filtering to ensure consistent library matching results.