MCPInstall

tooluniverse-drug-target-validation

Quantitative drug-target validation pipeline. Scores druggability, selectivity, safety profile, ADMET feasibility, and structural tractability with a composite Target Validation Score (0-100) and GO/NO-GO recommendation. Use for go/no-go decisions on a target before commit-to-medchem, target prioritization across a list, and target-deselection rationale.

Installs
382
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/mims-harvard/tooluniverse --skill tooluniverse-drug-target-validation
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads tooluniverse-drug-target-validation automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Drug Target Validation Pipeline

Validate drug target hypotheses using multi-dimensional computational evidence before committing to wet-lab work. Produces a quantitative Target Validation Score (0-100) with priority tier classification and GO/NO-GO recommendation.

Reasoning Before Searching

A valid drug target must pass 4 gates in order. Failing an early gate makes later gates irrelevant:

  1. Genetic evidence linking it to disease: Does human genetic data (GWAS, rare variant studies, Mendelian genetics) support this target's role? Genetic evidence is the strongest predictor of clinical success. Use OpenTargets and GWAS catalog before anything else. If no genetic link exists, the hypothesis is speculative — document this clearly.
  2. Druggability: Can a molecule reach and modulate the target? Check structure availability (PDB, AlphaFold), binding pocket prediction (ProteinsPlus), target class (kinase, GPCR, nuclear receptor = favorable; transcription factor, scaffold protein = difficult), and existing chemical probes.
  3. Safety — essentiality in normal tissue: Is the target expressed in critical tissues (heart, liver, bone marrow)? Is knockout lethal in mice? High expression in essential tissue or lethality in mouse models is a strong safety red flag even before any clinical data.
  4. Competitive landscape: Are other drugs already approved or in late-stage trials for this target? If so, the bar is differentiation, not first-in-class. Check ChEMBL, DrugBank, and ClinicalTrials.gov early.

Do not proceed to Phase 3 (Chemical Matter) before completing Phase 1 (Disease Association). Gate 1 failures should prompt a NO-GO or pivot recommendation.

LOOK UP DON'T GUESS: Never assume a target is druggable based on its protein family alone, never assume expression is low in a tissue without checking GTEx or HPA, never assume no competitors without searching ClinicalTrials.gov.

RUN THE ML MODELS, DON'T SKIP THEM: When deep-learning predictors are available (ADMET-AI, ESMFold, AlphaFold, DoGSite, DynaMut2, DeepGO), run them even when database lookups or experimental data already cover the same property. The ML predictions provide an orthogonal, mechanistically-grounded estimate that's a first-class output of this skill — not a fallback. A target-validation report missing ML predictions is incomplete regardless of how much database evidence is present.

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.

Key Principles

  1. Report-first - Create report file FIRST, then populate progressively
  2. Target disambiguation FIRST - Resolve all identifiers before analysis
  3. Evidence grading - Grade all evidence as T1 (experimental) to T4 (computational)
  4. Disease-specific - Tailor analysis to disease context when provided
  5. Modality-aware - Consider small molecule vs biologics tractability
  6. Safety-first - Prominently flag safety concerns early
  7. Quantitative scoring - Every dimension scored numerically (0-100 composite)
  8. Negative results documented - "No data" is data; empty sections are failures
  9. Source references - Every statement must cite tool/database
  10. English-first queries - Always use English terms in tool calls; respond in user's language

When to Use

Apply when users ask about:

  • "Is [target] a good drug target for [disease]?"
  • Target validation, druggability assessment, or target prioritization
  • Safety risks of modulating a target
  • Chemical starting points for target validation
  • GO/NO-GO recommendation for a target

Not for (use other skills): general target biology (tooluniverse-target-research), drug compound profiling (tooluniverse-drug-research), variant interpretation (tooluniverse-variant-interpretation), disease research (tooluniverse-disease-research).

Input Parameters

