agentsclimarketplace

Graph based molecular representation

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/graph-based-molecular-representation

Use when when you have 1D NMR spectra (¹H and/or ¹³C) as input and need to predict complete molecular structure (both molecular formula and bond connectivity) for molecules with up to 19 heavy atoms.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill graph-based-molecular-representation

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 15 stars15 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as CC-BY-4.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

6.0 KB, 882 tokens by cl100k_base, as published. Nobody here has run it

graph-based-molecular-representation

Summary

Represent molecular structures as graphs with atoms as nodes and bonds as edges, enabling transformer and neural network architectures to learn structure-from-spectra mappings. This representation decouples molecular connectivity and formula prediction into discrete, learnable tasks suitable for end-to-end neural training.

When to use

When you have 1D NMR spectra (¹H and/or ¹³C) as input and need to predict complete molecular structure (both molecular formula and bond connectivity) for molecules with up to 19 heavy atoms. Use this skill when you want to train a neural model that treats formula prediction and bond connectivity as separate supervised learning tasks that can be jointly optimized.

When NOT to use

  • Input spectra contain molecules with >19 heavy atoms — the framework's demonstrated scope does not extend beyond this
  • You require 2D NMR spectra or other spectral modalities — this skill is designed specifically for 1D ¹H and/or ¹³C NMR
  • Your goal is to predict only molecular formula without connectivity, or vice versa — the skill's value derives from joint graph-based representation and multitask learning

Inputs

  • fragment token sequences (encoded predicted substructures from spectra)
  • molecular structure ground truth (adjacency matrices and formula vectors)
  • 1D NMR spectra (¹H and/or ¹³C)

Outputs

  • predicted adjacency matrix (molecular graph connectivity)
  • predicted molecular formula vector
  • validation accuracy for connectivity prediction
  • validation accuracy for formula prediction

How to apply

Encode target molecular structures as both adjacency matrices (capturing bond connectivity as a graph link-prediction task) and formula vectors (capturing atomic composition as a classification task). Prepare a training dataset by pairing fragment token sequences (derived from predicted substructures) with these dual representations. Train a transformer encoder-decoder architecture with multi-head self-attention and cross-attention layers to map spectra-derived fragment embeddings into this graph space. Use supervised loss on both formula classification and graph connectivity prediction, optimizing jointly. Validate on held-out test molecules by comparing predicted adjacency matrices and formula vectors to ground truth using separate accuracy metrics for each output.

Related tools

  • PyTorch (deep learning framework for implementing transformer encoder-decoder and training end-to-end model with supervised loss on adjacency matrices and formula vectors)
  • Transformer (architecture) (encoder-decoder backbone with multi-head self-attention and cross-attention layers to map fragment embeddings to molecular graph space)

Evaluation signals

  • Predicted adjacency matrices match ground truth bond connectivity with reported accuracy metric across test molecules
  • Predicted formula vectors match ground truth molecular formulas with separate reported accuracy metric
  • Model successfully reconstructs molecular graphs for held-out test molecules with both connectivity and formula predictions verified independently
  • Training/validation loss converges for both formula classification and link prediction tasks during joint optimization
  • Predicted structures contain only chemically valid bonds and atom counts consistent with input spectra

Limitations

  • Framework is demonstrated only on molecules with up to 19 heavy (non-hydrogen) atoms; scalability to larger molecules is not validated
  • Accuracy of structure prediction depends critically on quality of predicted substructures fed as fragments; errors in fragment prediction propagate to final structure
  • Graph-based representation assumes standard valency rules; unusual bonding or charged species may not be handled correctly

Evidence

  • [other] task_001 workflow step 1: "Prepare fragment-to-structure training dataset by encoding predicted substructures as token sequences and target structures as adjacency matrices and formula vectors."
  • [other] task_001 workflow step 2: "Implement transformer encoder-decoder architecture with multi-head self-attention and cross-attention layers to map fragment embeddings to structure space."
  • [other] task_001 workflow step 3: "Train the transformer end-to-end using supervised loss on formula prediction (classification) and bond connectivity prediction (link prediction on molecular graph)."
  • [intro] article intro finding 2: "we show how a transformer architecture can be constructed to efficiently solve the task, traditionally performed by chemists, of assembling large numbers of molecular fragments into molecular"
  • [intro] article intro scope: "We demonstrate the effectiveness of this framework on molecules with up to 19 heavy (non-hydrogen) atoms"

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.