[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EE5M56496C3V8P36CDQQGF":3,"skill-same:01M7EE5M56496C3V8P36CDQQGF":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":14,"repositoryHtmlUrl":33,"repositoryHomepageUrl":33,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":35,"install":36,"resources":49},"01M7EE5M56496C3V8P36CDQQGF","bio-metabolomics-lipidomics",null,"Assigns honest lipid annotation levels, designs class-based internal-standard quantification, and runs lipid-aware differential and enrichment analysis with lipidr, guarding against in-source-fragment phantoms, sn-position over-claims, and invalid cross-class quantification. Use when naming or canonicalizing lipid species (shorthand separators, Goslin), deciding shotgun vs RP vs HILIC LC-MS, picking internal standards (SPLASH\u002FEquiSPLASH), interpreting MS-DIAL\u002FLipidSearch output, or comparing lipid classes. For general feature detection see metabolomics\u002Fxcms-preprocessing and metabolomics\u002Fmsdial-preprocessing; for non-lipid annotation confidence see metabolomics\u002Fmetabolite-annotation; for normalization\u002FQC see metabolomics\u002Fnormalization-qc; for multivariate stats see metabolomics\u002Fstatistical-analysis.","Mr-Nobody-Anonymous\u002FAll-skills","Mr-Nobody-Anonymous","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F184253119?v=4","01M7AEXFJHKTYQW5R0ZCQQTWFV","anonymous","01M7C00M3GQR4QKP9GZA42GFAK",0,"MIT","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-metabolomics-lipidomics\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: bio-metabolomics-lipidomics\ndescription: Assigns honest lipid annotation levels, designs class-based internal-standard quantification, and runs lipid-aware differential and enrichment analysis with lipidr, guarding against in-source-fragment phantoms, sn-position over-claims, and invalid cross-class quantification. Use when naming or canonicalizing lipid species (shorthand separators, Goslin), deciding shotgun vs RP vs HILIC LC-MS, picking internal standards (SPLASH\u002FEquiSPLASH), interpreting MS-DIAL\u002FLipidSearch output, or comparing lipid classes. For general feature detection see metabolomics\u002Fxcms-preprocessing and metabolomics\u002Fmsdial-preprocessing; for non-lipid annotation confidence see metabolomics\u002Fmetabolite-annotation; for normalization\u002FQC see metabolomics\u002Fnormalization-qc; for multivariate stats see metabolomics\u002Fstatistical-analysis.\ntool_type: r\nprimary_tool: lipidr\nsource: \"https:\u002F\u002Fgithub.com\u002FGPTomics\u002FbioSkills\"\nsource_repository: \"GPTomics\u002FbioSkills\"\nsource_path: \"metabolomics\u002Flipidomics\u002FSKILL.md\"\nlicense: \"MIT\"\nimported_at: \"2026-09-20\"\n---\n\n## Version Compatibility\n\nReference examples tested with: lipidr 2.16+, pygoslin 2.0+, MS-DIAL 5+\n\nThe achievable annotation level is fixed by the acquired evidence, not the software: sn-position and double-bond localization require EAD\u002FOzID\u002FPB\u002FUVPD data that routine CID never produces, and class-resolved quantification requires one isotope-labeled internal standard per class. Verify both before trusting a name or a number.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- R: `packageVersion('lipidr')` then `?function_name` to verify parameters\n- Python: `pip show pygoslin` then `help(module.function)` to check signatures\n\nIf code throws ImportError, AttributeError, or TypeError, introspect the installed\npackage and adapt the example to match the actual API rather than retrying.\n\n# Lipidomics Analysis\n\n**\"Analyze my lipidomics data\"** -> Canonicalize names to the resolution level the evidence supports, quantify each class against its own standard, then run class\u002Fchain-aware differential and enrichment analysis.\n- R: `lipidr::read_skyline()` \u002F `as_lipidomics_experiment()`, `de_analysis()`, `lsea()`\n- Nomenclature: `pygoslin` (Python) or `rgoslin` (R) for parsing\u002Fcanonicalization\n- Identification: MS-DIAL 5 (open) or LipidSearch (commercial) upstream\n\n## The Single Most Important Insight -- A Lipid Name Is a Structural-Resolution Claim the Software Usually Overstates\n\nThe Liebisch\u002FLIPID MAPS shorthand encodes, in its punctuation, exactly how much structure was measured: `PC 34:1` (space, sum composition) \u003C `PC 16:0_18:1` (underscore, chains known) \u003C `PC 16:0\u002F18:1` (slash, sn-resolved) \u003C `PC 16:0\u002F18:1(9Z)` (double-bond position+geometry). The resolution level is a property of the evidence, not of the string. Tools manufacture overstatement three ways: a formatter that only knows `\u002F`, an in-silico library entry authored at sn-level that a species-level match inherits, and \"annotate to the nearest database structure\" silently promoting a sum composition to a full structure. sn-position is almost never genuinely measured under CID, so treat every `\u002F` as an unproven `_` until EAD\u002FUVPD\u002Fderivatization evidence is in hand. The default rule is: when in doubt, drop a level.\n\n## Structural-Resolution Hierarchy (Separator Semantics)\n\n| Notation | Separator | What was measured | What may NOT be claimed |\n|----------|-----------|-------------------|-------------------------|\n| `PC 34:1` | space | class + total carbons:double-bonds (accurate mass + isotope + class diagnostic) | the two chains; sn; C=C position |\n| `PC 16:0_18:1` | underscore `_` | the two acyl chains (MS\u002FMS acyl losses, RT\u002FECN-consistent, not an in-source fragment) | which chain is sn-1 vs sn-2 |\n| `PC 16:0\u002F18:1` | slash `\u002F` | sn-1\u002Fsn-2 assignment (EAD\u002FUVPD\u002Fenzymatic - not a CID acyl-loss intensity guess) | C=C position\u002Fgeometry |\n| `PC 16:0\u002F18:1(9Z)` | parentheses | exact double-bond position + cis\u002Ftrans (OzID\u002FPB\u002FEAD\u002FUVPD) | (full structure) |\n| `PC O-34:1` \u002F `PC P-34:1` | `O-` ether \u002F `P-` plasmalogen | ether vs vinyl-ether linkage (diagnostic ion or acid-lability) | a sum composition alone cannot distinguish `P-34:1` from `O-34:2` (vinyl ether = ether + one C=C) |\n| `Cer 18:1;O2\u002F16:0` | `;O2` | sphingoid hydroxyl count (old `d18:1`) - measured, not assumed | backbone unsaturation if `d18:1` was a default rather than fragment-confirmed |\n\nCanonicalize every name through Goslin before merging tables or querying LIPID MAPS; never string-match lipid names by hand. Goslin preserves a false `\u002F` faithfully - it is necessary but not sufficient.\n\n## Decision Tree by Question\n\n| Question \u002F situation | Approach | Why |\n|----------------------|----------|-----|\n| Accurate class-level quantification, high throughput | Shotgun (direct infusion) or HILIC-LC-MS | constant concentration \u002F class bands -> clean ratio to a co-eluting class IS |\n| Resolve isobars\u002Fisomers, deep low-abundance coverage | RP-LC-MS (± ion mobility) | RT axis adds an identity coordinate; co-elution flags in-source fragments |\n| Double-bond position, sn-position, ether\u002Fplasmalogen | LC-MS + EAD\u002FOzID\u002FPB\u002FUVPD (± IM) | only these break C=C \u002F glycerol backbone; CID is blind to them |\n| Spatial localization | MS-imaging (MS-DIAL 5 spatial mode) | tissue context with predicted-CCS database |\n| Need PC acyl chains | negative-mode formate\u002Facetate adduct -> `[M-CH3]-` | `[M+H]+` gives only the m\u002Fz 184 head-group ion (class, no chains) |\n| Neutral lipids (TG\u002FDG) chains | `[M+NH4]+` adduct | drives neutral-loss-of-fatty-acid fragmentation |\n| Suspicious elevated LPC \u002F DG \u002F FA pool | RT co-elution test vs the parent class | an LPC eluting at a PC's RT is an in-source fragment, not biology |\n| An apparent odd-chain species (`PC 33:1`) | require MS\u002FMS chain confirmation | usually an in-source fragment or 13C-isotope artifact of an even neighbor |\n| Merge names across tools \u002F before a DB lookup | Goslin canonicalization first | abbreviations and separators are tool-specific; hand string-matching corrupts merges |\n| Untargeted oxidized-lipid claim | escalate to a targeted, standard-anchored oxylipin panel | untargeted oxidized-lipid IDs are hypotheses; auto-oxidation in the tube fabricates them |\n\n## Load, Normalize, and Run Differential Analysis (lipidr)\n\n**Goal:** Import a quantified lipid table, normalize within class, and find lipids that differ between groups with class\u002Fchain-aware output.\n\n**Approach:** Read a Skyline\u002Fmatrix export into a `LipidomicsExperiment`, attach sample groups, normalize (PQN or class internal standard), then `de_analysis` with an explicit contrast; visualize as a class-faceted volcano.\n\n```r\nlibrary(lipidr)\n\n# data_normalized ships with lipidr (PQN-normalized, log2); substitute a real import:\n#   d \u003C- read_skyline(list.files(datadir, 'data.csv', full.names = TRUE))\n#   d \u003C- add_sample_annotation(d, 'clinical.csv')\n#   d \u003C- normalize_pqn(d, measure = 'Area', exclude = 'blank', log = TRUE)\ndata(data_normalized)\n\n# Contrast references sample-group labels directly; group_col defaults to the first annotation\nde_results \u003C- de_analysis(data_normalized, HighFat_water - NormalDiet_water, measure = 'Area')\n\n# logFC.cutoff is on the log2 scale used by limma's topTable inside de_analysis\nsig \u003C- significant_molecules(de_results, p.cutoff = 0.05, logFC.cutoff = 1)\n\nplot_results_volcano(de_results, show.labels = FALSE)\n```\n\n## Class-Based Internal-Standard Quantification (the non-negotiable)\n\n**Goal:** Convert per-class signal to comparable abundances without baking in class-dependent ionization error.\n\n**Approach:** Ratio each species to a stable-isotope-labeled standard of its OWN class, spiked before extraction so it shares the class's recovery loss; never quantify one class with another class's standard.\n\n```r\n# normalize_istd divides each lipid by the internal standard of its matched class.\n# Requires one labeled IS per class present in the data (e.g. SPLASH\u002FEquiSPLASH covers ~13 classes).\nd_istd \u003C- normalize_istd(data_normalized, measure = 'Area', exclude = 'blank', log = TRUE)\n\n# Class-level summary is only valid WITHIN a class unless per-class response factors were calibrated:\n# cross-class molar ratios (e.g. 'PE is 3x PC') carry head-group response bias and are not licensed here.\nplot_lipidclass(d_istd, 'sd')\n```\n\n## Honest Annotation-Level Assignment (Goslin)\n\n**Goal:** Downgrade any name to the level the evidence supports and verify the claimed level is internally consistent.\n\n**Approach:** Parse with Goslin, read the perceived level, and re-emit at SPECIES (or MOLECULAR_SPECIES) unless sn\u002FC=C evidence exists.\n\n```python\nfrom pygoslin.parser.Parser import LipidParser\nfrom pygoslin.domain.LipidLevel import LipidLevel\n\nparser = LipidParser()\nlipid = parser.parse('PC 16:0\u002F18:1')      # a slash-claimed name from a tool export\n\nclaimed_level = lipid.lipid.info.level    # LipidLevel enum the string asserts\n# Without EAD\u002FUVPD evidence, re-emit at the honest molecular-species level (drops the unproven sn):\nhonest_name = lipid.get_lipid_string(LipidLevel.MOLECULAR_SPECIES)   # 'PC 16:0_18:1'\nsum_name = lipid.get_lipid_string(LipidLevel.SPECIES)                # 'PC 34:1'\n```\n\n## Per-Method Failure Modes\n\n### In-source-fragment phantom lyso-\u002FDG-lipidome\n- **Trigger:** A labile lipid (PC, TG, plasmalogen) clips an acyl chain in the ESI source before MS1.\n- **Mechanism:** The fragment is recorded as an intact precursor; PC->LPC, PE->LPE, TG->DG->MG. The fragment can also be isobaric with a free fatty acid or another class, fabricating phantom signal in several bins; extent is instrument- and tune-dependent.\n- **Symptom:** Inflated LPC:PC, DG:TG, or FA pools; an \"LPC\" eluting at a PC's retention time.\n- **Fix:** RT co-elution test (a real LPC elutes at its own ECN position); soften the source (lower in-source CID\u002Ftransfer energy); treat any large lyso\u002FDG\u002FFA pool as suspect until RT-cleared. Shotgun has no RT axis to run this test - never report elevated lyso-lipids from direct infusion without the in-source-fragment caveat.\n\n### sn-position over-claim\n- **Trigger:** A tool exports `\u002F` from CID-only data, or a library back-fills its authored sn arrangement onto a species-level match.\n- **Mechanism:** CID acyl-loss intensity bias toward sn-2 is real but small, condition-dependent, and biological samples contain both regioisomers, so the ratio is a blend, not a structure readout.\n- **Symptom:** `\u002F`-formatted names with no EAD\u002FUVPD\u002Fderivatization evidence file attached.\n- **Fix:** Canonicalize through Goslin and re-emit at `MOLECULAR_SPECIES` (`_`); at most state \"dominant sn-2 likely X\" while reporting `_`.\n\n### Invalid cross-class quantification\n- **Trigger:** One global internal standard, or comparing molar abundances across classes after only within-class normalization.\n- **Mechanism:** ESI response is head-group-dominated; a PC and a PE at equal moles give signal differing by factors that can exceed an order of magnitude.\n- **Symptom:** \"Class A is N-fold class B\" statements; a single IS used for the whole lipidome.\n- **Fix:** One isotope-labeled IS per class; report semi-quantitative within-class unless per-class (and per-adduct) response factors were independently calibrated.\n\n### Ether vs plasmalogen (O-\u002FP-) mis-call\n- **Trigger:** Reporting `P-` (plasmalogen) from a sum composition.\n- **Mechanism:** `P-34:1` and `O-34:2` share elemental composition (vinyl ether = ether + one C=C); mass cannot distinguish them.\n- **Symptom:** Plasmalogen calls with no vinyl-ether diagnostic ion or acid-lability evidence.\n- **Fix:** Require a diagnostic fragment or acid-lability test; otherwise report at the level that cannot distinguish them.\n\n## Quantitative Thresholds\n\n| Threshold | Source | Rationale |\n|-----------|--------|-----------|\n| One isotope-labeled IS per lipid class | Köfeler 2021 (good practice); SPLASH\u002FEquiSPLASH | ESI response is head-group-dominated; one global IS miscalibrates every other class |\n| EquiSPLASH = 13 deuterated IS at equal 100 µg\u002FmL | Avanti product spec | equimolar comparative use; SPLASH LIPIDOMIX uses unequal physiological concentrations |\n| Spike IS before extraction | Köfeler 2021 | only a co-extracted IS corrects class-biased recovery (Folch\u002FBligh-Dyer\u002FMTBE differ for polar minor classes) |\n| MS-DIAL 5 EAD ~14 eV; 96.4% standards delineated, 78.0% sn\u002FOH\u002FC=C correct >1 µM | Takeda 2024 | structural lipidomics yield even with the modern method is incomplete and concentration-dependent |\n| ~half of single-software species-level IDs need orthogonal evidence | Köfeler 2021 (Nat Commun) | 510\u002F1108 features, 130\u002F301 PCs & 55\u002F171 TGs violated the ECN\u002FRT model in an audited published set |\n| LipidSearch grades: keep A\u002FB\u002FC, drop D | LipidSearch grade definitions | D = mass-only; A = class + all chains = molecular-species level, NOT sn\u002FC=C resolved |\n| Shotgun infusion below the aggregation regime | Han\u002FGross protocol literature | above it lipids aggregate, ESI response goes nonlinear, the IS-ratio assumption collapses |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| `could not find function \"read_lipidomes\"` | non-existent function name | use `read_skyline()` or `as_lipidomics_experiment()` |\n| `plot_enrichment` rejects an `enrich.results` argument | wrong signature | `plot_enrichment(de.results, significant.sets, annotation = 'class', measure = 'logFC')`; get sets from `significant_lipidsets()` |\n| `lsea(type = 'chain')` errors | no `type` argument | `lsea` tests class\u002Flength\u002Funsat sets automatically; rank with `rank.by = c('logFC','P.Value','adj.P.Val')` |\n| `de_results$FDR` is NULL | wrong column name | `de_analysis` returns limma columns: `adj.P.Val`, `P.Value`, `logFC` |\n| pygoslin `LipidLevel.MOLECULAR_SUBSPECIES` AttributeError | pre-2.0 enum name | current enum is `SPECIES` \u002F `MOLECULAR_SPECIES` \u002F `SN_POSITION` \u002F `STRUCTURE_DEFINED` \u002F `FULL_STRUCTURE` \u002F `COMPLETE_STRUCTURE` |\n| Elevated LPC reported from shotgun data | in-source fragmentation with no RT to flag it | add the in-source-fragment caveat; confirm with LC-MS RT co-elution before claiming lyso biology |\n\n## References\n\n- Liebisch G, Vizcaíno JA, Köfeler H, et al. 2013. Shorthand notation for lipid structures derived from mass spectrometry. *J Lipid Res* 54:1523-1530.\n- Liebisch G, Fahy E, Aoki J, et al. 2020. Update on LIPID MAPS classification, nomenclature, and shorthand notation for MS-derived lipid structures. *J Lipid Res* 61:1539-1555.\n- Fahy E, Subramaniam S, Brown HA, et al. 2005. A comprehensive classification system for lipids. *J Lipid Res* 46:839-861.\n- Kopczynski D, Hoffmann N, Peng B, Ahrends R. 2020. Goslin: A Grammar of Succinct Lipid Nomenclature. *Anal Chem* 92:10957-10960.\n- Kind T, Liu KH, Lee DY, et al. 2013. LipidBlast in silico tandem mass spectrometry database for lipid identification. *Nat Methods* 10:755-758.\n- Takeda H, Takahashi M, Ikeda K, et al. 2024. MS-DIAL 5 multimodal mass spectrometry data mining unveils lipidome complexities. *Nat Commun* 15:9903.\n- Mohamed A, Molendijk J, Hill MM. 2020. lipidr: A Software Tool for Data Mining and Analysis of Lipidomics Datasets. *J Proteome Res* 19:2890-2897.\n- Köfeler HC, Eichmann TO, Ahrends R, et al. 2021. Quality control requirements for the correct annotation of lipidomics data. *Nat Commun* 12:4771.\n- Köfeler HC, Ahrends R, Baker ES, et al. 2021. Recommendations for good practice in MS-based lipidomics. *J Lipid Res* 62:100138.\n- McDonald JG, Ejsing CS, Kopczynski D, et al. 2022. Introducing the Lipidomics Minimal Reporting Checklist. *Nat Metab* 4:1086-1088.\n- Matyash V, Liebisch G, Kurzchalia TV, et al. 2008. Lipid extraction by methyl-tert-butyl ether for high-throughput lipidomics. *J Lipid Res* 49:1137-1146.\n- Bowden JA, Heckert A, Ulmer CZ, et al. 2017. Harmonizing lipidomics: NIST interlaboratory comparison exercise for lipidomics using SRM 1950-Metabolites in Frozen Human Plasma. *J Lipid Res* 58:2275-2288.\n\n## Related Skills\n\n- metabolomics\u002Fxcms-preprocessing - Upstream peak detection and feature extraction\n- metabolomics\u002Fmsdial-preprocessing - MS-DIAL alignment and deconvolution upstream of lipid annotation\n- metabolomics\u002Fmetabolite-annotation - General (non-lipid) annotation and confidence levels\n- metabolomics\u002Fnormalization-qc - Sample normalization and QC framing\n- metabolomics\u002Fstatistical-analysis - Multivariate stats on the lipid abundance matrix\n","## Version Compatibility\n\nReference examples tested with: lipidr 2.16+, pygoslin 2.0+, MS-DIAL 5+\n\nThe achievable annotation level is fixed by the acquired evidence, not the software: sn-position and double-bond localization require EAD\u002FOzID\u002FPB\u002FUVPD data that routine CID never produces, and class-resolved quantification requires one isotope-labeled internal standard per class. Verify both before trusting a name or a number.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- R: `packageVersion('lipidr')` then `?function_name` to verify parameters\n- Python: `pip show pygoslin` then `help(module.function)` to check signatures\n\nIf code throws ImportError, AttributeError, or TypeError, introspect the installed\npackage and adapt the example to match the actual API rather than retrying.\n\n# Lipidomics Analysis\n\n**\"Analyze my lipidomics data\"** -> Canonicalize names to the resolution level the evidence supports, quantify each class against its own standard, then run class\u002Fchain-aware differential and enrichment analysis.\n- R: `lipidr::read_skyline()` \u002F `as_lipidomics_experiment()`, `de_analysis()`, `lsea()`\n- Nomenclature: `pygoslin` (Python) or `rgoslin` (R) for parsing\u002Fcanonicalization\n- Identification: MS-DIAL 5 (open) or LipidSearch (commercial) upstream\n\n## The Single Most Important Insight -- A Lipid Name Is a Structural-Resolution Claim the Software Usually Overstates\n\nThe Liebisch\u002FLIPID MAPS shorthand encodes, in its punctuation, exactly how much structure was measured: `PC 34:1` (space, sum composition) \u003C `PC 16:0_18:1` (underscore, chains known) \u003C `PC 16:0\u002F18:1` (slash, sn-resolved) \u003C `PC 16:0\u002F18:1(9Z)` (double-bond position+geometry). The resolution level is a property of the evidence, not of the string. Tools manufacture overstatement three ways: a formatter that only knows `\u002F`, an in-silico library entry authored at sn-level that a species-level match inherits, and \"annotate to the nearest database structure\" silently promoting a sum composition to a full structure. sn-position is almost never genuinely measured under CID, so treat every `\u002F` as an unproven `_` until EAD\u002FUVPD\u002Fderivatization evidence is in hand. The default rule is: when in doubt, drop a level.\n\n## Structural-Resolution Hierarchy (Separator Semantics)\n\n| Notation | Separator | What was measured | What may NOT be claimed |\n|----------|-----------|-------------------|-------------------------|\n| `PC 34:1` | space | class + total carbons:double-bonds (accurate mass + isotope + class diagnostic) | the two chains; sn; C=C position |\n| `PC 16:0_18:1` | underscore `_` | the two acyl chains (MS\u002FMS acyl losses, RT\u002FECN-consistent, not an in-source fragment) | which chain is sn-1 vs sn-2 |\n| `PC 16:0\u002F18:1` | slash `\u002F` | sn-1\u002Fsn-2 assignment (EAD\u002FUVPD\u002Fenzymatic - not a CID acyl-loss intensity guess) | C=C position\u002Fgeometry |\n| `PC 16:0\u002F18:1(9Z)` | parentheses | exact double-bond position + cis\u002Ftrans (OzID\u002FPB\u002FEAD\u002FUVPD) | (full structure) |\n| `PC O-34:1` \u002F `PC P-34:1` | `O-` ether \u002F `P-` plasmalogen | ether vs vinyl-ether linkage (diagnostic ion or acid-lability) | a sum composition alone cannot distinguish `P-34:1` from `O-34:2` (vinyl ether = ether + one C=C) |\n| `Cer 18:1;O2\u002F16:0` | `;O2` | sphingoid hydroxyl count (old `d18:1`) - measured, not assumed | backbone unsaturation if `d18:1` was a default rather than fragment-confirmed |\n\nCanonicalize every name through Goslin before merging tables or querying LIPID MAPS; never string-match lipid names by hand. Goslin preserves a false `\u002F` faithfully - it is necessary but not sufficient.\n\n## Decision Tree by Question\n\n| Question \u002F situation | Approach | Why |\n|----------------------|----------|-----|\n| Accurate class-level quantification, high throughput | Shotgun (direct infusion) or HILIC-LC-MS | constant concentration \u002F class bands -> clean ratio to a co-eluting class IS |\n| Resolve isobars\u002Fisomers, deep low-abundance coverage | RP-LC-MS (± ion mobility) | RT axis adds an identity coordinate; co-elution flags in-source fragments |\n| Double-bond position, sn-position, ether\u002Fplasmalogen | LC-MS + EAD\u002FOzID\u002FPB\u002FUVPD (± IM) | only these break C=C \u002F glycerol backbone; CID is blind to them |\n| Spatial localization | MS-imaging (MS-DIAL 5 spatial mode) | tissue context with predicted-CCS database |\n| Need PC acyl chains | negative-mode formate\u002Facetate adduct -> `[M-CH3]-` | `[M+H]+` gives only the m\u002Fz 184 head-group ion (class, no chains) |\n| Neutral lipids (TG\u002FDG) chains | `[M+NH4]+` adduct | drives neutral-loss-of-fatty-acid fragmentation |\n| Suspicious elevated LPC \u002F DG \u002F FA pool | RT co-elution test vs the parent class | an LPC eluting at a PC's RT is an in-source fragment, not biology |\n| An apparent odd-chain species (`PC 33:1`) | require MS\u002FMS chain confirmation | usually an in-source fragment or 13C-isotope artifact of an even neighbor |\n| Merge names across tools \u002F before a DB lookup | Goslin canonicalization first | abbreviations and separators are tool-specific; hand string-matching corrupts merges |\n| Untargeted oxidized-lipid claim | escalate to a targeted, standard-anchored oxylipin panel | untargeted oxidized-lipid IDs are hypotheses; auto-oxidation in the tube fabricates them |\n\n## Load, Normalize, and Run Differential Analysis (lipidr)\n\n**Goal:** Import a quantified lipid table, normalize within class, and find lipids that differ between groups with class\u002Fchain-aware output.\n\n**Approach:** Read a Skyline\u002Fmatrix export into a `LipidomicsExperiment`, attach sample groups, normalize (PQN or class internal standard), then `de_analysis` with an explicit contrast; visualize as a class-faceted volcano.\n\n```r\nlibrary(lipidr)\n\n# data_normalized ships with lipidr (PQN-normalized, log2); substitute a real import:\n#   d \u003C- read_skyline(list.files(datadir, 'data.csv', full.names = TRUE))\n#   d \u003C- add_sample_annotation(d, 'clinical.csv')\n#   d \u003C- normalize_pqn(d, measure = 'Area', exclude = 'blank', log = TRUE)\ndata(data_normalized)\n\n# Contrast references sample-group labels directly; group_col defaults to the first annotation\nde_results \u003C- de_analysis(data_normalized, HighFat_water - NormalDiet_water, measure = 'Area')\n\n# logFC.cutoff is on the log2 scale used by limma's topTable inside de_analysis\nsig \u003C- significant_molecules(de_results, p.cutoff = 0.05, logFC.cutoff = 1)\n\nplot_results_volcano(de_results, show.labels = FALSE)\n```\n\n## Class-Based Internal-Standard Quantification (the non-negotiable)\n\n**Goal:** Convert per-class signal to comparable abundances without baking in class-dependent ionization error.\n\n**Approach:** Ratio each species to a stable-isotope-labeled standard of its OWN class, spiked before extraction so it shares the class's recovery loss; never quantify one class with another class's standard.\n\n```r\n# normalize_istd divides each lipid by the internal standard of its matched class.\n# Requires one labeled IS per class present in the data (e.g. SPLASH\u002FEquiSPLASH covers ~13 classes).\nd_istd \u003C- normalize_istd(data_normalized, measure = 'Area', exclude = 'blank', log = TRUE)\n\n# Class-level summary is only valid WITHIN a class unless per-class response factors were calibrated:\n# cross-class molar ratios (e.g. 'PE is 3x PC') carry head-group response bias and are not licensed here.\nplot_lipidclass(d_istd, 'sd')\n```\n\n## Honest Annotation-Level Assignment (Goslin)\n\n**Goal:** Downgrade any name to the level the evidence supports and verify the claimed level is internally consistent.\n\n**Approach:** Parse with Goslin, read the perceived level, and re-emit at SPECIES (or MOLECULAR_SPECIES) unless sn\u002FC=C evidence exists.\n\n```python\nfrom pygoslin.parser.Parser import LipidParser\nfrom pygoslin.domain.LipidLevel import LipidLevel\n\nparser = LipidParser()\nlipid = parser.parse('PC 16:0\u002F18:1')      # a slash-claimed name from a tool export\n\nclaimed_level = lipid.lipid.info.level    # LipidLevel enum the string asserts\n# Without EAD\u002FUVPD evidence, re-emit at the honest molecular-species level (drops the unproven sn):\nhonest_name = lipid.get_lipid_string(LipidLevel.MOLECULAR_SPECIES)   # 'PC 16:0_18:1'\nsum_name = lipid.get_lipid_string(LipidLevel.SPECIES)                # 'PC 34:1'\n```\n\n## Per-Method Failure Modes\n\n### In-source-fragment phantom lyso-\u002FDG-lipidome\n- **Trigger:** A labile lipid (PC, TG, plasmalogen) clips an acyl chain in the ESI source before MS1.\n- **Mechanism:** The fragment is recorded as an intact precursor; PC->LPC, PE->LPE, TG->DG->MG. The fragment can also be isobaric with a free fatty acid or another class, fabricating phantom signal in several bins; extent is instrument- and tune-dependent.\n- **Symptom:** Inflated LPC:PC, DG:TG, or FA pools; an \"LPC\" eluting at a PC's retention time.\n- **Fix:** RT co-elution test (a real LPC elutes at its own ECN position); soften the source (lower in-source CID\u002Ftransfer energy); treat any large lyso\u002FDG\u002FFA pool as suspect until RT-cleared. Shotgun has no RT axis to run this test - never report elevated lyso-lipids from direct infusion without the in-source-fragment caveat.\n\n### sn-position over-claim\n- **Trigger:** A tool exports `\u002F` from CID-only data, or a library back-fills its authored sn arrangement onto a species-level match.\n- **Mechanism:** CID acyl-loss intensity bias toward sn-2 is real but small, condition-dependent, and biological samples contain both regioisomers, so the ratio is a blend, not a structure readout.\n- **Symptom:** `\u002F`-formatted names with no EAD\u002FUVPD\u002Fderivatization evidence file attached.\n- **Fix:** Canonicalize through Goslin and re-emit at `MOLECULAR_SPECIES` (`_`); at most state \"dominant sn-2 likely X\" while reporting `_`.\n\n### Invalid cross-class quantification\n- **Trigger:** One global internal standard, or comparing molar abundances across classes after only within-class normalization.\n- **Mechanism:** ESI response is head-group-dominated; a PC and a PE at equal moles give signal differing by factors that can exceed an order of magnitude.\n- **Symptom:** \"Class A is N-fold class B\" statements; a single IS used for the whole lipidome.\n- **Fix:** One isotope-labeled IS per class; report semi-quantitative within-class unless per-class (and per-adduct) response factors were independently calibrated.\n\n### Ether vs plasmalogen (O-\u002FP-) mis-call\n- **Trigger:** Reporting `P-` (plasmalogen) from a sum composition.\n- **Mechanism:** `P-34:1` and `O-34:2` share elemental composition (vinyl ether = ether + one C=C); mass cannot distinguish them.\n- **Symptom:** Plasmalogen calls with no vinyl-ether diagnostic ion or acid-lability evidence.\n- **Fix:** Require a diagnostic fragment or acid-lability test; otherwise report at the level that cannot distinguish them.\n\n## Quantitative Thresholds\n\n| Threshold | Source | Rationale |\n|-----------|--------|-----------|\n| One isotope-labeled IS per lipid class | Köfeler 2021 (good practice); SPLASH\u002FEquiSPLASH | ESI response is head-group-dominated; one global IS miscalibrates every other class |\n| EquiSPLASH = 13 deuterated IS at equal 100 µg\u002FmL | Avanti product spec | equimolar comparative use; SPLASH LIPIDOMIX uses unequal physiological concentrations |\n| Spike IS before extraction | Köfeler 2021 | only a co-extracted IS corrects class-biased recovery (Folch\u002FBligh-Dyer\u002FMTBE differ for polar minor classes) |\n| MS-DIAL 5 EAD ~14 eV; 96.4% standards delineated, 78.0% sn\u002FOH\u002FC=C correct >1 µM | Takeda 2024 | structural lipidomics yield even with the modern method is incomplete and concentration-dependent |\n| ~half of single-software species-level IDs need orthogonal evidence | Köfeler 2021 (Nat Commun) | 510\u002F1108 features, 130\u002F301 PCs & 55\u002F171 TGs violated the ECN\u002FRT model in an audited published set |\n| LipidSearch grades: keep A\u002FB\u002FC, drop D | LipidSearch grade definitions | D = mass-only; A = class + all chains = molecular-species level, NOT sn\u002FC=C resolved |\n| Shotgun infusion below the aggregation regime | Han\u002FGross protocol literature | above it lipids aggregate, ESI response goes nonlinear, the IS-ratio assumption collapses |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| `could not find function \"read_lipidomes\"` | non-existent function name | use `read_skyline()` or `as_lipidomics_experiment()` |\n| `plot_enrichment` rejects an `enrich.results` argument | wrong signature | `plot_enrichment(de.results, significant.sets, annotation = 'class', measure = 'logFC')`; get sets from `significant_lipidsets()` |\n| `lsea(type = 'chain')` errors | no `type` argument | `lsea` tests class\u002Flength\u002Funsat sets automatically; rank with `rank.by = c('logFC','P.Value','adj.P.Val')` |\n| `de_results$FDR` is NULL | wrong column name | `de_analysis` returns limma columns: `adj.P.Val`, `P.Value`, `logFC` |\n| pygoslin `LipidLevel.MOLECULAR_SUBSPECIES` AttributeError | pre-2.0 enum name | current enum is `SPECIES` \u002F `MOLECULAR_SPECIES` \u002F `SN_POSITION` \u002F `STRUCTURE_DEFINED` \u002F `FULL_STRUCTURE` \u002F `COMPLETE_STRUCTURE` |\n| Elevated LPC reported from shotgun data | in-source fragmentation with no RT to flag it | add the in-source-fragment caveat; confirm with LC-MS RT co-elution before claiming lyso biology |\n\n## References\n\n- Liebisch G, Vizcaíno JA, Köfeler H, et al. 2013. Shorthand notation for lipid structures derived from mass spectrometry. *J Lipid Res* 54:1523-1530.\n- Liebisch G, Fahy E, Aoki J, et al. 2020. Update on LIPID MAPS classification, nomenclature, and shorthand notation for MS-derived lipid structures. *J Lipid Res* 61:1539-1555.\n- Fahy E, Subramaniam S, Brown HA, et al. 2005. A comprehensive classification system for lipids. *J Lipid Res* 46:839-861.\n- Kopczynski D, Hoffmann N, Peng B, Ahrends R. 2020. Goslin: A Grammar of Succinct Lipid Nomenclature. *Anal Chem* 92:10957-10960.\n- Kind T, Liu KH, Lee DY, et al. 2013. LipidBlast in silico tandem mass spectrometry database for lipid identification. *Nat Methods* 10:755-758.\n- Takeda H, Takahashi M, Ikeda K, et al. 2024. MS-DIAL 5 multimodal mass spectrometry data mining unveils lipidome complexities. *Nat Commun* 15:9903.\n- Mohamed A, Molendijk J, Hill MM. 2020. lipidr: A Software Tool for Data Mining and Analysis of Lipidomics Datasets. *J Proteome Res* 19:2890-2897.\n- Köfeler HC, Eichmann TO, Ahrends R, et al. 2021. Quality control requirements for the correct annotation of lipidomics data. *Nat Commun* 12:4771.\n- Köfeler HC, Ahrends R, Baker ES, et al. 2021. Recommendations for good practice in MS-based lipidomics. *J Lipid Res* 62:100138.\n- McDonald JG, Ejsing CS, Kopczynski D, et al. 2022. Introducing the Lipidomics Minimal Reporting Checklist. *Nat Metab* 4:1086-1088.\n- Matyash V, Liebisch G, Kurzchalia TV, et al. 2008. Lipid extraction by methyl-tert-butyl ether for high-throughput lipidomics. *J Lipid Res* 49:1137-1146.\n- Bowden JA, Heckert A, Ulmer CZ, et al. 2017. Harmonizing lipidomics: NIST interlaboratory comparison exercise for lipidomics using SRM 1950-Metabolites in Frozen Human Plasma. *J Lipid Res* 58:2275-2288.\n\n## Related Skills\n\n- metabolomics\u002Fxcms-preprocessing - Upstream peak detection and feature extraction\n- metabolomics\u002Fmsdial-preprocessing - MS-DIAL alignment and deconvolution upstream of lipid annotation\n- metabolomics\u002Fmetabolite-annotation - General (non-lipid) annotation and confidence levels\n- metabolomics\u002Fnormalization-qc - Sample normalization and QC framing\n- metabolomics\u002Fstatistical-analysis - Multivariate stats on the lipid abundance matrix\n",{"name":5,"source":24,"license":15,"tool_type":25,"description":7,"imported_at":26,"source_path":27,"primary_tool":28,"source_repository":29},"https:\u002F\u002Fgithub.com\u002FGPTomics\u002FbioSkills","r","2026-09-20","metabolomics\u002Flipidomics\u002FSKILL.md","lipidr","GPTomics\u002FbioSkills","main","2d1750717747097b602acf30bd09a7cbd4b4c6ea","awesome_skills\u002Fbiology\u002Fbio-metabolomics-lipidomics","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous","2026-11-09 11:45:36",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-metabolomics-lipidomics",{"tool":42,"command":43},"bunx","bunx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-metabolomics-lipidomics",{"tool":45,"command":46},"pnpm","pnpm dlx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-metabolomics-lipidomics","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-metabolomics-lipidomics\u002FSKILL.md",true,[50,56],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"examples\u002Flipidomics_workflow.R","OTHER","其他",2401,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-metabolomics-lipidomics\u002Fexamples\u002Flipidomics_workflow.R",{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"usage-guide.md","REFERENCE","参考文档",4537,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-metabolomics-lipidomics\u002Fusage-guide.md",[63,71,78,85,92,99],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":70},"01M7FFFZPC2025JQQHPHDX154J","dei-assessment","Assess diversity, equity, and inclusion with metrics. TRIGGERS - Use when user needs help with dei-assessment related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fdei-assessment\u002FSKILL.md",[],[],"2026-11-16 10:05:34",{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":70},"01M7FFFWN8H4WA7A6Y398QKB6J","dei-action-plan","Create DEI action plans with goals and initiatives. TRIGGERS - Use when user needs help with dei-action-plan related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fdei-action-plan\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":70},"01M7FFFSHTM0QZRVZ2NRJTJ0PY","culture-fit-assessment","Design culture add assessment processes. TRIGGERS - Use when user needs help with culture-fit-assessment related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fculture-fit-assessment\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":70},"01M7FFFMA12RKEQA38KHJSXXPS","cowork-to-code-bridge","Use an already-installed, independently verified cowork-to-code bridge to run narrowly approved actions on the user's own macOS, Linux, or WSL2 machine through a local file queue.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcowork-to-code-bridge\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":70},"01M7FFFH1F6M8YRGW5V487GH1K","counter-offer-response","Draft counter-offer responses for retention. TRIGGERS - Use when user needs help with counter-offer-response related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcounter-offer-response\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":70},"01M7FFFDGEHV8Y7J9N40HZXW52","continuous-feedback-system","Design continuous feedback systems. TRIGGERS - Use when user needs help with continuous-feedback-system related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcontinuous-feedback-system\u002FSKILL.md",[],[]]