From agent-almanac
Interprets mass spectra from EI, ESI, MALDI, CI, APCI to identify molecular ions, formulas, fragmentation pathways, isotope patterns, and structures. For unknowns, synthesis confirmation, impurities.
npx claudepluginhub pjt222/agent-almanacThis skill uses the workspace's default tool permissions.
---
Plans spectroscopic analysis campaigns: defines analytical questions, assesses samples, selects techniques via decision matrix, sequences non-destructive to destructive methods, plans preparation, sets cross-validation criteria.
Processes mass spectrometry data for metabolomics: imports spectra from MGF/mzML/MSP/JSON, applies 40+ filters for peaks/metadata, computes cosine/modified cosine similarities for compound identification.
Processes MS spectra with matchms: imports mzML/MGF/MSP/JSON, filters/normalizes peaks, scores cosine/modified cosine/fingerprint similarities, matches unknowns to libraries for metabolite ID. Pairs with pyopenms for proteomics.
Share bugs, ideas, or general feedback.
Analyze mass spectra from any common ionization method to determine the molecular ion, molecular formula, fragmentation pathways, and structural features of the analyte.
Determine what species the spectrum contains before assigning peaks:
| Method | Energy | Primary Ion | Fragmentation | Typical Use |
|---|---|---|---|---|
| EI (70 eV) | Hard | M+. (radical cation) | Extensive | Small volatile molecules, GC-MS |
| CI | Soft | [M+H]+, [M+NH4]+ | Minimal | Molecular weight confirmation |
| ESI | Soft | [M+H]+, [M+Na]+, [M-H]- | Minimal | Polar, biomolecules, LC-MS |
| MALDI | Soft | [M+H]+, [M+Na]+, [M+K]+ | Minimal | Large molecules, polymers, proteins |
| APCI | Soft | [M+H]+, [M-H]- | Some | Medium polarity, LC-MS |
Expected: Ionization method documented, expected ion types listed, and adducts/clusters identified so the true molecular ion can be determined.
On failure: If the ionization method is unknown, examine the spectrum for clues: extensive fragmentation suggests EI, adduct patterns suggest ESI, and matrix peaks suggest MALDI. Consult the instrument log if available.
Identify the molecular ion peak and derive the molecular formula:
Expected: Molecular ion identified, molecular weight determined, nitrogen rule applied, and a molecular formula proposed (confirmed by HRMS if available).
On failure: If no molecular ion is visible in EI (common for thermally labile or highly branched compounds), try a softer ionization method. If the molecular ion is ambiguous, check for loss of common small fragments from the highest m/z peak (e.g., M-1, M-15, M-18 can help identify M).
Use isotopic signatures to detect specific elements:
| Element | Isotopes | M : M+2 Ratio | Visual Pattern |
|---|---|---|---|
| 35Cl / 37Cl | 35, 37 | 3 : 1 | Doublet, 2 Da apart |
| 79Br / 81Br | 79, 81 | 1 : 1 | Equal doublet, 2 Da apart |
| 2 Cl | -- | 9 : 6 : 1 | Triplet |
| 2 Br | -- | 1 : 2 : 1 | Triplet |
| 1 Cl + 1 Br | -- | 3 : 4 : 1 | Characteristic quartet-like |
Expected: Isotope pattern analyzed, presence or absence of Cl, Br, S, Si determined, and pattern consistent with the proposed molecular formula.
On failure: If isotope resolution is insufficient (low-resolution instrument), the M+2 pattern may be unresolvable. Note the limitation and rely on exact mass and other spectroscopic data for elemental composition.
Map the fragmentation pathways to extract structural information:
| Loss (Da) | Neutral Lost | Structural Implication |
|---|---|---|
| 1 | H. | Labile hydrogen |
| 15 | CH3. | Methyl group |
| 17 | OH. | Hydroxyl |
| 18 | H2O | Alcohol, carboxylic acid |
| 27 | HCN | Nitrogen heterocycle, amine |
| 28 | CO or C2H4 | Carbonyl or ethyl |
| 29 | CHO. or C2H5. | Aldehyde or ethyl |
| 31 | OCH3. or CH2OH. | Methoxy or hydroxymethyl |
| 32 | CH3OH | Methyl ester |
| 35/36 | Cl./HCl | Chlorinated compound |
| 44 | CO2 | Carboxylic acid, ester |
| 45 | OC2H5. | Ethoxy |
| 46 | NO2. | Nitro compound |
| m/z | Ion | Origin |
|---|---|---|
| 77 | C6H5+ | Phenyl cation |
| 91 | C7H7+ | Tropylium (benzyl rearrangement) |
| 105 | C6H5CO+ | Benzoyl cation |
| 43 | CH3CO+ or C3H7+ | Acetyl or propyl |
| 57 | C4H9+ or C3H5O+ | tert-Butyl or acrolein |
| 149 | Phthalate fragment | Plasticizer contaminant |
Expected: All major fragment ions assigned, neutral losses calculated and correlated with structural features, fragmentation tree constructed.
On failure: If fragments do not correspond to simple losses from the molecular ion, consider rearrangement processes. Unassigned fragments may indicate unexpected functional groups, impurities, or matrix/background peaks.
Evaluate the overall spectrum for purity indicators and assemble a structural proposal:
Expected: Purity assessed, contaminants identified if present, and a structural proposal (or ranked candidate list) consistent with all MS data and cross-validated where possible.
On failure: If the spectrum appears to contain multiple components and chromatographic separation was not used, flag the mixture and recommend LC-MS or GC-MS reanalysis. If no satisfactory structural proposal emerges, identify which additional data (HRMS, MS/MS, NMR) would resolve the ambiguity.
interpret-nmr-spectrum -- determine connectivity and hydrogen environments for structural confirmationinterpret-ir-spectrum -- identify functional groups that explain observed fragmentationinterpret-uv-vis-spectrum -- characterize chromophores in the analyteinterpret-raman-spectrum -- complementary vibrational analysisplan-spectroscopic-analysis -- select and sequence analytical techniques before data acquisitioninterpret-chromatogram -- analyze GC or LC chromatographic data coupled with MS