Organism context metabolic plausibility assessment
Use when when BioTransformer or another metabolism predictor has generated a list of candidate metabolite structures (in SMILES or InChI format) for a query compound, and you need to identify which candidates are most likely to occur in a specific organism or environment (e.From its SKILL.md
npx -y skills add HolobiomicsLab/asb-skill-collections --skill organism-context-metabolic-plausibility-assessmentAssembled 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.4 KB, ~1.4k tokens by cl100k_base, as published. Nobody here has run it
organism-context-metabolic-plausibility-assessment
License: noncommercial — confirm your use is a permitted (noncommercial) purpose before applying; commercial use requires a separate license (see
metadata.tool_license). <!-- asb-license-banner -->
Summary
Rank and filter predicted metabolite candidates by their biological plausibility within a specific organismal context (mammalian, gut microbial, or soil/aquatic). This skill validates computationally predicted structures against the metabolic capacity and biochemistry of the target organism or environment, reducing false positives in metabolite identification.
When to use
When BioTransformer or another metabolism predictor has generated a list of candidate metabolite structures (in SMILES or InChI format) for a query compound, and you need to identify which candidates are most likely to occur in a specific organism or environment (e.g., human liver, human gut microbiota, soil/aquatic microbiota). Use this skill to filter and rank candidates before querying chemical databases, so that only biologically plausible structures are retained.
When NOT to use
- The input is a single predicted metabolite structure with no alternatives to rank; plausibility assessment is most valuable when discriminating among multiple candidates.
- The organism or environment context is not clearly specified or is non-standard (e.g., an unusual host or engineered microbiome); BioTransformer's built-in contexts (mammalian, hgut, envimicro) may not capture your specific scenario accurately.
- Your goal is rapid structure annotation without regard to metabolic realism; if you only need a list of possible products for computational screening, this skill adds unnecessary filtering overhead.
Inputs
- predicted metabolite structures (SMILES or InChI format)
- query compound identifier
- target organism or environment context (e.g., 'mammalian', 'human gut microbial', 'soil/aquatic microbial')
Outputs
- ranked candidate metabolite list with confidence scores
- filtered set of plausible metabolite structures retained for database matching
How to apply
After obtaining predicted metabolite structures from BioTransformer, assess each candidate's plausibility by evaluating its compatibility with the metabolic pathways, enzyme families, and biochemical transformations known to occur in the target organism or environment. Score candidates based on: (1) whether the structural transformation matches known Phase I (oxidation/reduction), Phase II (conjugation/deconjugation), or microbial enzymatic reactions documented in the target context; (2) the evolutionary prevalence of the relevant enzyme classes in that organism; and (3) the biological relevance of the product structure (e.g., increased water solubility for Phase II products, or intermediates that feed into central metabolism). Rank candidates by confidence and filter to retain only those scoring above a context-appropriate threshold before proceeding to database lookups.
Related tools
- BioTransformer (Generates predicted metabolite structures and supports metabolite identification assisted by organism-specific metabolic context (mammalian, gut microbial, environmental microbial modules)) — https://github.com/Wishartlab-openscience/Biotransformer
Examples
java -jar biotransformer-3.0.0.jar -k cid -b allHuman -ismi "O[C@@H]1CC2=C(O)C=C(O)C=C2O[C@@H]1C1=CC=C(O)C(O)=C1" -osdf output.sdf -s 2 -m "292.0946;304.0946" -t 0.01 -a
Evaluation signals
- Ranked candidate list includes confidence scores or plausibility ranks per candidate, with biological justification tied to documented enzymatic pathways in the target organism.
- Filtered set size is reduced compared to the raw prediction output, indicating that implausible structures have been removed.
- Downstream database queries (PubChem, ChEMBL, HMDB) on the filtered candidates return higher match rates and higher-confidence identifications compared to unfiltered candidates.
- Manual spot-checks of top-ranked candidates confirm that their structural transformations are consistent with known Phase I/II or microbial metabolism in the specified organism/environment.
- Confidence scores or filtering threshold are documented, allowing reproducibility and adjustment if downstream validation reveals false positives or false negatives.
Limitations
- BioTransformer's metabolic rules and enzyme coverage are precomputed and may not capture rare or recently characterized biotransformation pathways specific to your organism or environment.
- Confidence scoring relies on heuristics encoded in BioTransformer and may not reflect the true metabolic likelihood in all cases; validation against authentic metabolomic or in vitro data is recommended.
- Organism contexts supported by BioTransformer are coarse (mammalian, human gut, soil/aquatic); if your target organism is a non-human mammal, plant, fungus, or specialized microbiome, predictions may be less accurate.
- Plausibility assessment does not account for kinetic factors (enzyme Km, Vmax) or saturation effects that influence which metabolites actually accumulate in vivo; structural plausibility is necessary but not sufficient for quantitative prediction.
Evidence
- [other] BioTransformer assists scientists in metabolite identification by using metabolism predictions as input; the identification assistance mechanism operates on predicted metabolites generated from the prior metabolism prediction step.: "BioTransformer assists scientists in metabolite identification by using metabolism predictions as input; the identification assistance mechanism operates on predicted metabolites generated from the"
- [other] Score and rank candidate identifications by structural similarity, database coverage, and biological plausibility within the relevant organism/environment context (mammalian, gut microbial, or soil/aquatic).: "Score and rank candidate identifications by structural similarity, database coverage, and biological plausibility within the relevant organism/environment context (mammalian, gut microbial, or"
- [readme] BioTransformer is a software tool that predicts small molecule metabolism in mammals, their gut microbiota, as well as the soil/aquatic microbiota.: "BioTransformer is a software tool that predicts small molecule metabolism in mammals, their gut microbiota, as well as the soil/aquatic microbiota."
- [readme] The type of biotransformer - EC-based (ecbased), CYP450 (cyp450), Phase II (phaseII), Human gut microbial (hgut), human super transformer (superbio, or allHuman), Environmental microbial (envimicro).: "The type of biotransformer - EC-based (ecbased), CYP450 (cyp450), Phase II (phaseII), Human gut microbial (hgut), human super transformer (superbio, or allHuman), Environmental microbial (envimicro)."
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.