Tooluniverse Precision Oncology
Cancer treatment recommendations from molecular profile (mutations + cancer type + biomarkers) — FDA-approved + investigational therapies, resistance mechanisms, matching clinical trials, prognosis. Uses CIViC, ClinVar, OpenTargets, ClinicalTrials.gov. Use for tumor-board treatment recommendations, evidence-tiered actionability assessment, and FDA-precedent-driven therapy selection.
- Skill ID
- mims-harvard/tooluniverse/tooluniverse-precision-oncology
- Publisher
- mims-harvard
- Repository
- tooluniverse
- Installs
- 0
- Files
- 8
- Synced
- Sep 23, 2026
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
mims-harvard/tooluniverse/tooluniverse-precision-oncologyInstalls these files- API_USAGE_PATTERNS.md
- CHECKLIST.md
- EXAMPLES.md
- REPORT_TEMPLATE.md
- SKILL.md
- TOOLS_REFERENCE.md
- TREATMENT_ALGORITHMS.md
- scripts/gdsc_drug_response.py
What this skill tells the agent
Precision Oncology Treatment Advisor
Provide actionable treatment recommendations for cancer patients based on their molecular profile using CIViC, ClinVar, OpenTargets, ClinicalTrials.gov, and structure-based analysis.
Domain Reasoning
Treatment selection follows a strict evidence hierarchy: FDA-approved for this specific mutation in this cancer type ranks highest, followed by approval for this mutation in any cancer (tumor-agnostic), then active clinical trials, and finally off-label use. Skipping this hierarchy to recommend off-label therapies when an approved option exists is a clinical error. Always check current NCCN guidelines and recent literature, as approvals change rapidly — a drug that was investigational last year may now be first-line.
When looking up treatment for a specific mutation, search CIViC and OncoKB FIRST, not PubMed. These databases have curated evidence levels. PubMed is for when curated databases don't have the answer.
Treatment Selection Reasoning
Biomarker-to-drug logic — When a biomarker is identified, the first-line targeted therapy follows established mappings. Always verify current approval status via OncoKB/CIViC, but use this as a starting framework:
- NSCLC: EGFR exon 19 del / L858R → osimertinib (1L); ALK fusion → alectinib/lorlatinib; ROS1 fusion → crizotinib/entrectinib; KRAS G12C → sotorasib/adagrasib; MET exon 14 skip → capmatinib/tepotinib; RET fusion → selpercatinib; BRAF V600E → dabrafenib+trametinib; NTRK fusion → larotrectinib/entrectinib (tumor-agnostic)
- Breast: HER2+ → trastuzumab+pertuzumab (1L), T-DXd (2L); HR+/HER2- → CDK4/6i (palbociclib/ribociclib) + AI; BRCA1/2 mut → olaparib/talazoparib; PIK3CA mut → alpelisib+fulvestrant
- Colorectal: BRAF V600E → encorafenib+cetuximab; MSI-H/dMMR → pembrolizumab (tumor-agnostic); KRAS/NRAS wild-type → cetuximab/panitumumab (anti-EGFR)
- Melanoma: BRAF V600E/K → dabrafenib+trametinib or encorafenib+binimetinib; wild-type → immunotherapy (nivolumab+ipilimumab)
- Tumor-agnostic: MSI-H/dMMR → pembrolizumab; NTRK fusion → larotrectinib; TMB-H (>=10 mut/Mb) → pembrolizumab; RET fusion → selpercatinib
Resistance mechanism reasoning — When a patient progresses on targeted therapy, distinguish primary resistance (never responded — check if the mutation was truly the driver, or if co-mutations like TP53/RB1 abrogate response) from acquired resistance (responded then progressed — on-target mutations or bypass activation). Common patterns:
- EGFR TKIs: 1st/2nd-gen resistance → T790M (50-60%); osimertinib resistance → C797S (10-25%), MET amp (15-20%), HER2 amp, histologic transformation (SCLC ~5%)
- ALK TKIs: crizotinib resistance → ALK secondary mutations (L1196M, G1269A); alectinib resistance → G1202R (solvent front); lorlatinib resistance → compound mutations
- BRAF inhibitors: MAPK reactivation (MEK mutations, BRAF amplification, NRAS mutations), PI3K/AKT bypass
- Anti-HER2: HER2 truncation (p95HER2), PIK3CA activation, HER3 upregulation
- Immunotherapy (anti-PD1): B2M loss (MHC-I loss), JAK1/2 loss-of-function (IFN-gamma signaling escape), WNT/beta-catenin activation (T-cell exclusion)
For resistance workup: query civic_search_evidence_items with the drug name + "resistance", then PubMed_search_articles for recent mechanisms.
LOOK UP DON'T GUESS
- FDA approval status for a mutation-drug pair: query
OncoKB_annotate_variantandcivic_search_variants; never assume approval status from memory. - Active clinical trials: search
search_clinical_trialswith the specific condition and mutation; do not cite trials from memory. - Resistance mechanisms for specific drugs: query
civic_search_evidence_itemsandPubMed_search_articles; do not assume resistance pathways. - Variant frequency in TCGA: retrieve from
GDC_get_mutation_frequencyorcBioPortal_get_mutations; do not estimate prevalence.
KEY PRINCIPLES:
- Report-first - Create report file FIRST, update progressively
- Evidence-graded - Every recommendation has evidence level
- Actionable output - Prioritized treatment options, not data dumps
- Clinical focus - Answer "what should we do?" not "what exists?"
- English-first queries - Always use English terms in tool calls (mutations, drug names, cancer types), even if the user writes in another language. Only try original-language terms as a fallback. Respond in the user's language
When to Use
- "Patient has [cancer] with [mutation] - what treatments?"
- "What are options for EGFR-mutant lung cancer?"
- "Patient failed [drug], what's next?"
- "Clinical trials for KRAS G12C?"
- "Why isn't [drug] working anymore?"
Phase 0: Tool Verification
| Tool | WRONG | CORRECT |
|---|---|---|
civic_get_variant | variant_name | variant_id (numeric, e.g., 4170) |
civic_get_evidence_item | variant_id | id (numeric) |
OpenTargets_* | ensemblID | ensemblId (camelCase) |
search_clinical_trials | disease | condition |
Workflow Overview
Input: Cancer type + Molecular profile (mutations, fusions, amplifications)
Phase 1: Profile Validation -> Resolve gene IDs (Ensembl, UniProt, ChEMBL)
Phase 2: Variant Interpretation -> CIViC, ClinVar, COSMIC, GDC/TCGA, DepMap, OncoKB, cBioPortal, HPA
Phase 2.5: Tumor Expression -> CELLxGENE cell-type expression, ChIPAtlas regulatory context
Phase 3: Treatment Options -> OpenTargets + DailyMed (approved), ChEMBL (off-label)
Phase 3.5: Pathway & Network -> KEGG/Reactome pathways, IntAct interactions
Phase 4: Resistance Analysis -> CIViC + PubMed + NvidiaNIM structure analysis
Phase 5: Clinical Trials -> ClinicalTrials.gov search + eligibility
Phase 5.5: Literature -> PubMed, BioRxiv/MedRxiv preprints, OpenAlex citations
Phase 6: Report Synthesis -> Executive summary + prioritized recommendationsKey Tools by Phase
Phase 1: Profile Validation
MyGene_query_genes- Resolve gene to Ensembl IDUniProt_search- Get UniProt accessionChEMBL_search_targets- Get ChEMBL target ID
Phase 2: Variant Interpretation
civic_search_variants/civic_get_variant- CIViC evidenceCOSMIC_get_mutations_by_gene/COSMIC_search_mutations- Somatic mutationsGDC_get_mutation_frequency/GDC_get_ssm_by_gene- TCGA patient dataGDC_get_gene_expression/GDC_get_cnv_data- Expression and CNVGDC_get_survival- Kaplan-Meier survival data by project and optional gene mutation filterGDC_get_clinical_data- TCGA clinical metadata (stage, vital status, treatment, demographics)Progenetix_cnv_search- Copy number variation biosamples by genomic region and cancer type (NCIt code)DepMap_get_gene_dependencies/PharmacoDB_get_experiments- Target essentialityOncoKB_annotate_variant/OncoKB_get_gene_info- ActionabilitycBioPortal_get_mutations/cBioPortal_get_cancer_studies- Cross-study dataHPA_search_genes_by_query/HPA_get_comparative_expression_by_gene_and_cellline- Expression
Phase 2.5: Tumor Expression
CELLxGENE_get_expression_data/CELLxGENE_get_cell_metadata- Cell-type expression
Phase 3: Treatment Options
OpenTargets_get_associated_drugs_by_target_ensemblID- Approved drugs (param:ensemblId, camelCase)DGIdb_get_drug_gene_interactions- Drug-gene interactions (param:genesas array, e.g.,["EGFR"]). Comprehensive; covers inhibitors, antibodies, and investigational agents.DailyMed_search_spls- FDA label detailsChEMBL_get_drug_mechanisms- Drug mechanism
Phase 3.5: Pathway & Network
kegg_find_genes/kegg_get_gene_info- KEGG pathwaysreactome_disease_target_score- Reactome disease relevanceintact_get_interaction_network- Protein interactions
Phase 4: Resistance Analysis
More from mims-harvard
Use this skill in a project
Open any RiverX project, search the Skills panel for mims-harvard/tooluniverse/tooluniverse-precision-oncology, and install it in one click.
