tooluniverse-precision-medicine-stratification
Patient stratification for precision medicine — integrate genomic, clinical, and therapeutic data to split patients into responder/non-responder groups, risk tiers, or treatment-decision groups. Use for stratification-by-biomarker, treatment-selection logic, and personalized therapeutic strategy rep
By mims-harvard · 365 installs
npx skills add mims-harvard/tooluniverse --skill tooluniverse-precision-medicine-stratification
Source repository · Upstream listing
Precision Medicine Patient Stratification
Transform patient genomic and clinical profiles into actionable risk stratification, treatment recommendations, and personalized therapeutic strategies.
Reasoning Before Searching
Stratification means splitting patients into groups that respond differently to a treatment or have different prognoses. Ask these questions before running any tools:
1. What molecular feature predicts response? Candidates: somatic mutation (e.g., EGFR L858R), germline variant (e.g., BRCA1 LoF), expression level (e.g., HER2 overexpression), germline pharmacogenomic variant (e.g., CYP2C19 PM), or composite biomarker (e.g., TMB H + MSI H).
2. Is the predictive feature actionable? Knowing it must change treatment — either the drug choice, dose, or monitoring plan. A variant with prognostic value but no therapeutic consequence is not a stratification biomarker.
3. What is the evidence level for the stratifier? FDA approved companion diagnostic (T1) vs. exploratory (T4) changes how much weight to place on the finding.
Route to the correct Phase 3 path BEFORE running Phase 2 tools — cancer, metabolic, CVD, rare disease, and autoimmune pipelines require different stratifiers.
LOOK UP DON'T GUESS : Never assume a variant is pathogenic, never assume a gene is relevant to a disease, never assign metabolizer status without PharmGKB or CPIC evidence.
KEY PRINCIPLES :
1. Report first Create report file FIRST, then populate progressively
2. Disease specific logic Cancer vs metabolic vs rare disease pipelines diverge at Phase 3
3. Multi level integration Germline + somatic + expression + clinical data layers
4. Evidence graded Every finding has an evidence tier (T1 T4)
5. Quantitative output Precision Medicine Risk Score (0 100)
6. Source referenced Every statement cites the tool/database source
7. English first queries Always use English terms in tool calls
Reference files (same directory):
TOOLS REFERENCE.md Tool parameters, response formats, phase by phase tool lists
SCORING REFERENCE.md Scoring matrices, risk tiers, pathogenicity tables, PGx tables
REPORT TEMPLATE.md Output report template, treatment algorithms, completeness requirements
EXAMPLES.md Six worked examples (cancer, metabolic, NSCLC, CVD, rare, neuro)
QUICK START.md Sample prompts and output summary
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
Apply when user asks about patient risk stratification, treatment selection, prognosis prediction, or personalized therapeutic strategy for any disease with genomic/clinical data.
NOT for (use other skills instead):
Single variant interpretation tooluniverse variant interpretation
Immunotherapy specific prediction tooluniverse immunotherapy response prediction
Drug safety profiling only tooluniverse adverse event detection
Target validation tooluniverse drug target validation
Clinical trial search only tooluniverse clinical trial matching
Drug drug interaction only tooluniverse drug drug interaction
PRS calculation only tooluniverse polygenic risk score
Input Parsing
Required
Disease/condition : Free text disease name
At least one of : Germline variants, somatic mutations, gene list, or clinical biomarkers
Optional (improves stratification)
Age, sex, ethnicity, disease stage, comorbidities, prior treatments, family history
Current medications (for DDI and PGx), stratification goal
Disease Type Classification
Classify into one category (determines Phase 3 routing):
Category Examples
CANCER Breast, lung, colorectal, melanoma
METABOLIC Type 2 diabetes, obesity, NAFLD
CARDIOVASCULAR CAD, heart failure, AF
NEUROLOGICAL Alzheimer, Parkinson, epilepsy
RARE/MONOGENIC Marfan, CF, sickle cell, Huntington
AUTOIMMUNE RA, lupus, MS, Crohn's
Critical Tool Parameter Notes
See TOOLS REFERENCE.md for full details. Key gotchas:
MyGene query genes : param is query (NOT q )
EnsemblVEP annotate rsid : param is variant id (NOT rsid )
ensembl lookup gene : REQUIRES species='homo sapiens'
DrugBank tools : ALL require 4 params: query , case sensitive , exact match , limit
cBioPortal get mutations : gene list is a STRING (space separated), not array
PubMed search articles : Returns a plain list of dicts, NOT {articles: [...]}
fda pharmacogenomic biomarkers : Use limit=1000 for all results
gnomAD : May return "Service overloaded" skip gracefully
OpenTargets : Always nested {data: {entity: {field: ...}}} structure
Workflow Overview
Phase 1: Disease Disambiguation & Profile Standardization
1. Resolve disease to EFO ID using OpenTargets get disease id description by name
2. Classify disease type (CANCER/METABOLIC/CVD/NEUROLOGICAL/RARE/AUTOIMMUNE)
3. Parse genomic data into structured format (gene, variant, type)
4. Resolve gene IDs using MyGene query genes to get Ensembl/Entrez IDs
Phase 2: Genetic Risk Assessment
1. Germline variant pathogenicity : ClinVar search variants , EnsemblVEP annotate rsid / hgvs
2. Gene disease association : OpenTargets target disease evidence
3. GWAS polygenic risk : gwas get associations for trait , OpenTargets search gwas studies by disease
4. Population frequency : gnomad get variant
5. Gene constraint : gnomad get gene constraints (pLI, LOEUF scores)
Scoring: See SCORING REFERENCE.md for genetic risk score component (0 35 points).
Phase 3: Disease Specific Molecular Stratification
CANCER PATH
1. Molecular subtyping : cBioPortal get mutations , HPA get cancer prognostics by gene
2. TMB/MSI/HRD : fda pharmacogenomic biomarkers for FDA cutoffs
3. Prognostic stratification : Combine stage + molecular features
METABOLIC PATH
1. Genetic risk integration : GWAS search associations by gene , OpenTargets target disease evidence
2. Complication risk : Based on HbA1c, duration, existing complications
CVD PATH
1. FH gene check : ClinVar search variants for LDLR, APOB, PCSK9
2. Statin PGx : PharmGKB get clinical annotations for SLCO1B1
RARE DISEASE PATH
1. Causal variant identification : ClinVar search variants
2. Genotype phenotype : UniProt get disease variants by accession
Scoring: See SCORING REFERENCE.md for disease specific tables.
Phase 4: Pharmacogenomic Profiling
1. Drug metabolizing enzymes : PharmGKB get clinical annotations , PharmGKB get dosing guidelines
2. FDA PGx biomarkers : fda pharmacogenomic biomarkers (use limit=1000 )
3. Treatment specific PGx : PharmGKB get drug details
Scoring: See SCORING REFERENCE.md for PGx risk score (0 10 points).
Phase 5: Comorbidity & Drug Interaction Risk
1. Disease overlap : OpenTargets get associated targets by disease efoId
2. DDI check : drugbank get drug interactions by drug name or id , FDA get drug interactions by drug name
3. PGx amplified DDI : If PM genotype + CYP inhibitor, flag compounded risk
Phase 6: Molecular Pathway Analysis
1. Pathway enrichment : enrichr gene enrichment analysis (libs: KEGG 2021 Human , Reactome 2022 , GO Biological Process 2023 )
2. Reactome mapping : ReactomeAnalysis pathway enrichment , Reactome map uniprot to pathways
3. Network analysis : STRING get interaction partners , STRING functional enrichment
4. Druggable targets : OpenTargets get target tractability by ensemblID
Phase 7: Clinical Evidence & Guidelines
1. Guidelines search : PubMed Guidelines Search (fallback: PubMed search articles )
2. FDA approved therapies : OpenTargets get associated drugs by disease efoId , FDA get indications by drug name
3. Biomarker drug evidence : civic search evidence items , civic search assertions
Phase 8: Clinical Trial Matching
1. Biomarker driven trials : search clinical trials with condition + intervention
2. Precision medicine trials : search clinical trials for basket/umbrella trials
Phase 9: Integrated Scoring & Recommendations
Score Components (total 0 100)
Genetic Risk (0 35): Pathogenicity + gene disease association + PRS
Clinical Risk (0 30): Stage/biomarkers/comorbidities
Molecular Features (0 25): Driver mutations, subtypes, actionable targets
Pharmacogenomic Risk (0 10): Metabolizer status, HLA alleles
Risk Tiers
Score Tier Management
75 100 VERY HIGH Intensive treatment, subspecialty referral, clinical trial
50 74 HIGH Aggressive treatment, close monitoring
25 49 INTERMEDIATE Standard guideline based care, PGx guided dosing
0 24 LOW Surveillance, prevention, risk factor modification
Output
Generate report per REPORT TEMPLATE.md . See SCORING REFERENCE.md for detailed scoring matrices.
Common Use Patterns
See EXAMPLES.md for six detailed worked examples:
1. Cancer + actionable mutation : Breast cancer, BRCA1, ER+/HER2 Score ~55 65 (HIGH)
2. Metabolic + PGx concern : T2D, CYP2C19 PM on clopidogrel Score ~55 65 (HIGH)
3. NSCLC comprehensive : EGFR L858R, TMB 25, PD L1 80% Score ~75 85 (VERY HIGH)
4. CVD risk : LDL 190, SLCO1B1 5, family hx MI Score ~50 60 (HIGH)
5. Rare disease : Marfan, FBN1 variant Score ~55 65 (HIGH)
6. Neurological risk : APOE e4/e4, family hx Alzheimer's Score ~60 72 (HIGH)