agentsclimarketplace

Spectral peak visualization

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/spectral-peak-visualization

Curated, evidence-grounded skill and software-tool collections for scientific AI agents, generated by the AgenticScienceBuilder

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill spectral-peak-visualization

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when you have a resolved mass spectrum (m/z values, intensities, and metadata) from a supported USI source (GNPS, MassBank, MetaboLights, Metabolomics Workbench, ProteoXchange, MS2LDA, or MassIVE) and need to create a publication-ready image that retains a link back to an interactive spectrum.

The file declares its own license as CC-BY-4.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

8.6 KB, as published. Nobody here has run it

spectral-peak-visualization

Summary

Generate embeddable static spectrum plots (PNG/SVG) from resolved mass spectrometry data, with optional peak annotations, filtering, and embedded hyperlinks or QR codes for publication integration and interactive spectrum viewer linking.

When to use

You have a resolved mass spectrum (m/z values, intensities, and metadata) from a supported USI source (GNPS, MassBank, MetaboLights, Metabolomics Workbench, ProteoXchange, MS2LDA, or MassIVE) and need to create a publication-ready image that retains a link back to an interactive spectrum visualization platform. Use this skill when publishing figures that must remain static in PDF/print but should provide readers a pathway to explore the raw spectrum interactively.

When NOT to use

  • Input spectrum is already rasterized or lossy-compressed (PNG/JPG); you cannot recover precise m/z and intensity values for re-rendering.
  • Target publication or platform does not support hyperlinks, QR codes, or external URL references (e.g., some legacy print-only workflows).
  • You need to perform spectral comparison, alignment, or clustering; use mirror matching or network analysis skills instead.

Inputs

  • Resolved USI identifier (string, e.g., 'mzspec:GNPS:TASK-xxx:scan:1943')
  • m/z array (numeric vector)
  • Intensity array (numeric vector)
  • Spectrum metadata (scan number, file name, accession, optional annotations)

Outputs

  • Static spectrum plot image (PNG or SVG file)
  • Embeddable image with embedded or adjacent hyperlink/QR code
  • Image file metadata or sidecar file containing interactive spectrum viewer URL

How to apply

Load the resolved spectrum data (m/z array and intensity array) from the USI resolver output or directly from a supported repository endpoint. Render a raster or vector plot of peaks and baseline intensity using a visualization library (matplotlib, plotly, or similar), specifying customizable parameters such as m/z range (mz_min, mz_max), maximum intensity scaling (max_intensity), peak annotation threshold (annotate_threshold), annotation precision (annotate_precision), and optional grid/label rotation. Generate or embed a unique URL pointing to the interactive spectrum viewer endpoint (e.g., metabolomics-usi.ucsd.edu/spectrum/?usi=...) or encode this URL into a QR code. Embed the URL or QR code into the image metadata or as a visible element (e.g., corner badge). Save the output as PNG (raster) or SVG (vector) with the embedded link intact so that downstream tools and readers can extract and follow the reference.

Related tools

Examples

![](https://metabolomics-usi.ucsd.edu/svg/?usi=mzspec:GNPS:TASK-c95481f0c53d42e78a61bf899e9f9adb-spectra/specs_ms.mgf:scan:1943&mz_min=550&mz_max=800&annotate_peaks=[[463.297,708.463,816.474]])

Evaluation signals

  • Output image file exists and is valid PNG/SVG format (can be opened in standard image viewers).
  • Embedded or sidecar URL points to a live, resolvable interactive spectrum viewer endpoint that displays the same m/z and intensity data.
  • Peak annotations (if requested) match the specified m/z values and respect the annotate_threshold; precision matches annotate_precision parameter.
  • Rendered m/z and intensity ranges match the input data after applying mz_min, mz_max, and max_intensity filters.
  • QR code (if present) is scannable and resolves to the interactive spectrum viewer URL.

Limitations

  • USI identifiers are based on draft standards ('mzdraft' prefix) and are subject to change; forward compatibility is not guaranteed.
  • Supported repositories are fixed (GNPS, MassBank, MetaboLights, Metabolomics Workbench, ProteoXchange, MS2LDA, MassIVE); spectra from other sources require pre-conversion to USI or custom resolver extension.
  • Embeddable images retain hyperlinks only if the publication platform, PDF reader, or downstream tool supports URL extraction and dereferencing; some legacy or restricted environments may strip or ignore embedded URLs.
  • Mirror matching visualization requires two USI identifiers; single-spectrum rendering does not support direct spectral comparison overlays within the image.

Evidence

  • [readme] Enable creation of embeddable images in publications that will link out to viewable/interactable spectrum plots.: "Enable creation of embeddable images in publications that will link out to viewable/interactable spectrum plots."
  • [other] The tool achieves embeddable image creation by resolving USI identifiers from supported sources and generating linked visual outputs for publication integration.: "The tool achieves embeddable image creation by resolving USI identifiers from supported sources (GNPS Molecular Networking, GNPS Spectral Libraries, ProteoXchange, MS2LDA, MassBank, MetaboLights, and"
  • [other] Render a static spectrum plot (peaks and baseline) as a raster image (PNG or SVG) using a plotting library.: "Render a static spectrum plot (peaks and baseline) as a raster image (PNG or SVG) using a plotting library."
  • [other] Generate or embed a unique URL or QR code that points to the interactive spectrum viewer endpoint.: "Generate or embed a unique URL or QR code that points to the interactive spectrum viewer endpoint."
  • [readme] 3rd party embedding for visualization of spectra that exist in repositories (e.g. MassIVE, PRIDE, PeptideAtlas).: "3rd party embedding for visualization of spectra that exist in repositories (e.g. MassIVE, PRIDE, PeptideAtlas)."
  • [readme] annotate_peaks: Defines which peaks in which spectrum (top or bottom) will be annotated. The parameters is a list of lists of m/z values of the peaks to be annotated.: "annotate_peaks: Defines which peaks in which spectrum (top or bottom) will be annotated. The parameters is a list of lists of m/z values of the peaks to be annotated."
  • [readme] These identifiers are based on draft USI and draft Metabolomics USI identifiers. Thus, they are subject to change: "These identifiers are based on draft USI and draft Metabolomics USI identifiers. Thus, they are subject to change, and so for the moment, they will be specified as mzdraft instead of mzspec"

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.