agentsclimarketplace

Strain correlation score computation

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/strain-correlation-score-computation

Use when when you have paired genomics and metabolomics data from multiple strains (e.g., from Paired Omics Data Platform), have clustered BGCs into GCFs and detected molecular features, and need to score all potential GCF–MF links to prioritise true biosynthetic relationships.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill strain-correlation-score-computation

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

8.6 KB, ~1.5k tokens by cl100k_base, as published. Nobody here has run it

strain-correlation-score-computation

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

Summary

Compute raw and standardised strain correlation scores to rank genomic–metabolomic links by quantifying strain overlap between gene cluster families (GCFs) and molecular features (MFs). Standardisation via hypergeometric null model enables fair comparison across links of different sizes.

When to use

When you have paired genomics and metabolomics data from multiple strains (e.g., from Paired Omics Data Platform), have clustered BGCs into GCFs and detected molecular features, and need to score all potential GCF–MF links to prioritise true biosynthetic relationships. Use this skill to overcome the inability of raw correlation scores to be compared across links of different GCF or MF sizes.

When NOT to use

  • Input already consists of standardised or normalised scores—avoid double-standardisation.
  • Dataset contains only a single strain or GCF, making overlap statistics undefined.
  • GCF or MF membership data is incomplete or missing for >5% of strain annotations—hypergeometric calculations will be unreliable.

Inputs

  • GCF membership data (set of strains per GCF)
  • MF membership data (set of strains per MF)
  • Population size N (total number of strains in dataset)
  • Raw strain correlation scores for all GCF–MF pairs

Outputs

  • Standardised strain correlation scores (s*_corr) for all GCF–MF pairs
  • Hypergeometric expected values E[σ_corr(M,G)] per pair
  • Hypergeometric variances Var[σ_corr(M,G)] per pair
  • Summary statistics (mean, variance, p-values) of standardised scores across all links and validated link subset

How to apply

For each GCF–MF pair: (1) compute the raw strain correlation score σ_corr(M,G) by applying the four-term rule: +10 if a strain produces the metabolite AND has the BGC, −10 if the strain produces metabolite but lacks BGC, +1 if the strain neither produces nor has BGC, 0 otherwise. (2) Calculate the hypergeometric expected value E[σ_corr(M,G)] and variance Var[σ_corr(M,G)] under the null hypothesis of random strain overlap, using population size N, MF size m, GCF size g, and observed overlap count o. (3) Standardise each score as s*_corr = (σ_corr − E[σ_corr]) / √Var[σ_corr] to achieve zero mean and unit variance across all links. This transformation makes scores comparable regardless of GCF or MF size, yielding standardised scores with mean ≈ −0.006 for background links and markedly higher values (e.g. 3.6717) for validated links.

Related tools

Evaluation signals

  • Standardised score mean across all links is ≈ −0.006 (zero-centred) and variance ≈ 1 (unit variance).
  • Validated links show standardised scores significantly higher than background (e.g. mean 3.6717 vs. −0.006, p < 1e−60).
  • Raw scores cannot be compared directly across links of different sizes; standardised scores can.
  • Hypergeometric expected values and variances are computed without error for all GCF–MF pairs; no division-by-zero or NaN values.
  • Combined standardised correlation and IOKR scores enrich for validated links at the 90th percentile (p < 0.003).

Limitations

  • Standardised strain correlation score still cannot distinguish between potential links showing identical patterns of strain presence or absence; complementary scoring methods (e.g. IOKR) are needed to break such ties.
  • Hypergeometric model assumes strain overlap is random and independent; strongly non-random population structure or ecological constraints may violate this assumption.
  • Score is sensitive to missing or misannotated strain membership data; incomplete genome assemblies or metabolomics coverage will bias expected values and variances.

Evidence

  • [abstract] the most popular strain correlation score [17] has properties that make it impossible to reliably compare score values across links (even links from the same GCF or MF), severely limiting the scores: "the most popular strain correlation score has properties that make it impossible to reliably compare score values across links"
  • [other] the raw strain correlation score σ_corr(M,G) for all potential GCF-MF link pairs using the standard rule: +10 (strain in both), −10 (strain in MF only), +1 (strain in neither), 0 (strain in GCF only): "compute the raw strain correlation score σ_corr(M,G) for all potential GCF-MF link pairs using the standard rule: +10 (strain in both), −10 (strain in MF only), +1 (strain in neither), 0 (strain in"
  • [other] For each link, calculate the hypergeometric expected value E[σ_corr(M,G)] and variance Var[σ_corr(M,G)] under the null hypothesis of random overlap, using population size N, MF size m, GCF size g, and overlap count o: "calculate the hypergeometric expected value E[σ_corr(M,G)] and variance Var[σ_corr(M,G)] under the null hypothesis of random overlap, using population size N, MF size m, GCF size g, and overlap count"
  • [other] Standardise the strain correlation score as s_corr = (σ_corr − E[σ_corr]) / √Var[σ_corr] to yield zero mean and unit variance: "Standardise the strain correlation score as s_corr = (σ_corr − E[σ_corr]) / √Var[σ_corr] to yield zero mean and unit variance"
  • [other] The standardised strain correlation score has a mean of -0.0060 and variance of 1 across all links (compared to raw score mean of 83.5144), with standardised scores for validated links reaching 3.6717 (p=6.8302 × 10−64): "The standardised strain correlation score has a mean of -0.0060 and variance of 1 across all links, with standardised scores for validated links reaching 3.6717 (p=6.8302 × 10−64)"
  • [discussion] standardising the strain correlation score still suffers from the drawback inherent in correlation-based scoring, of not being able to distinguish between potential links showing the same pattern of: "standardising the strain correlation score still suffers from the drawback inherent in correlation-based scoring, of not being able to distinguish between potential links showing the same pattern of"

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.