# Lipid Library Curation

> Use when you have obtained MobiLipid or a similar IM-MS lipidomics package that bundles a CCS reference library for labeled lipids, and you need to verify library integrity, validate that all expected lipid species are present with plausible numeric CCS values, and prepare a canonical curated.

- Skill: `holobiomicslab/lipid-library-curation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add holobiomicslab/lipid-library-curation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/holobiomicslab/lipid-library-curation/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: CC-BY-4.0
- Author: HolobiomicsLab (https://skillmd.com/u/holobiomicslab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/holobiomicslab/lipid-library-curation

---


# Reconstruct and Validate Collision Cross Section Reference Library for Labeled Lipids

> **License: restricted** — no clear open-source license detected for the underlying tool; verify licensing before commercial use or redistribution. <!-- asb-license-banner -->
## Summary

Curate and validate a structured collision cross section (CCS) reference library for isotope-labeled lipids (e.g., U13C) by extracting, parsing, and quality-checking CCS values from a distributed package. This skill ensures the library meets physical and structural constraints required for downstream CCS bias assessment in ion mobility–mass spectrometry (IM-MS) lipidomics.

## When to use

You have obtained MobiLipid or a similar IM-MS lipidomics package that bundles a CCS reference library for labeled lipids, and you need to verify library integrity, validate that all expected lipid species are present with plausible numeric CCS values, and prepare a canonical curated version for use in CCS bias correction workflows.

## When NOT to use

- You are using a non-isotope-labeled lipid CCS library or a library not bundled with MobiLipid—this skill is specific to U13C-labeled reference libraries.
- Your input CCS values are already corrected or bias-adjusted—this skill curates raw reference libraries, not corrected measurements.
- You need only to run CCS bias correction on already-measured data without verifying the library itself—use the provided library file directly if trust in the distributor is sufficient.

## Inputs

- MobiLipid repository (GitHub clone or ZIP download)
- DTCCS_N2 reference library CSV file (e.g., 'U13C_DT_CCS_library.csv')

## Outputs

- Curated and validated CCS library table (CSV or TSV format)
- Library validation report (row counts, CCS range statistics, missing/duplicate flags)

## How to apply

Clone or download the MobiLipid repository and locate the DTCCS_N2 reference library file (e.g., 'U13C_DT_CCS_library.csv'). Parse the CSV into a structured table with columns for lipid class, lipid species identifier, and CCS reference value. Validate that all U13C-labeled lipid entries expected in the library are present, that CCS values are numeric, and that they fall within physically plausible ranges (typically 50–300 Ų for small lipids). Check for missing values, duplicates, and nomenclature consistency. Export the validated table as a canonical output file (CSV or TSV) for use as input to CCS bias calculation and correction steps in the MobiLipid workflow.

## Related tools

- **R** (Scripting language for parsing, validating, and exporting the library table; commonly used to check data types, ranges, and completeness) — https://cran.r-project.org/
- **MobiLipid** (Parent tool that bundles the DTCCS_N2 library; curated library is consumed by MobiLipid's CCS bias calculation and correction workflows) — https://github.com/FelinaHildebrand/MobiLipid

## Examples

```
# In R: Load, validate, and export the DTCCS_N2 library
library <- read.csv('U13C_DT_CCS_library.csv')
validated <- library[library$CCS >= 50 & library$CCS <= 300 & !is.na(library$CCS), ]
write.csv(validated, 'U13C_DT_CCS_library_curated.csv', row.names = FALSE)
```

## Evaluation signals

- All expected U13C-labeled lipid species (across all lipid classes in the library) are present in the curated table with no missing rows.
- All CCS values are numeric and fall within the physically plausible range of 50–300 Ų (or appropriate range for the lipid size and charge state being studied).
- No duplicate entries exist for the same lipid species–adduct combination; nomenclature is consistent across all rows.
- Row and column counts match expectations from library documentation; no null or malformed entries remain.
- Curated table successfully imports without type errors or parsing warnings into MobiLipid CCS bias calculation workflow.

## Limitations

- Library curation is restricted to U13C-labeled lipids; unlabeled or differently labeled lipids require separate reference libraries.
- CCS values are valid only for nitrogen (N2) drift gas at the conditions specified in the DTCCS_N2 library; values are not transferable to other drift gases or instruments without recalibration.
- CCS correction functions in MobiLipid require a minimum of 3 lipids per lipid class–adduct combination, so lipid classes with fewer detected U13C standards may not support bias correction.
- Nomenclature and adduct assignments in measured data must exactly match those in the reference library (e.g., 'PC', '[M+H]') for successful matching.

## Evidence

- [readme] library_file_location: "the .csv file of the DT CCS N2 library for U13C labeled lipids of yeast ('U13C_DT_CCS_library.csv') is downloaded"
- [other] validation_range_check: "Validate that all U13C labeled lipid entries are present and CCS values are numeric and within physically plausible ranges (typically 50–300 Ų for small lipids)"
- [intro] library_purpose: "Employing a newly established DT CCS N2 library for U13C labeled lipids, which is provided together with the code"
- [other] parsing_structure: "Parse the library data into a structured table format (CSV or TSV) containing lipid class, lipid species identifier, and CCS reference value columns"
- [other] export_step: "Export the curated library table as the canonical output file"