ParameterRequiredDescriptionExample
targetYesGene symbol, protein name, or UniProt IDEGFR, P00533
diseaseNoDisease/indication for contextNon-small cell lung cancer
modalityNoPreferred therapeutic modalitysmall molecule, antibody, PROTAC

Reference Files

  • SCORING_CRITERIA.md - Detailed scoring matrices, evidence grading, priority tiers, score calculation
  • REPORT_TEMPLATE.md - Full report template, completeness checklist, section format examples
  • TOOL_REFERENCE.md - Verified tool parameters, known corrections, fallback chains, modality-specific guidance, phase-by-phase tool lists
  • QUICK_START.md - Quick start guide

Scoring Overview

Total: 0-100 points across 5 dimensions (details in SCORING_CRITERIA.md):

DimensionMaxSub-dimensions
Disease Association30Genetic (10) + Literature (10) + Pathway (10)
Druggability25Structure (10) + Chemical matter (10) + Target class (5)
Safety Profile20Expression (5) + Genetic validation (10) + ADRs (5)
Clinical Precedent15Based on highest clinical stage achieved
Validation Evidence10Functional studies (5) + Disease models (5)

Priority Tiers: 80-100 = Tier 1 (GO) | 60-79 = Tier 2 (CONDITIONAL GO) | 40-59 = Tier 3 (CAUTION) | 0-39 = Tier 4 (NO-GO)

Evidence Grades: T1 (clinical proof) > T2 (functional studies) > T3 (associations) > T4 (predictions)


Pipeline Phases

Phase 0: Target Disambiguation (ALWAYS FIRST)

Resolve target to ALL identifiers before any analysis.

Steps:

  1. MyGene_query_genes - Get initial IDs (Ensembl, UniProt, Entrez)
  2. ensembl_lookup_gene - Get versioned Ensembl ID (species="homo_sapiens" REQUIRED)
  3. ensembl_get_xrefs - Cross-references (HGNC, etc.)
  4. OpenTargets_get_target_id_description_by_name - Verify OT target
  5. ChEMBL_search_targets - Get ChEMBL target ID
  6. UniProt_get_function_by_accession - Function summary (returns list of strings)
  7. UniProt_get_alternative_names_by_accession - Collision detection

Output: Table of verified identifiers (Gene Symbol, Ensembl, UniProt, Entrez, ChEMBL, HGNC) plus protein function and target class.

Optional fast cross-database search: TargetMine_search(q=<gene>, facet_Category="Gene") / TargetMine_search_genes(q=<gene>) queries one InterMine warehouse that already integrates UniProt, PDB, ChEMBL, Reactome, KEGG, DrugBank, TTD, and clinical-trials data — useful as a quick single-call sanity check that a gene/target resolves consistently across sources before running the full per-database Phase 0-1 sequence, not a replacement for it (verified live: TargetMine_search(q="EGFR", facet_Category="Gene") returns real hits with organism/category facets in ~0.3s).

Phase 1: Disease Association (0-30 pts)

Quantify target-disease association from genetic, literature, and pathway evidence.

Key tools:

  • OpenTargets_get_diseases_phenotypes_by_target_ensembl - Disease associations
  • OpenTargets_target_disease_evidence - Detailed evidence (needs efoId + ensemblId)
  • OpenTargets_get_evidence_by_datasource - Evidence by data source
  • gwas_get_snps_for_gene / gwas_search_studies - GWAS evidence
  • gnomad_get_gene_constraints - Genetic constraint (pLI, LOEUF)
  • PubMed_search_articles - Literature (returns plain list of dicts)
  • OpenTargets_get_publications_by_target_ensemblID - OT publications (uses entityId)

Phase 2: Druggability (0-25 pts)

Assess whether the target is amenable to therapeutic intervention.

