OpenClaw-Medical-Skills chip-clonal-hematopoiesis-agent

<!--

install
source · Clone the upstream repo
git clone https://github.com/FreedomIntelligence/OpenClaw-Medical-Skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/FreedomIntelligence/OpenClaw-Medical-Skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/chip-clonal-hematopoiesis-agent" ~/.claude/skills/freedomintelligence-openclaw-medical-skills-chip-clonal-hematopoiesis-agent && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/FreedomIntelligence/OpenClaw-Medical-Skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/chip-clonal-hematopoiesis-agent" ~/.openclaw/skills/freedomintelligence-openclaw-medical-skills-chip-clonal-hematopoiesis-agent && rm -rf "$T"
manifest: skills/chip-clonal-hematopoiesis-agent/SKILL.md
source content
<!-- # COPYRIGHT NOTICE # This file is part of the "Universal Biomedical Skills" project. # Copyright (c) 2026 MD BABU MIA, PhD <md.babu.mia@mssm.edu> # All Rights Reserved. # # This code is proprietary and confidential. # Unauthorized copying of this file, via any medium is strictly prohibited. # # Provenance: Authenticated by MD BABU MIA -->

name: 'chip-clonal-hematopoiesis-agent' description: 'AI-powered clonal hematopoiesis of indeterminate potential (CHIP) detection, risk stratification, and cardiovascular/malignancy risk prediction using genomic and clinical data.' measurable_outcome: Execute skill workflow successfully with valid output within 15 minutes. allowed-tools:

  • read_file
  • run_shell_command

CHIP Clonal Hematopoiesis Agent

The CHIP Clonal Hematopoiesis Agent provides comprehensive detection and risk stratification of clonal hematopoiesis of indeterminate potential (CHIP). It identifies clonal mutations in blood cells, assesses risk of progression to myeloid malignancy, and predicts cardiovascular disease risk, integrating with the CHIC machine learning framework for CBC-based screening.

When to Use This Skill

  • When detecting CHIP mutations from blood sequencing data.
  • For stratifying risk of progression to MDS/AML.
  • To assess CHIP-associated cardiovascular disease risk.
  • When filtering CHIP variants from tumor liquid biopsy.
  • For population-level CHIP screening and research.

Core Capabilities

  1. CHIP Detection: Identify clonal mutations with VAF >2%.

  2. Risk Stratification: Predict myeloid malignancy progression risk.

  3. CVD Risk Assessment: Estimate cardiovascular disease risk.

  4. CCUS Classification: Distinguish CHIP from CCUS/MDS.

  5. Clone Size Tracking: Monitor clonal evolution over time.

  6. ctDNA Filtering: Remove CHIP from tumor ctDNA analysis.

CHIP-Associated Genes

GeneFrequencyMalignancy RiskCVD Risk
DNMT3A50%ModerateElevated
TET220%ModerateElevated (inflammatory)
ASXL110%HighModerate
JAK25%High (MPN)Elevated (thrombosis)
TP535%Very HighLow
SF3B13%Moderate-HighLow
SRSF23%HighLow
PPM1D2%ModerateTherapy-related
CBL2%HighModerate
IDH1/22%Moderate-HighLow

Risk Categories

CategoryCriteriaAnnual AML Risk
Low-Risk CHIPDNMT3A/TET2, VAF <10%<0.5%
Intermediate CHIPDNMT3A/TET2, VAF >10%0.5-1%
High-Risk CHIPASXL1, TP53, splicing1-3%
CCUSCHIP + cytopenia3-10%
Pre-MDSHigh-risk mutations + dysplasia>10%

Workflow

  1. Input: Blood sequencing (WES/panel), CBC data, clinical history.

  2. Variant Detection: Call somatic variants with VAF filtering.

  3. CHIP Classification: Identify CHIP-defining mutations.

  4. Risk Scoring: Calculate malignancy and CVD risk scores.

  5. Longitudinal Analysis: Track clone dynamics if serial samples.

  6. Clinical Integration: Generate management recommendations.

  7. Output: CHIP status, risk scores, monitoring plan.

Example Usage

