matchms Mass Spectra Toolkit
A skill for cleaning, filtering, comparing, and library-searching MS/MS spectra with the current matchms 0.33.1 API.
Data & AnalyticsAdvanced★ 33,030⑂ 3,248AI score 8/10Last updated: Aug 9, 2026
What it does
- Loads and exports tandem MS data in MGF, MSP, mzML, mzXML, JSON, mzSpecLib, and metabolomics-USI formats.
- Harmonizes metadata, handles precursor/adduct fields, and builds consistent peak-processing pipelines with
SpectrumProcessor. - Guides the choice of similarity metric — cosine, modified cosine, neutral losses, BLINK, FlashSimilarity (entropy) — and builds score matrices.
- Covers library search, top-hit extraction, sparse precursor gating, and molecular similarity networks.
- Fixes breakages from pre-0.33 tutorials:
ModifiedCosineremoval, deprecatedadd_losses(), tuple return fromprocess_spectra(), structuredStackedSparseArrayscores.
Who it's for
- Metabolomics and natural-product researchers running MS/MS library searches.
- Python users building molecular networking or spectral-similarity pipelines.
- Anyone migrating older matchms code to the current API.
Example uses
- "Search queries.mgf against library.msp with modified cosine at 0.02 tolerance, keep the top 5 hits, export CSV" — uses the bundled
scripts/library_search.py. - "Apply identical preprocessing (normalize, 1% relative-intensity cut, min 5 peaks) to both references and queries, then compute the score matrix."
- "Estimate the pair count before an all-vs-all comparison and pre-filter candidates with PrecursorMzMatch."
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/HEAD/skills/matchms/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/matchms folder from the GitHub repo K-Dense-AI/scientific-agent-skills into my ~/.claude/skills/matchms/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git && mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/matchms ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy just this skill:
cp -r scientific-agent-skills/skills/matchms ~/.claude/skills/ - Prepare a Python 3.10–3.14 environment and install the pinned release:
uv pip install "matchms==0.33.1" - Verify it:
uv run python -c "import matchms; print(matchms.__version__)" - Restart Claude Code and try a prompt like "search my MGF queries against this MSP library" to trigger the skill.
View source on GitHub ↗License: MIT