adme-property-predictor

Files (4)

• SKILL.md
• _meta.json
• requirements.txt
• main.py · scripts/

SKILL.md (first lines)

# ADME Property Predictor

## Overview

Comprehensive pharmacokinetic prediction tool that assesses drug-likeness and ADME properties of small molecules using validated cheminformatics models, molecular descriptors, and structure-property relationships.

**Key Capabilities:**
- **Multi-Property Prediction**: Absorption, Distribution, Metabolism, Excretion
- **Drug-Likeness Scoring**: Lipinski's Rule of 5, Veber rules, QED score
- **Batch Processing**: Analyze compound libraries efficiently
- **Structure-Based Insights**: Identify liability hotspots and optimization opportunities
- **Comparative Analysis**: Rank candidates by predicted PK profile

## When to Use

**✅ Use this skill when:**
- Screening compound libraries for drug-like properties in early discovery
- Prioritizing lead compounds for advancement based on predicted PK
- Identifying ADME liabilities requiring structural optimization
- Comparing analogs to select candidates with optimal ADME profiles
- Filtering virtual screening hits before synthesis
- Generating ADME data for regulatory pre-submission packages
- Teaching pharmacokinetics and drug design principles

**❌ Do NOT use when:**
- Exact PK parameters needed for dosing → Use experimental PK studies
- Biologics (antibodies, proteins) → Use `antibody-pk-predictor`
- Natural products with complex structures → Models trained on synthetic small molecules
- Prodrugs requiring metabolic activation → Use `prodrug-activation-predictor`
- Prediction for clinical dosing decisions → **CRITICAL**: Experimental validation required
- Assessing toxicity or safety → Use `toxicity-structure-alert` or `admetox-predictor`

**Related Skills:**
- **上游**: `chemical-structure-converter` (structure preparation), `lipinski-rule-filter` (rule-based filtering)
- **下游**: `drug-candidate-evaluator` (integrated scoring), `molecular-dynamics-sim` (detailed binding)

## Integration with Other Skills

**Upstream Skills:**
- `chemical-structure-converter`: Convert between SMILES, InChI, MOL formats
- `lipinski-rule-filter`: Initial rule-based drug-likeness screening
- `chemical-structure-converter`: Generate 3D conformers for structure-based predictions
- `smiles-de-salter`: Remove salt counterions before analysis

**Downstream Skills:**
- `drug-candidate-evaluator`: Multi-parameter optimization including ADME
- `toxicity-structure-alert`: Assess safety alongside ADME
- `target-novelty-scorer`: Evaluate target uniqueness for selected candidates
- `biotech-pitch-deck-narrative`: Create investor materials with PK data

**Complete Workflow:**
```
Chemical Structure Converter (prepare structures) → 
  Lipinski Rule Filter (initial filtering) → 
    ADME Property Predictor (this skill, detailed PK) → 
      Drug Candidate Evaluator (integrated scoring) → 
        Toxicity Structure Alert (safety check)
```

## Core Capabilities

### 1. Absorption (A) Prediction

Predict intestinal absorption, solubility, and permeability:

```python
from scripts.adme_predictor import ADMEPredictor

predictor = ADMEPredictor()

# Predict absorption properties
absorption = predictor.predict_absorption(
    smiles="CC(=O)Oc1ccccc1C(=O)O",  # Aspirin
    properties=["all"]  # or specific: ["hia", "caco2", "solubility"]
)

print(absorption.summary())
```

**Predicted Properties:**
| Property | Model | Units | Interpretation |
|----------|-------|-------|----------------|
| **HIA** | ML + physicochemical | % | Human intestinal absorption; >80% good |
| **Caco-2** | QSPR | 10⁻⁶ cm/s | Permeability; >70 high, <25 low |
| **Solubility** | QSPR | mg/mL | Aqueous solubility; >0.1 mg/mL acceptable |
| **LogS** | QSPR | unitless | Intrinsic solubility; >-4 acceptable |
| **Lipinski Pass** | Rule-based | boolean | Passes all 5 rules |
| **Veber Pass** | Rule-based | boolean | PSA <140, rotatable bonds <10 |

**Best Practices:**
- ✅ Consider HIA and solubility together (high HIA but low solubility = dissolution-limited)
- ✅ Caco-2 good for oral absorption prediction; poor for BBB penetration
- ✅ Use both rule-based (Lipinski) and ML-based predictions for consensus
- ✅ Check solubility at physiological pH (not just intrinsic)

**Common Issues and Solutions:**

**Issue: Lipinski pass but poor solubility**
- Symptom: "Passes Rule of 5 but LogS = -5"
- Solution: Lipinski checks MW and LogP, not solubility directly; use explicit solubility prediction

**Issue: Caco-2 predicts high absorption but HIA low**
- Symptom: "Caco-2 = 85 (high) but HIA = 60%"
- Solution: Models have different training sets; Caco-2 is in vitro, HIA in vivo; HIA generally more reliable

### 2. Distribution (D) Prediction

Predict tissue distribution, protein binding, and brain penetration:

```python
# Predict distribution properties
distribution = predictor.predict_distribution(
    smiles="CC(=O)Oc1ccccc1C(=O)O",
    properties=["vd", "ppb", "bbb"]
)

# Access specific predictions
vd = distribution.volume_of_distribution
bbb = distribution.blood_brain_barrier

From LeoYeAI/openclaw-master-skills, MIT.

More from LeoYeAI/openclaw-master-skills