From agent-almanac
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.
npx claudepluginhub pjt222/agent-almanacThis skill uses the workspace's default tool permissions.
---
Interprets IR spectra to identify functional groups via diagnostic (4000-1500 cm-1) and fingerprint regions, assess hydrogen bonding, and compile confidence-leveled inventories. For unknown compounds, reaction monitoring, and spectroscopic confirmation.
Teaches first-principles reasoning for organic chemistry problems: predict reaction products, interpret spectra, analyze stereochemistry, perform calculations. Useful for mechanisms, spectra, formulas.
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.
Share bugs, ideas, or general feedback.
Design a spectroscopic analysis campaign that selects the right techniques, sequences them efficiently, and defines success criteria for answering a specific analytical question about a sample.
Clarify exactly what information is needed before selecting any technique:
Classify the question type:
Define the success criteria: State explicitly what constitutes a satisfactory answer. For structure identification: "a single structural proposal consistent with all spectroscopic data." For quantitation: "concentration determined with < 5% relative error."
Assess what is already known: Compile any existing information about the sample (elemental analysis, reaction scheme, expected product, literature precedent). This constrains the problem and reduces the number of techniques needed.
Expected: A clearly stated analytical question with defined success criteria and a summary of existing knowledge about the sample.
On failure: If the analytical question is vague ("characterize this sample"), work with the requestor to narrow it down. A vague question leads to unfocused analysis and wasted instrument time.
Evaluate the sample to determine which techniques are feasible:
Expected: A sample characterization summary listing state, quantity, solubility, stability, hazards, and molecular weight range.
On failure: If the sample cannot be characterized adequately (e.g., quantity is too small to test solubility), adopt a conservative approach: start with non-destructive, minimal-sample techniques (Raman, ATR-IR) and assess further after initial results.
Choose the most informative techniques based on the analytical question and sample characteristics:
| Technique | Best For | Sample Needs | Destructive? | Sensitivity | Key Limitations |
|---|---|---|---|---|---|
| 1H NMR | H connectivity, integration, coupling | 1--10 mg in deuterated solvent | No | mg | Requires solubility, insensitive |
| 13C NMR | Carbon skeleton, functional groups | 10--50 mg in deuterated solvent | No | mg | Very insensitive, long acquisition |
| 2D NMR | Full connectivity, stereochemistry | 5--20 mg in deuterated solvent | No | mg | Hours of instrument time |
| IR (ATR) | Functional group ID | Any solid/liquid, minimal prep | No | ug | Water interference, fingerprint overlap |
| IR (KBr) | Functional group ID, transmission | 1--2 mg solid in KBr pellet | No* | ug | Moisture sensitive, sample mixed |
| Raman | Symmetric modes, aqueous samples | Any state, no prep for solids | No | ug--mg | Fluorescence, photodegradation |
| EI-MS | Volatile small molecules, fragmentation | ug, must be volatile | Yes (GC-MS) | ng--ug | Requires volatility |
| ESI-MS | Polar/large molecules, MW determination | Solution in volatile solvent | Yes | pg--ng | Adduct complexity, ion suppression |
| MALDI-MS | Polymers, proteins, large molecules | Solid + matrix | Yes | fmol | Matrix interference below 500 Da |
| UV-Vis | Chromophores, quantitation | Solution, ug--mg | No | ug | Limited structural information |
*IR with KBr is non-destructive to the molecule but the sample cannot be easily recovered from the pellet.
Expected: A ranked list of selected techniques with justification for each choice and notes on any techniques excluded and why.
On failure: If no single technique is sufficient (which is common for structure identification), the plan should include complementary techniques that together answer the question. If no suitable technique is available, note the limitation and recommend alternative analytical approaches (e.g., derivatization to make the sample suitable for GC-MS).
Define specific preparation requirements for each selected technique:
| Solvent | 1H Residual | Use When |
|---|---|---|
| CDCl3 | 7.26 ppm | Non-polar to moderately polar compounds |
| DMSO-d6 | 2.50 ppm | Polar compounds, broad solubility |
| D2O | 4.79 ppm | Water-soluble compounds, peptides |
| CD3OD | 3.31 ppm | Polar organic compounds |
| C6D6 | 7.16 ppm | Aromatic region overlap avoidance |
IR preparation: Select method based on sample state:
MS preparation: Match ionization method to sample:
UV-Vis preparation: Dissolve in UV-transparent solvent. Adjust concentration so that absorbance at lambda-max is between 0.1 and 1.0. Use matched cuvettes for sample and reference.
Raman preparation: Minimal preparation needed for most samples. Solids can be measured neat. Liquids in glass vials (glass has weak Raman scattering). Avoid fluorescent containers. For aqueous solutions, Raman works well because water is a weak Raman scatterer.
Expected: A preparation protocol for each selected technique, including solvent choices, quantities needed, and special handling instructions.
On failure: If sample quantity is insufficient for all planned techniques, prioritize based on the information hierarchy from Step 3. If sample is insoluble in all suitable solvents, consider solid-state techniques (ATR-IR, Raman, solid-state NMR, MALDI-MS).
Order the analyses to preserve sample and maximize information flow:
Sequence by destructiveness: Non-destructive techniques first, destructive last.
Information flow: Use early results to refine later analyses:
Define cross-validation points: Identify where results from different techniques should agree:
Plan for contingencies: Define what additional experiments to run if initial results are ambiguous:
Document the plan: Produce a written analysis plan with technique sequence, sample preparation steps, expected turnaround time, and decision points for contingency experiments.
Expected: A complete, ordered analysis plan with preparation protocols, cross-validation criteria, and contingency provisions documented.
On failure: If the plan cannot be completed due to sample or instrument constraints, document the limitations explicitly and propose the best achievable subset of analyses.
interpret-nmr-spectrum -- interpret NMR data acquired according to this planinterpret-ir-spectrum -- interpret IR data acquired according to this planinterpret-mass-spectrum -- interpret MS data acquired according to this planinterpret-uv-vis-spectrum -- interpret UV-Vis data acquired according to this planinterpret-raman-spectrum -- interpret Raman data acquired according to this planvalidate-analytical-method -- validate quantitative methods selected in this plan