mims-harvard/tooluniverse

tooluniverse-toxicology

Drug and chemical toxicity assessment via adverse outcome pathways (AOPs), real-world FAERS adverse event signals, FDA labels, and toxicogenomic associations.

First seen Mar 25, 2026

Installation

$ npx skills add mims-harvard/tooluniverse --skill tooluniverse-toxicology

Summary

  • Drug and chemical toxicity assessment via adverse outcome pathways (AOPs), real-world FAERS adverse event signals, FDA labels, and toxicogenomic associations.
  • Triangulates molecular initiating event to cellular outcome to organ-level toxicity to clinical adverse event.
  • Use for hepatotoxicity/cardiotoxicity/nephrotoxicity prediction and toxicology reports.

Also in this package

Other skills from mims-harvard/tooluniverse · top by installs.

npx skills add mims-harvard/tooluniverse

Browse all from mims-harvard/tooluniverse

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1.7K
License LICENSE
Default branch main
Open issues 9
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 12,466 B
  • docs SUMMARY.md 385 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 228 installs

SKILL.md

Toxicology Assessment via Adverse Outcome Pathways & Signal Detection

Systematic toxicology analysis that links molecular initiating events (MIEs) through adverse outcome pathways (AOPs) to apical adverse outcomes, then triangulates with real-world FAERS signals, FDA label data, and toxicogenomic associations.

Domain Reasoning

Toxicity has many mechanisms, and the first interpretive question is temporal: is this acute toxicity (immediate effect from a high dose) or chronic toxicity (cumulative damage from long-term low-dose exposure)? Acute and chronic toxicity operate through different mechanisms — acute hepatotoxicity may reflect direct mitochondrial damage, while chronic hepatotoxicity may involve fibrosis from repeated low-level inflammation. They also have different regulatory frameworks: acute toxicity is captured by LD50 and emergency protocols, while chronic toxicity requires long-term carcinogenicity and repeat-dose studies.

LOOK UP DON'T GUESS

  • Adverse outcome pathways for a chemical: query AOPWikilistaops and AOPWikigetaop; do not describe mechanisms from memory.
  • FAERS adverse event signals: retrieve from FAERScountreactionsbydrugevent and FAERScalculate_disproportionality; never estimate PRR values.
  • FDA label warnings: call DailyMedparseadverse_reactions and related tools; do not state boxed warnings from memory.
  • CTD chemical-gene and chemical-disease associations: query CTDgetchemicalgeneinteractions and CTDgetchemical_diseases; do not infer gene targets without database evidence.

COMPUTE, DON'T DESCRIBE

When analysis requires computation (statistics, data processing, scoring, enrichment), write and run Python code via Bash. Don't describe what you would do — execute it and report actual results. Use ToolUniverse tools to retrieve data, then Python (pandas, scipy, statsmodels, matplotlib) to analyze it.

When to Use This Skill

Triggers:

  • "What are the toxicity mechanisms for [drug/chemical]?"
  • "Find adverse outcome pathways for [chemical]"
  • "What AOPs are relevant to [target/organ/effect]?"
  • "FAERS signal analysis for [drug]"
  • "Toxicogenomic profile for [chemical]"
  • "What is the mechanism of hepatotoxicity / cardiotoxicity / neurotoxicity for [drug]?"

Use Cases:

  1. AOP Tracing: Map chemical MIE through key events to apical outcome using AOPWiki
  2. Real-World Signal Detection: Quantify FAERS adverse event signals with PRR/ROR
  3. Label Safety Mining: Extract FDA boxed warnings, contraindications, nonclinical toxicology
  4. Toxicogenomics: Chemical-gene-disease associations from CTD
  5. Integrated Mechanism Report: Combine AOP pathway + real-world signals into unified narrative

KEY PRINCIPLES

  1. AOP-first thinking - Frame all toxicity in terms of MIE → Key Events → Adverse Outcome
  2. Report-first approach - Create report file FIRST, update progressively
  3. Evidence grading mandatory - T1 (regulatory/clinical) through T4 (computational/AOP annotation)
  4. Distinguish mechanism from signal - AOPWiki = mechanism; FAERS = real-world signal
  5. Disambiguation first - Resolve drug/chemical identity before any queries
  6. English-first queries - Always use English names in tool calls

