agentsclimarketplace

Statistical sub cluster detection

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/statistical-sub-cluster-detection

Use when you have a collection of Biosynthetic Gene Clusters that have been tokenised into Pfam domain and subPfam sequences and filtered for redundancy, and you seek to identify statistically significant groupings of genes that co-occur across multiple BGCs—particularly when downstream linking to.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill statistical-sub-cluster-detection

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

Statistical Sub-cluster Detection in Biosynthetic Gene Clusters

Summary

Identifies statistically significant co-occurring domain patterns within tokenised and redundancy-filtered Biosynthetic Gene Clusters using the PRESTO-STAT algorithm. This skill discovers functionally coherent gene sub-clusters that may encode specific natural product substructures.

When to use

Apply this skill when you have a collection of Biosynthetic Gene Clusters that have been tokenised into Pfam domain and subPfam sequences and filtered for redundancy, and you seek to identify statistically significant groupings of genes that co-occur across multiple BGCs—particularly when downstream linking to natural product substructures is planned.

When NOT to use

  • Input BGCs have not yet been tokenised into Pfam/subPfam domain representations
  • Tokenised BGCs have not been filtered for redundancy; applying PRESTO-STAT to raw, unfiltered tokenised data will conflate signals across highly similar clusters
  • The research goal is exploratory phenotyping or phylogenetic profiling rather than identifying functionally coherent sub-clusters linked to discrete biosynthetic outcomes

Inputs

  • Tokenised BGCs (Pfam domain + subPfam tokens per gene)
  • Redundancy-filtered BGC collection (pre-filtered by Adjacency Index similarity network)

Outputs

  • Detected sub-clusters with constituent genes
  • Domain compositions for each sub-cluster
  • Genomic positions of sub-cluster members
  • Statistical significance scores or p-values
  • Structured sub-cluster records (JSON/tabular format)

How to apply

Load redundancy-filtered tokenised BGCs (represented as Pfam domain and subPfam tokens per gene). Apply the PRESTO-STAT statistical algorithm, which is based on the methodology from Del Carratore et al. (2019), to detect statistically significant co-occurring domain patterns across the tokenised sequences. The algorithm identifies domain composition signatures that appear together more frequently than expected by chance. Extract detected sub-clusters recording their constituent genes, domain compositions, and genomic positions. Export results to a structured format (e.g., JSON or tabular) that preserves sub-cluster identity, member genes, domain tokens, and statistical significance scores.

Related tools

Evaluation signals

  • Detected sub-clusters are non-empty and contain at least 2 member genes with shared or complementary domain patterns
  • Each sub-cluster record includes all required fields: constituent gene IDs, Pfam/subPfam domain tokens, genomic coordinates, and statistical significance (p-value or confidence score)
  • Sub-clusters show higher within-cluster domain co-occurrence than expected in a permuted or random background distribution (as quantified by the PRESTO-STAT algorithm)
  • Sub-cluster domain compositions are consistent with known biosynthetic modules or enzyme classes (e.g., adenylation + condensation + oxidoreductase combinations)
  • No sub-cluster spans a genomic distance exceeding biologically plausible operonic or chromosomal linkage scales for the target organism

Limitations

  • PRESTO-STAT relies on statistical significance of domain co-occurrence; rare or novel domain combinations may be missed if sample size is small
  • The method assumes Pfam and subPfam annotations are available and accurate; gaps or errors in reference databases propagate to sub-cluster detection
  • Sub-clusters detected are correlative (co-occurring patterns) rather than directly evidence for functional co-regulation or co-expression
  • Performance and sensitivity depend on upstream redundancy filtering parameters (Adjacency Index threshold); poorly tuned filtering may either over-collapse diverse sub-clusters or retain redundant copies that confound statistical signals

Evidence

  • [other] PRESTO-STAT is a sub-cluster detection method based on the statistical algorithm from Del Carratore et al. (2019), designed to identify gene sub-clusters within tokenised BGCs that have been filtered for redundancy.: "PRESTO-STAT is a sub-cluster detection method based on the statistical algorithm from Del Carratore et al. (2019), designed to identify gene sub-clusters within tokenised BGCs that have been filtered"
  • [intro] BGCs are tokenised by representing each gene as a combination of its Pfam domains, where subPfams are used to increase resolution: "BGCs are tokenised by representing each gene as a combination of its Pfam domains, where subPfams are used to increase resolution"
  • [intro] Tokenised BGCs are filtered for redundancy using similarity network with an Adjacency Index of domains as a distance metric: "Tokenised BGCs are filtered for redundancy using similarity network with an Adjacency Index of domains as a distance metric"
  • [intro] For the detection of sub-clusters two methods are used: PRESTO-STAT, which is based on the statistical algorithm from Del Carratore et al. (2019): "For the detection of sub-clusters two methods are used: PRESTO-STAT, which is based on the statistical algorithm from Del Carratore et al. (2019)"
  • [intro] The sub-clusters found with iPRESTO can then be linked to Natural Product substructures: "The sub-clusters found with iPRESTO can then be linked to Natural Product substructures"

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.