User: "Analyze this patient's blood sequencing for CHIP and calculate their risk of progression and cardiovascular events."

Agent Action:

python3 Skills/Hematology/CHIP_Clonal_Hematopoiesis_Agent/chip_analysis.py \
    --variants blood_variants.vcf \
    --cbc_data patient_cbc.csv \
    --clinical_data patient_demographics.json \
    --vaf_threshold 0.02 \
    --age 65 \
    --calculate_cvd_risk true \
    --output chip_analysis/

CHRS Risk Score (Clonal Hematopoiesis Risk Score)

FactorPointsNotes
High-risk mutation+2SRSF2, SF3B1, ZRSR2, IDH1/2, FLT3, RUNX1, JAK2
Single DNMT3A mutation-1Lower risk
≥2 mutations+1Increased burden
VAF ≥20%+1Large clone
CCUS (vs CHIP)+2Cytopenia present
RDW ≥15%+1Blood count abnormality
MCV ≥100 fL+1Macrocytosis
Age ≥65+1Age-related risk

Output Components

OutputDescriptionFormat
CHIP StatusPresent/Absent, genes involved.json
Mutation DetailsVAF, gene, protein change.csv
Malignancy Risk5-year AML/MDS probability.json
CVD RiskCardiovascular risk score.json
CHRS ScoreClonal hematopoiesis risk score.json
RecommendationsClinical management.md
Monitoring PlanFollow-up schedule.json

AI/ML Components

CHIC Framework:

  • Machine learning from CBC indices
  • Identifies high-risk CHIP without sequencing
  • Reduces "number needed to sequence"

Risk Prediction:

  • Cox proportional hazards for progression
  • Random survival forests
  • Deep learning survival models

CVD Risk Integration:

  • Framingham score adjustment
  • CHIP-specific hazard ratios
  • Inflammatory biomarker integration

Cardiovascular Risk

CHIP GeneCVD Hazard RatioMechanism
TET21.9IL-6, inflammasome
DNMT3A1.7Inflammation
JAK22.6Thrombosis, platelet activation
ASXL12.0Inflammation
Overall CHIP1.5-2.0Multiple pathways

Clinical Management Guidelines

CHIP CategoryMonitoringIntervention
Low-riskAnnual CBCNone
IntermediateCBC q6 monthsCVD optimization
High-riskCBC q3-6 months, consider BMBHematology referral
CCUSBMB, q3 month CBCActive surveillance

Prerequisites

  • Python 3.10+
  • Variant callers (Mutect2, VarScan)
  • ANNOVAR/VEP for annotation
  • lifelines, scikit-survival
  • CHIC model weights

Related Skills

  • MPN_Progression_Monitor_Agent - MPN monitoring
  • CHIC_ML_Framework_Agent - CBC-based screening
  • MDS_Classification_Agent - MDS diagnosis
  • Bone_Marrow_AI_Agent - Morphology analysis

CHIP vs ctDNA Filtering

FeatureCHIPTumor ctDNA
VAF StabilityStable over timeChanges with disease
GenesDNMT3A, TET2, ASXL1Tumor drivers
Age AssociationIncreases with ageIndependent
Multiple SamplesConsistentVariable

Special Considerations

  1. VAF Threshold: Use 2% for CHIP definition
  2. Germline Filtering: Exclude germline variants
  3. Age Context: Prevalence increases with age
  4. Therapy History: Consider treatment-related clones
  5. Serial Monitoring: Track clone dynamics

Population Prevalence

Age GroupCHIP PrevalenceHigh-Risk CHIP
40-49~2%<0.5%
50-59~5%~1%
60-69~10%~2%
70-79~15%~4%
80+~20%~5%

Therapeutic Implications

ScenarioCHIP ImpactConsideration
CAR-T TherapyMay affect outcomesMonitor clones
Stem Cell TransplantDonor CHIP mattersScreen donors
ChemotherapyMay expand clonesMonitor post-treatment
CardiovascularIncreased riskAggressive prevention

Author

AI Group - Biomedical AI Platform

<!-- AUTHOR_SIGNATURE: 9a7f3c2e-MD-BABU-MIA-2026-MSSM-SECURE -->