fadrienne/apps/molecular-optimization

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Iterative lead optimization with analyze-reason-generate-verify-evaluate loop. Paper-backed (MT-Mol, DrugR, MultiMol).

Install

npx vskill@latest install fadrienne/apps/molecular-optimization

SKILL.md

Molecular Optimization

Overview

Lead optimization is the bottleneck of drug discovery — modifying a hit compound to improve potency, selectivity, and ADMET properties without breaking what already works. LLMs frequently generate invalid SMILES or propose modifications that don't appear in the actual structure.

This skill implements an iterative optimization protocol based on three peer-reviewed approaches:

  • MT-Mol (Kim et al., 2025): Multi-agent tool-based reasoning with verification — SOTA on 17/23 PMO benchmark tasks
  • DrugR (Liu et al., 2026): Explicit liability reasoning before generation — 18× improvement over blind generation
  • MultiMol (Yu et al., 2025): Generate-then-rank with scaffold preservation — 82.3% multi-objective success rate

The core loop: Analyze → Identify Liabilities → Generate Candidates → Verify → Evaluate & Rank → Iterate.

When to Use This Skill

  • Lead optimization: Improve ADMET properties of a hit while preserving potency
  • Scaffold hopping: Find new scaffolds that maintain key pharmacophoric features
  • Property-driven design: Generate analogs targeting specific property improvements (lower LogP, reduce hERG, improve solubility)
  • Multi-objective optimization: Balance multiple properties simultaneously

Do NOT use this skill for:

  • De novo design from scratch (use denovo-design instead)
  • Simple property prediction without optimization (use admet-prediction)
  • Docking or binding affinity estimation (use molecular-docking, binding-affinity)
Related Skills
  • admet-prediction: Compute ADMET properties (this skill uses it internally)
  • admet-reasoning: Interpretable ADMET analysis with mechanistic explanations
  • smiles-validation: Strict SMILES parsing and structural verification
  • rdkit: Core molecular operations
  • medchem: Medicinal chemistry filters and transformations

Installation

Required dependencies
bash
pip install rdkit-pypi numpy pandas
Optional dependencies
bash
pip install PyTDC datamol
  • PyTDC: Access to TDC ADMET predictors for enhanced property scoring
  • datamol: Convenient molecular manipulation utilities

Core Workflows

1. Single-Molecule Optimization

Optimize one molecule for improved properties:

bash
python scripts/optimize.py \
--smiles "c1ccc(NC(=O)c2ccccc2Cl)cc1" \
--targets "LogP<3,hERG<0.3,QED>0.5" \
--max-iterations 3 \
--candidates 8 \
--output results.json
2. Batch Optimization

Optimize a CSV of molecules:

bash
python scripts/optimize.py \
--input leads.csv \
--smiles-col SMILES \
--targets "LogP<3,hERG<0.3" \
--output optimized.csv
3. Verification Only

Verify a proposed SMILES matches a claimed modification:

bash
python scripts/verify_smiles.py \
--original "c1ccccc1" \
--proposed "c1ccc(O)cc1" \
--claimed-modification "Added hydroxyl group at para position"
4. Candidate Comparison

Compare multiple candidates against a reference:

bash
python scripts/compare_candidates.py \
--reference "c1ccc(NC(=O)c2ccccc2Cl)cc1" \
--candidates candidates.csv \
--output comparison.html

Script Reference

ScriptPurposeKey Outputs
optimize.pyFull iterative optimization loopresults.json with ranked candidates, descriptor deltas, reasoning
verify_smiles.pyValidate SMILES and check claimed modificationsPass/fail report with structural analysis
compare_candidates.pySide-by-side descriptor comparisonComparison table (CSV/HTML) with liability flags

Optimization Protocol Detail

Step 1: ANALYZE

Compute molecular descriptors: MW, LogP, TPSA, HBA, HBD, RotBonds, QED, aromatic rings, Murcko scaffold. Flag properties outside ADMET target thresholds.

Step 2: IDENTIFY LIABILITIES

Rank flagged properties by severity (hERG > DILI > CYP > solubility). For each, identify the structural feature causing the liability and propose a specific modification.

Step 3: GENERATE CANDIDATES

Apply proposed modifications via:

  • Bioisosteric replacement (e.g., phenyl → pyridine, amide → sulfonamide)
  • Functional group addition/removal
  • Ring system modification
  • Chain length adjustment

Generate 4-8 candidates per iteration.

Step 4: VERIFY

For each candidate:

  1. Chem.MolFromSmiles() — discard if None
  2. Scaffold preservation: Murcko scaffold match
  3. Tanimoto similarity (ECFP4): flag if < 0.4
  4. Structural verification: confirm claimed modification exists
Step 5: EVALUATE & RANK

Recompute descriptors, build comparison table, score by net liability improvement (+1 per fix, -0.5 per new liability).

Step 6: ITERATE

If no improvement after 3 iterations, return best found with honest assessment.

ADMET Target Thresholds

PropertyTargetSeverity
hERG inhibition< 0.3Critical
DILI< 0.5Critical
CYP inhibition< 0.5High
LogP1.0 – 3.0Medium
TPSA20 – 130Medium
MW150 – 500Medium
QED> 0.5Low
Solubility (LogS)> -4.0Medium

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/fadrienne/apps/molecular-optimization/badge)](https://verified-skill.com/skills/fadrienne/apps/molecular-optimization)

Something wrong with this skill or its page? Tell us.