Evidence Grading

Tier Symbol Criteria
T1 [T1] FDA boxed warning, clinical trial toxicity finding, regulatory label
T2 [T2] FAERS signal PRR > 2, AOP with high biological plausibility, CTD curated
T3 [T3] CTD inferred association, AOP annotation with moderate plausibility
T4 [T4] Text-mined CTD entry, early-stage AOP annotation

Workflow Overview

Chemical/Drug Query
|
+-- PHASE 0: Disambiguation
|   Resolve name -> identifiers (ChEMBL, PubChem CID, SMILES)
|
+-- PHASE 1: Adverse Outcome Pathway Mapping (AOPWiki)
|   List AOPs by keyword; retrieve key events, MIEs, and biological plausibility scores
|
+-- PHASE 2: Real-World Adverse Event Signals (FAERS)
|   Top reactions by drug; disproportionality (PRR); serious event filter
|
+-- PHASE 3: FDA Label Safety Mining
|   Boxed warnings, contraindications, nonclinical toxicology, adverse reactions
|
+-- PHASE 4: Toxicogenomics (CTD)
|   Chemical-gene interactions; chemical-disease associations
|
+-- SYNTHESIS: Integrated Toxicology Report
    AOP-linked mechanism + FAERS signal + CTD gene targets + Risk classification

Phase 0: Disambiguation

Objective: Establish compound identity before any database queries.

Tools:

  • PubChemgetCIDbycompound_name (name: str) — get CID + SMILES
  • ChEMBLsearchdrugs (query: str) — get ChEMBL ID and max phase

Capture: generic name, SMILES, PubChem CID, ChEMBL ID, drug class.


Phase 1: Adverse Outcome Pathway Mapping

Objective: Find AOPs relevant to the chemical's known or suspected toxicity mechanisms.

Tools

AOPWikilistaops:

  • Input: keyword (str) — e.g., organ ("liver", "kidney"), effect ("apoptosis", "inflammation"), or target ("AhR", "PPARalpha")
  • Output: List of AOP IDs, titles, and short descriptions
  • Use: Discovery scan to identify candidate AOPs

AOPWikigetaop:

  • Input: aopid (int) — ID from listaops result
  • Output: Full AOP details including MIE, key events (KEs), key event relationships (KERs), biological plausibility, and weight-of-evidence
  • Use: Retrieve mechanistic pathway details for selected AOPs

Workflow

  1. Query AOPWikilistaops with organ-level keyword (e.g., "hepatotoxicity", "nephrotoxicity")
  2. Query again with mechanism-level keyword (e.g., "oxidative stress", "mitochondria")
  3. Select top 3-5 most relevant AOPs by title relevance
  4. Call AOPWikigetaop for each selected AOP
  5. Extract: MIE (molecular initiating event), key events in order, apical adverse outcome, biological plausibility score

Decision Logic

  • AOP found: Extract full pathway; note plausibility level (high/moderate/low)
  • No direct AOP match: Try broader organ or mechanism terms; document as "no AOP directly mapped"
  • Multiple AOPs: Report all; highlight shared key events as high-confidence mechanisms

AOP Table Format

AOP ID Title MIE Apical Outcome Plausibility
123 ... ... ... High

Phase 2: Real-World Adverse Event Signals (FAERS)

Objective: Quantify observed adverse events with statistical signal measures.

Tools

FAERScountreactionsbydrug_event:

  • Input: drug_name (str), limit (int, default 50)
  • Output: Top adverse reactions with counts
  • Note: param is drug_name not drug

FAERScalculatedisproportionality:

  • Input: drugname (str), reactionmeddra_pt (str)
  • Output: PRR, ROR, IC with confidence intervals

FAERSfilterserious_events:

  • Input: drugname (str), serioustype (str: "death", "hospitalization", "life-threatening")
  • Output: Serious event count and case details

FAERSstratifyby_demographics:

  • Input: drugname (str), reactionmeddra_pt (str)
  • Output: Age/sex breakdown for specific reaction

Workflow

  1. Get top 25 reactions via FAERScountreactionsbydrug_event
  2. Filter to organ-system clusters matching the AOP outcomes from Phase 1
  3. Calculate PRR for top 10 reactions via FAERScalculatedisproportionality
  4. Check serious events (deaths, hospitalizations) for highest-PRR reactions

