matchms-spectral-matching

Match unknown MS/MS spectra against spectral libraries using matchms similarity scoring.

298|27|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/jaechang-hits/SciAgent-Skills --skill matchms-spectral-matching
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: matchms-spectral-matching
Source: https://github.com/jaechang-hits/SciAgent-Skills/tree/main/skills/proteomics-protein-engineering/matchms-spectral-matching
Command: npx skills add https://github.com/jaechang-hits/SciAgent-Skills --skill matchms-spectral-matching

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires matchms, numpy, pandas, rdkit, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the identification of unknown metabolites by comparing their mass spectrometry (MS/MS) data against extensive spectral libraries, streamlining the process of chemical analysis.

Core Features & Use Cases

  • Spectral Matching: Compares query spectra against reference libraries using various similarity algorithms (e.g., Cosine, Modified Cosine).
  • Metabolite Identification: Identifies unknown compounds by finding the best spectral matches in databases.
  • Data Processing: Imports, filters, and normalizes spectral data from common formats (mzML, MGF, MSP, JSON).
  • Use Case: You have an MS/MS spectrum of an unknown compound detected in a biological sample. Use this Skill to query a spectral library and identify the compound, providing its name, structure, and confidence score.

Quick Start

Use the matchms-spectral-matching skill to identify unknown spectra from 'unknowns.mgf' against the library 'reference_library.mgf' using modified cosine similarity.

Frequently Asked Questions about matchms-spectral-matching

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

FAQPage Schema
How do I identify unknown metabolites from MS/MS spectra against a reference library?

Mass spectrometry spectral matching identifies unknown metabolites by comparing query MS/MS spectra against curated reference libraries. By calculating similarity scores like modified cosine, it matches unknown compounds to known structures, providing names and confidence scores for biological samples.

What mass spectrometry file formats can I use for metabolite spectral matching?

Spectral matching supports importing, filtering, and normalizing mass spectrometry data from mzML, MGF, MSP, and JSON file formats. This allows you to process query MS/MS spectra and compare them against curated reference libraries for metabolite identification.

What similarity scoring algorithms are available for MS/MS spectral matching?

Available similarity scoring algorithms for MS/MS spectral matching include Cosine and Modified Cosine. These functions calculate similarity scores between query mass spectrometry spectra and reference libraries, enabling accurate and reproducible metabolite identification.

Can I filter and normalize mass spectrometry data before matching against a spectral library?

Yes, you can filter and normalize mass spectrometry data before spectral matching. The data processing capabilities support importing raw MS/MS spectra from formats like mzML and MSP, applying advanced filtering and normalization to ensure accurate metabolite identification.

Does matchms work with mzML and MSP files for metabolomics data processing?

Yes, matchms supports mzML and MSP files for metabolomics data processing, alongside MGF and JSON formats. It handles importing, filtering, and normalizing mass spectrometry data to prepare unknown MS/MS spectra for matching against reference libraries.