Key tools:

  • OpenTargets_get_target_tractability_by_ensemblID - Tractability (SM, AB, PR, OC)
  • OpenTargets_get_target_classes_by_ensemblID - Target classification
  • Pharos_get_target - TDL: Tclin > Tchem > Tbio > Tdark
  • DGIdb_get_gene_druggability - Druggability categories
  • alphafold_get_prediction (param: qualifier) / alphafold_get_summary
  • ProteinsPlus_predict_binding_sites - Pocket detection
  • OpenTargets_get_chemical_probes_by_target_ensemblID - Chemical probes
  • OpenTargets_get_target_enabling_packages_by_ensemblID - TEPs
  • TCDB_get_transporter - For SLC/ABC transporter targets: TC classification, family, PDB structures (param: uniprot_accession)
  • TCDB_search_by_substrate - Find transporters by substrate (param: substrate_name)

Phase 2b: Kinase-Specific Structural Data (KLIFS)

When the target class is a protein kinase, don't stop at the generic tractability/structure checks above — KLIFS (Kinase-Ligand Interaction Fingerprints and Structures) gives kinase-specific binding-pocket-conformation data that generic PDB/AlphaFold lookups don't:

  • KLIFS_list_kinases(kinase_group, species) - find the KLIFS kinase ID by group (TK, TKL, STE, CK1, AGC, CAMK, CMGC, RGC, Other) or list all; match by gene symbol in the response
  • KLIFS_get_kinase(kinase_ID) - kinase family/group, UniProt/IUPHAR cross-refs, and the 80-residue standardized KLIFS pocket sequence
  • KLIFS_get_structures(kinase_ID) - every annotated crystal structure for the kinase, each with DFG-loop conformation (in/out/out-like) and alphaC-helix conformation (in/out), resolution, quality score, and bound ligand
  • KLIFS_get_structures_by_pdb(pdb_codes) - same DFG/alphaC annotation, looked up by PDB code(s) instead of kinase ID (comma-separated for multiple)
  • KLIFS_get_ligands(kinase_ID) - every co-crystallized inhibitor across all of that kinase's structures, with SMILES/InChIKey — the fastest way to enumerate known chemical starting points for a kinase target

Why DFG/alphaC state matters for druggability scoring: DFG-in + alphaC-in is the active conformation (ATP-competitive Type I inhibitors bind here). DFG-out structures expose an allosteric back pocket adjacent to the ATP site (Type II inhibitors, e.g. imatinib) — a kinase with confirmed DFG-out structures has a second, often more selective, druggable pocket beyond the ATP site, which should raise its druggability sub-score. A kinase with only DFG-in structures across hundreds of PDB entries may be harder to hit selectively with a Type II strategy. Report the DFG/alphaC state distribution (e.g. "527 DFG-in / 23 DFG-out / 15 DFG-out-like structures") as evidence, not just a structure count.

Phase 3: Chemical Matter (feeds Phase 2 scoring)

Identify existing chemical starting points for target validation.

Key tools:

  • ChEMBL_search_targets + ChEMBL_get_target_activities - Bioactivity data (note: target_chembl_id__exact with double underscore)
  • BindingDB_get_ligands_by_uniprot - Binding data (affinity in nM)
  • PubChem_search_assays_by_target_gene + PubChem_get_assay_active_compounds - HTS data
  • OpenTargets_get_associated_drugs_by_target_ensemblID - Known drugs (size REQUIRED)
  • ChEMBL_search_mechanisms - Drug mechanisms
  • DGIdb_get_gene_info - Drug-gene interactions

Phase 3b: ADMET-AI Deep-Learning Profile (REQUIRED)

For each lead / approved compound identified above, run all ten ADMET-AI Chemprop-GNN endpoints. This is a required deliverable of the skill, not optional:

