troubleshoot-separation
关于
This skill systematically diagnoses and resolves GC and HPLC chromatographic separation issues. It helps developers document symptoms, identify root causes for peak shape and retention problems, and evaluate matrix effects. The skill implements targeted fixes using a structured, one-variable-at-a-time troubleshooting approach.
快速安装
Claude Code
推荐npx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/troubleshoot-separation在 Claude Code 中复制并粘贴此命令以安装该技能
技能文档
Troubleshoot a Chromatographic Separation
Systematic diagnosis and resolution of GC and HPLC separation problems covering symptom documentation, peak shape diagnosis, retention anomaly investigation, matrix effect evaluation, and verified corrective action using controlled single-variable changes.
When to Use
- Peaks are tailing, fronting, splitting, or broader than expected
- Retention times have shifted or become irreproducible
- Resolution between critical pairs has degraded
- Baseline drift, ghost peaks, or negative peaks have appeared
- Sensitivity has dropped or signal-to-noise has worsened
- A method that previously worked is now failing system suitability
Inputs
Required
- Problem chromatogram: Current data showing the issue
- Reference chromatogram: Recent good chromatogram from the same method for comparison
- Method conditions: Column, mobile phase/carrier gas, temperature/gradient, detector, flow rate
- System log: Recent maintenance, column changes, mobile phase preparations, instrument events
Optional
- Blank chromatogram: Most recent blank or solvent injection
- System suitability trend data: Historical values for tailing, resolution, plates, retention time
- Column history: Number of injections, types of samples, age of column
- Instrument maintenance log: Pump seal replacements, lamp hours, detector service dates
Procedure
Step 1: Document the Problem
- Describe the symptom precisely: which peaks are affected, how do they differ from the reference chromatogram.
- Determine when the problem started: gradual degradation or sudden onset.
- Record whether the problem affects all peaks or only specific ones.
- Note whether the problem is present in standards, samples, or both.
- Collect the current system suitability data and compare to historical trends.
- Photograph or export the problem chromatogram alongside the reference for side-by-side comparison.
Got: A documented problem statement with timeline, scope (all peaks vs. specific peaks, standards vs. samples), and comparison to reference data.
If fail: If no reference chromatogram is available, inject a fresh standard preparation under the documented method conditions to establish a current baseline before troubleshooting.
Step 2: Diagnose Peak Shape Issues
Use the symptom table to identify likely root causes.
| Symptom | Possible Causes | Solutions |
|---|---|---|
| Tailing (T > 1.5) | Secondary interactions (silanol activity), dead volume in fittings, contaminated column frit, overloaded active sites | Add amine modifier (HPLC), deactivate liner (GC), replace frit, trim column inlet, reduce injection mass |
| Fronting (T < 0.8) | Column overload (mass or volume), mismatch between sample solvent and mobile phase strength | Reduce injection volume or concentration, dilute in weaker solvent, use larger-bore column |
| Split / double peaks | Partially blocked frit, void at column head, two polymorphic forms, isomeric interconversion | Replace frit, repack column head, verify sample stability, adjust pH to lock one form |
| Broad peaks (all) | Extra-column band broadening, wrong tubing ID, large detector cell, old column, low plate count | Minimize post-column tubing length and ID, check connections, replace column |
| Broad peaks (early eluters) | Poor focusing at column head, injection solvent too strong (HPLC), cold on-column (GC) | Use weaker injection solvent, reduce injection volume, increase initial oven temp |
| Broad peaks (late eluters) | On-column diffusion, temperature too low (GC), insufficient gradient steepness (HPLC) | Increase final oven temperature, steepen gradient, add organic wash |
| Negative peaks | Sample solvent refractive index/absorbance differs from mobile phase, vacancy peaks (IEX) | Match sample solvent to mobile phase, use different detection wavelength |
| Ghost peaks | Carryover from previous injection, contaminated mobile phase, column bleed, septum bleed (GC) | Run blank to confirm, clean or replace injection system, filter/degas mobile phase, replace septum |
| Baseline drift (upward) | Column bleed (GC at high temp), gradient elution baseline shift (HPLC), lamp instability (UV) | Reduce max temp, use low-bleed column (GC), run blank gradient to characterize (HPLC), replace lamp |
| Baseline noise (high-frequency) | Electrical interference, pump pulsation, air bubbles in detector, contaminated detector | Ground instrument, replace pump seals, degas mobile phase, clean detector cell |
- Match the observed symptom(s) to the table above.
- Narrow the list of causes by checking whether the problem affects all peaks or specific ones, and whether it appeared suddenly or gradually.
- Prioritize the most likely cause based on the system history (recent changes, column age, maintenance status).
Got: One or two most-likely root causes identified from the symptom-cause mapping, prioritized by system history.
If fail: If the symptom does not match any row in the table, or multiple symptoms are present simultaneously, the problem may be compound (e.g., column degradation plus a leak). Address the most obvious issue first, then re-evaluate.
Step 3: Diagnose Retention Time Issues
| Symptom | Possible Causes | Solutions |
|---|---|---|
| All peaks shifted earlier | Increased flow rate, higher column temperature, stronger mobile phase, column void | Check flow rate setting and actual delivery, verify temperature, remake mobile phase, inspect column |
| All peaks shifted later | Decreased flow rate, lower column temperature, weaker mobile phase, partially blocked tubing | Check for leaks (pressure drop), verify temperature, remake mobile phase, check inline filter |
| Retention time drift (gradual) | Column degradation, mobile phase evaporation (open reservoir), temperature fluctuation | Replace column, seal reservoir, stabilize oven, use column thermostat |
| Retention time irreproducible | Leak at fitting, check valve malfunction, autosampler timing error, inadequate re-equilibration | Pressure-test fittings, replace check valves, verify autosampler, increase equilibration volume |
| Lost retention (k' near 0) | Phase collapse (RP at high aqueous), column dewetting, wrong mobile phase, reversed connections | Use polar-embedded or AQ-type column, re-wet column with organic, verify mobile phase, check plumbing |
| Co-elution (previously resolved) | Column selectivity lost (bonded phase stripped), mobile phase composition changed, temperature changed | Replace column, verify mobile phase preparation, check temperature setpoint vs. actual |
- Determine whether retention shifts are uniform (all peaks) or selective (specific peaks).
- Uniform shifts point to systematic causes (flow, temperature, mobile phase composition).
- Selective shifts point to column chemistry changes or specific analyte-related issues.
- Check the instrument pressure trace: sudden pressure changes indicate leaks or blockages.
- Re-inject the reference standard to confirm whether the issue is in the system or the sample.
Got: Root cause of retention anomaly identified and categorized as systematic (instrument/mobile phase) or column-related.
If fail: If re-injecting the standard on a new column resolves the issue, the original column is the problem. If the issue persists on a new column, the cause is upstream (mobile phase, instrument, or method parameters).
Step 4: Evaluate Matrix Effects
- Compare the standard chromatogram to the sample chromatogram:
- Are there additional peaks in the sample that are absent in the standard?
- Is the baseline elevated or noisy in specific retention windows?
- Are analyte peak shapes different in the sample vs. standard (broader, tailing more)?
- For LC-MS: evaluate ion suppression/enhancement:
- Post-column infusion test: infuse analyte continuously while injecting a blank matrix extract; dips in the analyte signal indicate ion suppression regions.
- If analyte retention time coincides with a suppression region, modify the method to shift analyte elution.
- Check for column contamination:
- Inject solvent blanks after a sample sequence; persistent peaks indicate column contamination.
- Flush the column with strong solvent (100% organic for RP, or as recommended by column manufacturer).
- Assess sample preparation:
- Dirty injector (autosampler needle, injection port liner in GC): replace or clean.
- Insufficient sample cleanup: add a filtration, SPE, or protein precipitation step.
- For GC: check for non-volatile residue buildup in the inlet liner, which causes peak tailing and ghost peaks over time.
Got: Matrix effects characterized (presence/absence of interferents, ion suppression zones for LC-MS, column contamination status) with actionable recommendations.
If fail: If matrix effects cannot be characterized with available data, prepare a matrix-matched calibration curve and compare slopes to a solvent calibration curve. A slope difference > 15% indicates significant matrix effects requiring method modification.
Step 5: Implement and Verify the Fix
- Change only one variable at a time. Document what was changed and why.
- After each change, re-inject the system suitability standard and compare to the reference chromatogram.
- Sequence of changes to try (from least to most disruptive):
- Prepare fresh mobile phase / carrier gas tank
- Replace consumables (septum, liner, frit, inline filter, lamp)
- Tighten or replace fittings and tubing
- Flush/regenerate the column
- Adjust method parameters (temperature, flow, gradient, pH)
- Replace the column
- Service the instrument (pump seals, check valves, detector)
- Once the fix is identified, run the full system suitability test (n >= 5 injections).
- Compare all parameters (retention time, area, resolution, tailing, plates) to historical specification.
- Document the root cause, corrective action, and verification results in the instrument/column logbook.
- If the same problem recurs, establish a preventive maintenance schedule to address the root cause proactively.
Got: Problem resolved with system suitability parameters restored to specification. Root cause, corrective action, and verification documented.
If fail: If all single-variable changes fail to resolve the issue, the problem may involve multiple simultaneous failures. Replace all consumables and the column together, verify with a fresh standard, and rebuild the troubleshooting from the new baseline. If the problem persists after total consumable replacement, escalate to instrument service.
Validation
- Problem documented with symptom description, timeline, and scope
- Root cause identified using symptom-cause mapping tables
- Only one variable changed at a time during troubleshooting
- Fix verified by system suitability test (n >= 5 replicate injections)
- All system suitability parameters restored to within specification
- Root cause and corrective action documented in logbook
- Preventive measure identified to avoid recurrence
Pitfalls
- Changing multiple variables simultaneously: Makes it impossible to identify the actual root cause. Always change one thing, test, then decide whether to change another.
- Replacing the column as the first step: Column replacement is expensive and may mask the real problem (e.g., a leak, wrong mobile phase, or contaminated inlet). Exhaust simpler possibilities first.
- Ignoring the instrument logbook: Many problems trace back to a recent maintenance event, mobile phase batch change, or column swap. Always check what changed recently.
- Blaming the sample without evidence: Run the reference standard first. If the standard also shows the problem, the issue is in the system, not the sample.
- Flushing a column with incompatible solvents: Never flush a reversed-phase column with pure water (causes phase collapse) or a silica HILIC column with pure aqueous buffer (irreversible damage). Follow the manufacturer's washing protocol.
- Not documenting what was tried: Failed troubleshooting attempts are valuable information. Record every change attempted and its outcome to avoid repeating unsuccessful fixes and to build institutional knowledge.
Related Skills
interpret-chromatogram-- understanding the chromatographic data that reveals separation problemsdevelop-gc-method-- GC method development, relevant when troubleshooting requires method redesigndevelop-hplc-method-- HPLC method development, relevant when troubleshooting requires method redesignvalidate-analytical-method-- re-validation may be required after significant method changes during troubleshooting
GitHub 仓库
相关推荐技能
railway-docs
文档Railway Docs Skill可实时获取最新的Railway官方文档,确保回答的准确性。当开发者询问Railway功能特性、工作原理或分享docs.railway.com链接时,应优先使用此技能。它通过专门的LLM优化文档源提供最新信息,避免依赖过时记忆来回答技术问题。
n8n-code-python
文档该Skill为在n8n平台的Python代码节点中编写代码提供专家指导,特别适用于需要使用_input/_json/_node语法、Python标准库或了解n8n中Python限制的场景。它强调JavaScript应作为首选方案,仅当需要特定Python功能或对Python语法更熟悉时才使用Python。Skill提供了快速入门模板和关键注意事项,帮助开发者在n8n中高效编写Python代码。
archon
文档Archon Skill为开发者提供了基于RAG的语义搜索和项目任务管理功能,可通过REST API访问知识库。它支持文档搜索、网站爬取、文件上传和版本控制,适用于技术文档查询和项目管理场景。首次使用时需要配置Archon主机地址,建议在处理外部文档时优先使用该Skill。
n8n-code-javascript
文档这个Skill为n8n工作流中的JavaScript代码节点提供专业指导,涵盖数据处理、HTTP请求和日期操作等核心场景。它详细解释了如何正确使用n8n特有的`$input`/`$json`语法、`$helpers`工具以及DateTime对象,并包含关键的错误排查和模式选择建议。开发者通过该Skill能快速掌握Code节点的正确返回格式、数据访问方法和常见陷阱解决方案。
