From agent-almanac
Interprets mass spectra to determine molecular formula, identify fragmentation pathways, and propose molecular structures from common ionization methods.
How this skill is triggered — by the user, by Claude, or both
Slash command
/agent-almanac:interpret-mass-spectrumThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Analyze mass spectra from any common ionization method to determine the molecular ion, molecular formula, fragmentation pathways, and structural features of the analyte.
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 MSnpx claudepluginhub pjt222/agent-almanacProcesses mass spectrometry data: imports spectra (mzML, MGF, MSP, JSON), applies 40+ filters, and computes similarity scores (cosine, modified cosine) for metabolite identification and spectral library searching.
Selects and designs spectroscopic analysis methods (UV-Vis, IR, NMR, MS, Raman) including sample prep, calibration, interpretation, and reporting for structural identification or quantitation.
Guides users through designing a spectroscopic analysis campaign: defining questions, selecting techniques with a decision matrix, planning sample preparation, and sequencing analyses.