EndpointTool
Physicochemical (MW, logP, HBA/HBD, TPSA)ADMETAI_predict_physicochemical_properties
Toxicity (AMES, DILI, LD50, carcinogens, skin sensitizers, ClinTox)ADMETAI_predict_toxicity
BBB penetranceADMETAI_predict_BBB_penetrance
CYP interactions (1A2, 2C9, 2C19, 2D6, 3A4)ADMETAI_predict_CYP_interactions
Bioavailability (HIA, PAMPA, Caco-2, F20/F30)ADMETAI_predict_bioavailability
Clearance & distribution (hepatocyte, microsome, VDss, PPB)ADMETAI_predict_clearance_distribution
Nuclear receptor activity (NR-AR, NR-AhR, NR-Aromatase, NR-ER, NR-PPAR-γ)ADMETAI_predict_nuclear_receptor_activity
Stress response (SR-ARE, SR-ATAD5, SR-HSE, SR-MMP, SR-p53)ADMETAI_predict_stress_response
Solubility, lipophilicity, hydrationADMETAI_predict_solubility_lipophilicity_hydration
Metabolism (CYP-mediated)ADMETAI_predict_CYP_interactions

Required output — ADMET head-to-head table: when two or more candidate drugs exist (approved or late-stage), produce a side-by-side comparison table with every endpoint in the same row and a "Winner" column flagging which drug is safer. This table is the primary visual of the report and must not be abbreviated or summarized into prose.

ADMET-AI fallback (IMPORTANT): If MCP calls to ADMETAI_predict_* fail, return empty, or timeout, run them via Bash + Python SDK instead:

from tooluniverse import ToolUniverse
tu = ToolUniverse()
tu.load_tools()
for endpoint in ['physicochemical_properties','toxicity','BBB_penetrance','CYP_interactions',
                 'bioavailability','clearance_distribution','nuclear_receptor_activity',
                 'stress_response','solubility_lipophilicity_hydration']:
    r = tu.run_one_function({'name': f'ADMETAI_predict_{endpoint}',
                              'arguments': {'smiles_list': [SMILES_DRUG_A, SMILES_DRUG_B]}})
    print(f'{endpoint}: {r}')

This SDK path bypasses the CLI subprocess and avoids segfault issues with torch. Always try MCP first; use this fallback if MCP returns no data.

Phase 4: Clinical Precedent (0-15 pts)

Assess clinical validation from approved drugs and clinical trials.

Key tools:

  • FDA_get_mechanism_of_action_by_drug_name / FDA_get_indications_by_drug_name
  • drugbank_get_targets_by_drug_name_or_drugbank_id (ALL params required: query, case_sensitive, exact_match, limit)
  • search_clinical_trials (query_term REQUIRED)
  • OpenTargets_get_drug_warnings_by_chemblId / OpenTargets_get_drug_adverse_events_by_chemblId

Phase 5: Safety (0-20 pts)

Identify safety risks from expression, genetics, and known adverse events.

Key tools:

  • OpenTargets_get_target_safety_profile_by_ensemblID - Safety liabilities
  • GTEx_get_median_gene_expression - Tissue expression (operation="median" REQUIRED)
  • HPA_search_genes_by_query / HPA_get_comprehensive_gene_details_by_ensembl_id
  • OpenTargets_get_biological_mouse_models_by_ensemblID - KO phenotypes
  • FDA_get_adverse_reactions_by_drug_name / FDA_get_boxed_warning_info_by_drug_name
  • OpenTargets_get_target_homologues_by_ensemblID - Paralog risks

Critical tissues to check: heart, liver, kidney, brain, bone marrow.

Phase 6: Pathway Context

Understand the target's role in biological networks and disease pathways.

Key tools:

  • Reactome_map_uniprot_to_pathways (param: id, NOT uniprot_id)
  • STRING_get_protein_interactions (param: protein_ids as array, species=9606)
  • intact_get_interactions - Experimental PPI
  • OpenTargets_get_target_gene_ontology_by_ensemblID - GO terms
  • STRING_functional_enrichment - Enrichment analysis

Assess: pathway redundancy, compensation risk, feedback loops.

Phase 7: Validation Evidence (0-10 pts)

