agentsclimarketplace

Strain correlation hypergeometric adjustment

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v1/skills/strain-correlation-hypergeometric-adjustment

Use when you have genomic clusters (GCFs) and metabolomic features (MFs) from paired microbial datasets, each with strain membership information, and you need to score potential links between them.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill strain-correlation-hypergeometric-adjustment

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.7 KB, ~1.1k tokens by cl100k_base, as published. Nobody here has run it

strain-correlation-hypergeometric-adjustment

Summary

Compute standardised strain correlation scores for genomic-metabolomic links by adjusting raw co-occurrence counts against a hypergeometric null distribution. This makes correlation scores comparable across datasets and significantly enriches for validated links by accounting for expected co-occurrence by chance.

When to use

You have genomic clusters (GCFs) and metabolomic features (MFs) from paired microbial datasets, each with strain membership information, and you need to score potential links between them. Raw strain correlation counts are difficult to compare across datasets with different strain compositions and link densities. Use this skill when you want a standardised, statistically grounded score that accounts for the probability of observing co-occurrence by random chance alone.

When NOT to use

  • Input datasets lack strain-level metadata or genomes are not assigned to specific isolates/strains.
  • You are comparing links within a single, homogeneous strain or environmental sample where strain variation is negligible.
  • Raw co-occurrence counts are already heavily skewed by experimental design (e.g., targeted isolation of specific strains), making hypergeometric assumptions invalid.

Inputs

  • Genomic Cluster Family (GCF) strain membership lists
  • Metabolomic Feature (MF) strain membership lists
  • GCF-MF pair candidate set

Outputs

  • Raw strain correlation scores (σ_corr) per GCF-MF pair
  • Standardised strain correlation scores (σ*_corr) per GCF-MF pair
  • Expected value and variance parameters from hypergeometric null distribution

How to apply

For each GCF-MF pair, compute the raw strain correlation score (number of strains in which both the GCF and MF are observed). Then standardise this score using the expected value and variance of the hypergeometric distribution under the null hypothesis of independent strain membership. The standardised score σ*_corr = (raw_count − expected_value) / sqrt(variance) makes scores directly comparable and enables pooling results across datasets with different strain counts. Filter or rank links by the standardised score to prioritise those with strain co-occurrence significantly exceeding chance expectation.

Related tools

Evaluation signals

  • Standardised correlation scores for validated links show significantly higher mean and median than scores for all hypothetical links (e.g., p < 0.001 by t-test or Mann–Whitney U).
  • Standardised scores follow approximately normal distribution with mean ≈ 0 and variance ≈ 1 across the full link population.
  • Links at the 90th percentile for standardised correlation show significantly enriched proportion of validated links compared to lower percentiles (Fisher exact test, p < 0.05).
  • Standardised scores are comparable across datasets with different strain counts: no systematic bias in score magnitude across datasets.
  • Joint filtering (both standardised correlation and orthogonal scoring method at 90th percentile) yields higher validated link enrichment than either method alone.

Limitations

  • Hypergeometric assumption requires that strain presence/absence is approximately independent across GCFs and MFs, which may not hold for closely related organisms or if strains are preferentially enriched for specific metabolomic phenotypes.
  • Standardisation is sensitive to the total number of strains and link density; datasets with very few strains or very sparse GCF-MF co-occurrence may have unstable variance estimates.
  • The method does not account for phylogenetic relatedness among strains; identical score standardisation is applied whether co-occurrence reflects true biosynthetic linkage or shared evolutionary history.

Evidence

  • [other] Compute raw and standardised strain correlation scores (σ_corr and σ_corr) for each GCF-MF pair using hypergeometric null distribution with expected value and variance adjustment.: "Compute raw and standardised strain correlation scores (σ_corr and σ_corr) for each GCF-MF pair using hypergeometric null distribution with expected value and variance adjustment."
  • [abstract] GCF and spectrum pairs are then scored based upon their shared strains: "GCF and spectrum pairs are then scored based upon their shared strains"
  • [other] Standardised correlation score mean for all links: -0.0060; for validated links: 3.6717 (p=6.8302 × 10−64): "Standardised correlation score mean for all links: -0.0060; for validated links: 3.6717 (p=6.8302 × 10−64)"
  • [other] Both of the IOKR and standardised strain correlation scores are significantly enriched (p-value of 0.0139 and 2.483 × 10−11, respectively) for validated links: "both the IOKR and standardised strain correlation scores are significantly enriched (p-value of 0.0139 and 2.483 × 10−11, respectively) for validated links"
  • [abstract] A standardised strain correlation score improves comparability across links: "A standardised strain correlation score improves comparability across links"

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.