Signal Thresholds

Signal Strength PRR Case Count
Strong > 3.0 >= 5
Moderate 2.0-3.0 >= 3
Weak 1.5-2.0 >= 3
None < 1.5 any

Phase 3: FDA Label Safety Mining

Objective: Extract regulatory safety findings from approved drug labels.

Tools

  • DailyMedparseadversereactions (drugname: str)
  • DailyMedparsecontraindications (drug_name: str)
  • DailyMedparseclinicalpharmacology (drugname: str)
  • DailyMedparsedruginteractions (drugname: str)

Note: These tools apply to FDA-approved drugs only. Environmental chemicals will have no label data — document explicitly.

Workflow

  1. Extract adverse reactions and note which match FAERS signals
  2. Extract contraindications (highest evidence tier [T1])
  3. Note pharmacological mechanism from clinical pharmacology section

Phase 4: Toxicogenomics (CTD)

Objective: Map chemical-gene interactions and chemical-disease associations.

Tools

CTDgetchemicalgeneinteractions:

  • Input: input_terms (str) — chemical name or MeSH ID
  • Output: Gene targets with interaction type (increases/decreases expression)
  • Use: Find molecular targets mediating toxicity

CTDgetchemical_diseases:

  • Input: input_terms (str) — chemical name or MeSH ID
  • Output: Disease associations with evidence type (curated/inferred)
  • Use: Find downstream disease endpoints

Workflow

  1. Query CTD with compound name; note curated (higher confidence) vs inferred entries
  2. Cross-reference gene targets with Phase 1 AOP key events
  3. Note which CTD disease endpoints match AOP apical outcomes

Synthesis: Integrated Toxicology Report

Structure:

# Toxicology Report: [Compound Name]
**Generated**: YYYY-MM-DD

## Executive Summary
Risk tier: CRITICAL / HIGH / MEDIUM / LOW / INSUFFICIENT DATA
Key finding summary (2-3 sentences)

## 1. Compound Identity
(disambiguation table)

## 2. Adverse Outcome Pathways [T3-T4]
(AOP table; pathway diagrams in text form)

## 3. Real-World Adverse Event Signals [T1-T2]
(FAERS top reactions + PRR table + serious events)

## 4. FDA Label Safety [T1]
(boxed warnings, contraindications, adverse reactions)

## 5. Toxicogenomics [T2-T4]
(CTD gene targets + disease associations)

## 6. Mechanistic Integration
(How AOP key events map to observed FAERS signals and CTD gene targets)

## 7. Risk Classification
(Final tier with rationale)

## Data Gaps & Limitations
(Missing data, confidence caveats)

Risk Classification

Tier Criteria
CRITICAL FDA boxed warning OR FAERS PRR > 5 with deaths OR multiple T1 findings
HIGH FAERS PRR 3-5 serious events OR FDA warning (non-boxed) OR high-plausibility AOP
MEDIUM FAERS PRR 2-3 OR CTD curated associations OR moderate-plausibility AOP
LOW All signals < PRR 2; no regulatory warnings; low-plausibility AOP only
INSUFFICIENT DATA Fewer than 3 phases returned usable data

Fallback Chains

Primary Tool Fallback 1 Fallback 2
AOPWikilistaops Broaden keyword Search by organ system
FAERScountreactionsbydrug_event OpenFDAsearchdrug_events Literature search
DailyMedparseadverse_reactions OpenFDAsearchdrug_events FAERS serious events
CTDgetchemical_diseases CTDgetchemicalgeneinteractions PubMed search

Tool Parameter Reference (Critical)

Tool WRONG CORRECT
FAERScountreactionsbydrug_event drug drug_name
AOPWikilistaops query keyword
CTDgetchemicalgeneinteractions chemical input_terms
CTDgetchemical_diseases chemical input_terms

Limitations

  • AOPWiki: AOPs are in development; many lack high plausibility scores
  • FAERS: Observational data; confounding by indication; underreporting bias
  • CTD: Inferred associations have high false-positive rate
  • DailyMed: FDA-approved drugs only; no environmental chemical coverage
  • Environmental chemicals: Primarily Phase 1 (AOP) + Phase 4 (CTD) data available

References