Assess existing functional validation data.

Key tools:

  • DepMap_get_gene_dependencies - Essentiality (score < -0.5 = essential)
  • PubMed_search_articles - Search for CRISPR/siRNA/knockout studies
  • CTD_get_gene_diseases - Gene-disease associations

Phase 8: Structural Insights

Leverage structural biology for druggability and mechanism understanding. ALWAYS run both the deep-learning predictors (ESMFold, DoGSite) AND retrieve experimental structures, even when high-resolution PDB entries already exist. The ML models give an independent pLDDT/druggability score that is a required output of this phase.

Required tool calls (every run):

  • ESMFold_predict_structure — Meta ESM-2 language-model structure prediction from the UniProt sequence. Report: model pLDDT, worst-residue confidence, RMSD vs. reference PDB if available.
  • alphafold_get_prediction / alphafold_get_summary — DeepMind AlphaFold model + per-residue pLDDT.
  • ProteinsPlus_predict_binding_sites — DoGSite deep-learning pocket scoring. Report: top 3 pockets with volume, druggability score, residue composition.

Supporting tools:

  • UniProt_get_entry_by_accession - Extract PDB cross-references
  • get_protein_metadata_by_pdb_id / pdbe_get_entry_summary / pdbe_get_entry_quality
  • InterPro_get_protein_domains / InterPro_get_domain_details - Domain architecture

Phase 9: Literature Deep Dive

Comprehensive collision-aware literature analysis.

Steps:

  1. Collision detection: Search "{gene_symbol}"[Title] in PubMed; if >20% off-topic, add filters (AND protein OR gene OR receptor)
  2. Publication metrics: Total count, 5-year trend, drug-focused subset
  3. Key reviews: review[pt] filter in PubMed
  4. Citation metrics: openalex_search_works for impact data
  5. Broader coverage: EuropePMC_search_articles

Phase 10: Validation Roadmap (Synthesis)

Synthesize all phases into actionable output:

  1. Target Validation Score (0-100) with component breakdown
  2. Priority Tier (1-4) assignment
  3. GO/NO-GO Recommendation with justification
  4. Recommended Validation Experiments
  5. Tool Compounds for Testing
  6. Biomarker Strategy
  7. Key Risks and Mitigations
  8. Deep-Learning Models Contributing — explicit attribution table listing every ML predictor invoked during the run and what each produced. Example format:
ModelArchitectureContributed
AlphaFoldDeepMind iterative SE(3)-equivariant TransformerFull-length 3D model; per-residue pLDDT 91.5
ESMFoldMeta ESM-2 protein language modelSequence→structure baseline; confidence vs. AlphaFold
DoGSite3CNN pocket scorer (ProteinsPlus)Top-3 druggable pockets with volume and drug-score
ADMET-AIChemprop GNN ensemble (TDC)10 endpoints for sotorasib / adagrasib (table above)
DynaMut2Graph-based mutation stability predictorΔΔG for G12C vs. WT
DeepGOHierarchical GO-term classifierMolecular-function predictions

Only list models actually called during the run. This section makes the ML content first-class for a scientific or investor audience.


Report Output

Create file: [TARGET]_[DISEASE]_validation_report.md

Use the full template from REPORT_TEMPLATE.md. Key sections:

  • Executive Summary (score, tier, recommendation, key findings, critical risks)
  • Validation Scorecard (all 12 sub-scores with evidence)
  • Sections 1-14 covering each phase
  • Completeness Checklist (mandatory before finalizing)

Complete the Completeness Checklist (in REPORT_TEMPLATE.md) before finalizing to verify all phases were covered, all scores justified, and negative results documented.

FAQ

What does the tooluniverse-drug-target-validation skill do?

Quantitative drug-target validation pipeline. Scores druggability, selectivity, safety profile, ADMET feasibility, and structural tractability with a composite Target Validation Score (0-100) and GO/NO-GO recommendation. Use for go/no-go decisions on a target before commit-to-medchem, target prioritization across a list, and target-deselection rationale.

