agentsclimarketplace

Gene domain co occurrence analysis

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/gene-domain-co-occurrence-analysis

Use when you have a collection of BGCs tokenised as Pfam domain / subPfam combinations, have filtered them for redundancy using domain-based similarity networks, and need to discover latent gene sub-clusters that group together genes with correlated domain compositions.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill gene-domain-co-occurrence-analysis

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

  • 14 stars14 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.1k tokens by cl100k_base, as published. Nobody here has run it

gene-domain-co-occurrence-analysis

Summary

Apply topic modelling with Latent Dirichlet Allocation (LDA) to redundancy-filtered, tokenised Biosynthetic Gene Clusters (BGCs) to detect coherent gene sub-clusters based on Pfam domain co-occurrence patterns. This skill identifies functionally related gene groupings within larger BGCs that may be linked to specific natural product biosynthetic steps.

When to use

Apply this skill when you have a collection of BGCs tokenised as Pfam domain / subPfam combinations, have filtered them for redundancy using domain-based similarity networks, and need to discover latent gene sub-clusters that group together genes with correlated domain compositions. This is appropriate when seeking to link gene groupings to specific natural product substructures or to decompose large, complex BGCs into functionally coherent modules.

When NOT to use

  • Input BGCs have not been filtered for redundancy; apply redundancy filtering with domain-based similarity networks first.
  • Genes in input BGCs are not yet tokenised as Pfam/subPfam combinations; tokenisation and domain annotation are prerequisites.
  • You seek deterministic sub-cluster boundaries rather than probabilistic topic memberships; LDA produces soft assignments, not hard partitions.

Inputs

  • Redundancy-filtered tokenised BGCs in vector format (each gene represented as Pfam domain and subPfam combination)
  • Domain co-occurrence frequency matrix or token-document representation suitable for LDA

Outputs

  • Gene sub-cluster assignments (mapping of gene identifiers to sub-cluster IDs)
  • Topic-assignment weights table (per-gene topic probability scores across discovered sub-clusters)
  • LDA topic model parameters (domain-topic and gene-topic distributions)

How to apply

Load redundancy-filtered tokenised BGCs where each gene is represented as a Pfam domain / subPfam combination vector. Apply Latent Dirichlet Allocation topic modelling to the collection, treating domain co-occurrence patterns as the basis for topic inference. The LDA model learns latent topics (gene sub-clusters) by identifying which domains co-occur frequently across the BGC population. Extract topic-assignment weights for each gene and cluster genes by their dominant topic assignment. Structure the output as a table linking gene identifiers to assigned sub-cluster IDs and their corresponding topic-assignment weights. The rationale is that genes sharing similar domain compositions (high co-occurrence) likely participate in related biosynthetic steps and should cluster together; LDA captures this structure without requiring prior knowledge of sub-cluster boundaries.

Related tools

Evaluation signals

  • Gene-to-sub-cluster assignments are complete: every gene in the filtered input is assigned to at least one sub-cluster with a non-zero topic weight.
  • Topic-assignment weights sum to 1.0 per gene (or are constrained to a valid probability simplex), confirming LDA model convergence.
  • Detected sub-clusters exhibit high domain homogeneity: genes within the same sub-cluster share significantly more domain co-occurrence patterns than random sub-sets of genes.
  • Sub-cluster granularity is biologically meaningful: when downstream linked to natural product substructures, sub-cluster domain composition aligns with known enzymatic roles in biosynthetic pathways.
  • Model fit is reasonable: log-likelihood or perplexity metrics indicate the LDA model has converged and generalizes across held-out BGCs (if cross-validation is performed).

Limitations

  • LDA requires tuning of the number of latent topics (sub-clusters); no automatic method is provided in the article for selecting optimal topic count.
  • Performance depends critically on prior redundancy filtering step; incomplete or aggressive filtering can distort co-occurrence patterns.
  • LDA output is probabilistic and may assign single genes to multiple sub-clusters with comparable weights, complicating biological interpretation when hard assignments are needed.
  • The method assumes that domain co-occurrence patterns alone are sufficient to detect functionally meaningful sub-clusters; it does not incorporate gene order, regulation, or other genomic context.

Evidence

  • [other] PRESTO-TOP is a novel sub-cluster detection method that applies topic modelling with Latent Dirichlet Allocation: "PRESTO-TOP is a novel sub-cluster detection method that applies topic modelling with Latent Dirichlet Allocation to identify gene sub-clusters from redundancy-filtered tokenised BGCs."
  • [intro] Tokenisation by Pfam/subPfam combination: "BGCs are tokenised by representing each gene as a combination of its Pfam domains, where subPfams are used to increase resolution"
  • [intro] Redundancy filtering rationale: "Tokenised BGCs are filtered for redundancy using similarity network with an Adjacency Index of domains as a distance metric"
  • [other] Domain co-occurrence as basis for sub-clustering: "Apply PRESTO-TOP topic modelling using Latent Dirichlet Allocation to identify coherent gene sub-clusters based on domain co-occurrence patterns."
  • [other] Output structure with weights: "Extract and structure detected sub-clusters with gene membership and topic-assignment weights."

What ships with it

Read from the repository

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

Keep looking

Skills are one crate of 326,871. 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.