# Compound Structure Processing

> Use when you have a collection of DNA adduct or small-molecule compound structures stored in SDF format and need to prepare them for computational workflows like CFM-ID fragment prediction, or when integrating new compounds into a structured compound database.

- Skill: `holobiomicslab/compound-structure-processing` (Agent Skill)
- Install (CLI): `npx skillmds@latest add holobiomicslab/compound-structure-processing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/holobiomicslab/compound-structure-processing/raw
- Safety review: pending
- 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/compound-structure-processing

---


# compound-structure-processing

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

Load and prepare chemical compound structures from SDF format files for downstream computational analysis, such as in-silico fragment prediction. This skill ensures compound structures are correctly formatted and validated before submission to spectral prediction tools.

## When to use

Use this skill when you have a collection of DNA adduct or small-molecule compound structures stored in SDF format and need to prepare them for computational workflows like CFM-ID fragment prediction, or when integrating new compounds into a structured compound database.

## When NOT to use

- Input structures are already in a processed intermediate format (e.g., SMILES strings or serialized objects) and do not require SDF parsing.
- Compounds lack required metadata (e.g., molecular formula, charge state) and cannot be validated against downstream tool requirements.
- SDF file is corrupted, incomplete, or contains malformed structure records that cannot be reliably parsed.

## Inputs

- SDF format file containing DNA adduct compound structures
- Compound structure records with molecular connectivity and metadata

## Outputs

- Parsed and validated compound structures in memory or intermediate format
- Structured compound records with IDs, names, and molecular properties
- Compound inventory log documenting successful parsing

## How to apply

Load compound structures from the SDF format file into a computational environment (e.g., via chemistry library APIs). Validate that all structures are well-formed and contain required molecular properties (e.g., formal charge, connectivity). Parse structure metadata (e.g., compound IDs, names) from the SDF header and annotation fields. Confirm the structure count and diversity match the expected sample set. Structure the parsed data into a format compatible with the downstream tool (e.g., CFM-ID requires specific ionization levels and mass range specifications). Document the loading step and validate that all input compounds have been successfully parsed before proceeding to prediction.

## Related tools

- **CFM-ID** (Downstream tool for predicting fragment spectra from processed compound structures at specified ionization levels and mass ranges)

## Evaluation signals

- All compound records in the input SDF file are successfully parsed with no errors or warnings
- Parsed compound count matches the expected number of input structures
- Each parsed compound contains required fields: unique identifier, molecular structure, and ionization/mass parameters compatible with CFM-ID
- No duplicate or malformed structure records remain after validation
- Output can be directly ingested by CFM-ID without format conversion or manual curation

## Limitations

- SDF parsing quality depends on proper file formatting and adherence to standard SDF conventions; non-standard or legacy SDF variants may fail to parse correctly.
- Compound structures lacking formal charge information or containing ambiguous connectivity may not be compatible with downstream fragment prediction.
- No changelog or versioning system documented for tracking changes to compound structures or SDF file updates.

## Evidence

- [other] Load compound structures from the SDF format file containing DNA adduct compounds: "Load compound structures from the SDF format file containing DNA adduct compounds."
- [intro] Compound structures in SDF format available from database: "The following files are available: [Excel format, Word format, online, SDF format, experimental fragments online, predicted fragments online, collection of Excel file, online databases, CFM-ID]"
- [other] SDF files are input to CFM-ID for fragment prediction: "Execute CFM-ID on each compound structure to predict fragment spectra at the appropriate ionization level and mass range."
- [other] Validation required for completeness: "Validate output by confirming all input compounds have corresponding predicted spectra entries."