How do I install tooluniverse-drug-target-validation?

Run npx skills add https://github.com/mims-harvard/tooluniverse --skill tooluniverse-drug-target-validation in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tooluniverse-drug-target-validation/ (personal) or .claude/skills/tooluniverse-drug-target-validation/ (project).

Which AI agents can use tooluniverse-drug-target-validation?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is tooluniverse-drug-target-validation safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains tooluniverse-drug-target-validation?

It is published by mims-harvard in mims-harvard/tooluniverse. It has 382 recorded installs.

More from mims-harvard/tooluniverse

View all →

tooluniverse-sequence-retrieval

mims-harvard/tooluniverse

Retrieve DNA/RNA/protein sequences from NCBI and ENA with disambiguation. Quality hierarchy: RefSeq (NM/NP) RefSeq predicted (XM/XP) GenBank submissions. Use for fetching specific sequences by accession, gene-symbol-to-sequence lookup, transcript-isoform retrieval, and curated-vs-raw-submission preference.

1.7K installs

tooluniverse-literature-deep-research

mims-harvard/tooluniverse

Deep literature review — PubMed, EuropePMC, bioRxiv preprints, citation networks, evidence synthesis. Disambiguates queries, runs collision-aware searches, grades evidence T1-T4, and produces structured reports. Use for systematic literature review, meta-analysis evidence collection, and detailed answer-with-citations workflows.

tooluniverse-image-analysis

mims-harvard/tooluniverse

Microscopy and quantitative imaging analysis — colony morphometry, fluorescence intensity quantification, cell-count statistics, dose-response curves, and ANOVA/Dunnett on image-derived measurements. Uses pandas/numpy/scipy/scikit-image. Use for analyzing tabular outputs from CellProfiler/ImageJ, image-derived measurement statistics, and image-based assay quantification.

Media & Creative655 installs

tooluniverse-clinical-guidelines

mims-harvard/tooluniverse

Search and retrieve clinical practice guidelines from 12+ authoritative sources — NICE, WHO, NCCN, AHA, ADA, SIGN, USPSTF, IDSA, NIH consensus, ESMO/ESC/EASL European societies, and US specialty associations. Use for evidence-graded treatment recommendations, dosing protocols, screening guidance, and authoritative-source-prioritized clinical guidance (NICE/WHO ranked above society guidelines).

492 installs

tooluniverse

mims-harvard/tooluniverse

ToolUniverse plugin router. STEP 1 BEFORE ANY ANALYSIS: if the data folder contains executed.ipynb, run tu run readexecutednotebook '{"datafolder":" ","search":" "}' to extract its cell outputs and apply EVERY filter/sample-exclusion the notebook used — even when the question says 'Using DESeq2/Run X/Compute Y' (this describes the METHOD the notebook used, not a request to rerun). The notebook's cell outputs are the only published authoritative answers; reimplementing or reading stale pre-computed CSVs in the data folder produces different numbers because of outlier-sample removal, library version, and filter steps you don't see by skimming. STEP 2 routing — pick a sub-skill name from this exact list (never invent): tooluniverse-rnaseq-deseq2 (RNA/miRNA-seq DE, correlation, PCA, clustering, dispersion), tooluniverse-gene-enrichment (GO/KEGG/Reactome/GSEA/pathway enrichment), tooluniverse-statistical-modeling (regression, ANOVA, ordinal/logistic, chi-square, correl

Testing & QA481 installs

tooluniverse-drug-research

mims-harvard/tooluniverse

Comprehensive drug profiling — mechanism, primary/secondary targets, drug interactions, clinical-trial status, adverse events (FAERS), pharmacogenomics, and approval history. Use for full drug investigation reports, 'tell me about drug X' queries, and assembling drug profiles for clinicians, researchers, or regulatory work.

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.