← Back to Skills Marketplace
cryptoreumd

ADA-Predictor: Anti-Drug Antibody Risk Stratification

by CryptoReuMD · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
159
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ada-predictor
Description
Predicts the risk of anti-drug antibody development against TNF inhibitors using clinical and genomic data, providing a risk score, tier, and tailored manage...
README (SKILL.md)

ADA-Predictor: Anti-Drug Antibody Risk Stratification for Biologic Therapy in Rheumatic Diseases

Description

Predicts the probability of developing anti-drug antibodies (ADA) against TNF inhibitors (adalimumab, infliximab, etanercept) and other biologics using patient-level clinical, pharmacogenomic, and treatment variables. Outputs a risk score (0–100), risk tier, and clinical recommendations including concomitant methotrexate optimization and therapeutic drug monitoring (TDM) intervals.

Authors

  • Erick Adrián Zamora Tehozol (Board-Certified Rheumatologist, IMSS Mérida)
  • DNAI (Root Ethical AI Agent, DeSci Ecosystem)
  • Claw 🦞

Affiliations

RheumaAI · Frutero Club · DeSci

Clinical Problem

Anti-drug antibodies cause secondary loss of efficacy in 10–50% of patients on biologic DMARDs. ADA development leads to treatment failure, infusion reactions, and costly drug switching. Early risk stratification enables proactive TDM scheduling, methotrexate co-prescription, and informed biologic selection — saving time, money, and joint damage.

Model

Risk Factors and Weights

The ADA risk score is a weighted logistic composite:

$$ ext{logit}(p) = \beta_0 + \sum_{i=1}^{k} \beta_i x_i$$

Factor Variable β Weight Reference
Biologic type Monoclonal Ab vs fusion protein +1.8 (mAb) Bartelds 2011, Ann Rheum Dis
Concomitant MTX Yes/No, dose −1.5 (if ≥10mg/wk) Krieckaert 2012, Arthritis Rheum
HLA-DQA1*05 carrier Yes/No +1.2 Sazonovs 2020, Nat Med
Prior biologic failure Count (0–3+) +0.6 per failure Jamnitski 2011
Baseline CRP mg/L +0.02 per unit Vincent 2013
Disease duration Years +0.03 per year
Smoking Yes/No +0.4
BMI kg/m² +0.05 if >30
Intercept β₀ −2.5

$$p( ext{ADA}) = \frac{1}{1 + e^{- ext{logit}(p)}}$$

$$ ext{Risk Score} = \lfloor p imes 100 \rfloor$$

Risk Tiers

  • Low (0–25): Standard TDM at 6 months
  • Moderate (26–50): TDM at 3 months, ensure MTX ≥10mg/wk
  • High (51–75): TDM at 6 weeks, maximize MTX, consider drug levels before dose escalation
  • Very High (76–100): Consider alternative biologic class (IL-6, JAKi, CD20), proactive TDM at 4 weeks

Dependencies

numpy>=1.24

Usage

python3 ada_predictor.py

Code

#!/usr/bin/env python3
"""
ADA-Predictor: Anti-Drug Antibody Risk Stratification for Biologic Therapy
Authors: Erick Adrián Zamora Tehozol, DNAI, Claw 🦞
License: MIT | RheumaAI · Frutero Club · DeSci
"""

import json
import math
import sys
from dataclasses import dataclass, field
from typing import Optional

import numpy as np


@dataclass
class PatientProfile:
    """Patient clinical profile for ADA risk assessment."""
    biologic: str  # adalimumab, infliximab, etanercept, golimumab, certolizumab
    is_monoclonal_ab: bool = True  # True for adalimumab/infliximab/golimumab; False for etanercept/certolizumab
    concomitant_mtx: bool = False
    mtx_dose_mg_wk: float = 0.0
    hla_dqa1_05: Optional[bool] = None  # None = unknown
    prior_biologic_failures: int = 0
    baseline_crp_mg_l: float = 5.0
    disease_duration_years: float = 2.0
    smoking: bool = False
    bmi: float = 25.0

    def validate(self):
        assert self.biologic in {
            "adalimumab", "infliximab", "etanercept", "golimumab", "certolizumab"
        }, f"Unknown biologic: {self.biologic}"
        assert 0 \x3C= self.prior_biologic_failures \x3C= 10
        assert 0 \x3C= self.baseline_crp_mg_l \x3C= 500
        assert 0 \x3C= self.disease_duration_years \x3C= 80
        assert 10 \x3C= self.bmi \x3C= 80
        if self.concomitant_mtx:
            assert 0 \x3C self.mtx_dose_mg_wk \x3C= 30


# Classify biologic type
MONOCLONAL_ABS = {"adalimumab", "infliximab", "golimumab"}
FUSION_PROTEINS = {"etanercept", "certolizumab"}


def compute_ada_risk(patient: PatientProfile) -> dict:
    """Compute ADA risk score using weighted logistic model."""
    patient.validate()

    # Coefficients (literature-derived, see SKILL.md table)
    B0 = -2.5
    logit = B0

    # Biologic type
    if patient.biologic in MONOCLONAL_ABS:
        logit += 1.8

    # Concomitant MTX
    if patient.concomitant_mtx and patient.mtx_dose_mg_wk >= 10:
        logit -= 1.5
    elif patient.concomitant_mtx and patient.mtx_dose_mg_wk > 0:
        logit -= 0.7  # suboptimal dose partial protection

    # HLA-DQA1*05
    if patient.hla_dqa1_05 is True:
        logit += 1.2
    elif patient.hla_dqa1_05 is None:
        logit += 0.4  # population prevalence ~30%, partial weight

    # Prior biologic failures
    logit += 0.6 * min(patient.prior_biologic_failures, 5)

    # Baseline CRP
    logit += 0.02 * patient.baseline_crp_mg_l

    # Disease duration
    logit += 0.03 * patient.disease_duration_years

    # Smoking
    if patient.smoking:
        logit += 0.4

    # BMI >30
    if patient.bmi > 30:
        logit += 0.05 * (patient.bmi - 30)

    # Sigmoid
    prob = 1.0 / (1.0 + math.exp(-logit))
    score = int(prob * 100)

    # Risk tier
    if score \x3C= 25:
        tier = "Low"
        recommendation = "Standard TDM at 6 months. Current regimen appropriate."
        tdm_weeks = 26
    elif score \x3C= 50:
        tier = "Moderate"
        recommendation = (
            "Schedule TDM at 3 months. "
            "Ensure methotrexate ≥10 mg/week if tolerated. "
            "Monitor trough drug levels."
        )
        tdm_weeks = 12
    elif score \x3C= 75:
        tier = "High"
        recommendation = (
            "Proactive TDM at 6 weeks. Maximize methotrexate to 15–25 mg/week (subcutaneous preferred). "
            "Obtain trough levels before any dose escalation. "
            "Consider switching to pegylated construct (certolizumab) if ADA confirmed."
        )
        tdm_weeks = 6
    else:
        tier = "Very High"
        recommendation = (
            "Consider alternative mechanism of action (IL-6R: tocilizumab/sarilumab, JAKi: tofacitinib/upadacitinib, "
            "CD20: rituximab). If TNFi required, use certolizumab (Fab', lower immunogenicity) "
            "with proactive TDM at 4 weeks. HLA-DQA1*05 testing if not done."
        )
        tdm_weeks = 4

    return {
        "biologic": patient.biologic,
        "ada_probability": round(prob, 4),
        "risk_score": score,
        "risk_tier": tier,
        "recommended_tdm_weeks": tdm_weeks,
        "recommendation": recommendation,
        "factors": {
            "monoclonal_ab": patient.biologic in MONOCLONAL_ABS,
            "mtx_protection": patient.concomitant_mtx and patient.mtx_dose_mg_wk >= 10,
            "hla_dqa1_05": patient.hla_dqa1_05,
            "prior_failures": patient.prior_biologic_failures,
            "crp": patient.baseline_crp_mg_l,
            "disease_years": patient.disease_duration_years,
            "smoking": patient.smoking,
            "bmi": patient.bmi,
        },
    }


def monte_carlo_sensitivity(patient: PatientProfile, n_sim: int = 5000) -> dict:
    """Monte Carlo sensitivity analysis varying uncertain parameters."""
    rng = np.random.default_rng(42)
    scores = []

    for _ in range(n_sim):
        p = PatientProfile(
            biologic=patient.biologic,
            is_monoclonal_ab=patient.is_monoclonal_ab,
            concomitant_mtx=patient.concomitant_mtx,
            mtx_dose_mg_wk=patient.mtx_dose_mg_wk,
            hla_dqa1_05=patient.hla_dqa1_05,
            prior_biologic_failures=patient.prior_biologic_failures,
            baseline_crp_mg_l=max(0, rng.normal(patient.baseline_crp_mg_l, patient.baseline_crp_mg_l * 0.2)),
            disease_duration_years=patient.disease_duration_years,
            smoking=patient.smoking,
            bmi=max(15, rng.normal(patient.bmi, 2)),
        )
        result = compute_ada_risk(p)
        scores.append(result["risk_score"])

    scores = np.array(scores)
    return {
        "mean_score": float(np.mean(scores)),
        "std_score": float(np.std(scores)),
        "ci_95": [float(np.percentile(scores, 2.5)), float(np.percentile(scores, 97.5))],
        "p_high_risk": float(np.mean(scores > 50)),
        "n_simulations": n_sim,
    }


def demo():
    """Run demo with 3 clinical scenarios."""
    print("=" * 70)
    print("ADA-Predictor: Anti-Drug Antibody Risk Stratification")
    print("RheumaAI · Frutero Club · DeSci")
    print("=" * 70)

    scenarios = [
        ("RA patient starting adalimumab, no MTX, HLA+ carrier", PatientProfile(
            biologic="adalimumab",
            concomitant_mtx=False,
            hla_dqa1_05=True,
            prior_biologic_failures=0,
            baseline_crp_mg_l=18.0,
            disease_duration_years=3.0,
            smoking=False,
            bmi=27.0,
        )),
        ("RA patient on infliximab + MTX 15mg/wk, HLA unknown", PatientProfile(
            biologic="infliximab",
            concomitant_mtx=True,
            mtx_dose_mg_wk=15.0,
            hla_dqa1_05=None,
            prior_biologic_failures=1,
            baseline_crp_mg_l=8.0,
            disease_duration_years=7.0,
            smoking=True,
            bmi=32.0,
        )),
        ("AS patient on etanercept + MTX 10mg/wk, HLA negative", PatientProfile(
            biologic="etanercept",
            concomitant_mtx=True,
            mtx_dose_mg_wk=10.0,
            hla_dqa1_05=False,
            prior_biologic_failures=0,
            baseline_crp_mg_l=4.0,
            disease_duration_years=1.5,
            smoking=False,
            bmi=24.0,
        )),
    ]

    for label, patient in scenarios:
        print(f"\
{'─' * 60}")
        print(f"Scenario: {label}")
        print(f"{'─' * 60}")
        result = compute_ada_risk(patient)
        print(f"  Biologic:     {result['biologic']}")
        print(f"  ADA Prob:     {result['ada_probability']:.1%}")
        print(f"  Risk Score:   {result['risk_score']}/100")
        print(f"  Risk Tier:    {result['risk_tier']}")
        print(f"  TDM at:       {result['recommended_tdm_weeks']} weeks")
        print(f"  Rec:          {result['recommendation']}")

        mc = monte_carlo_sensitivity(patient)
        print(f"  MC Mean±SD:   {mc['mean_score']:.1f} ± {mc['std_score']:.1f}")
        print(f"  MC 95% CI:    [{mc['ci_95'][0]:.0f}, {mc['ci_95'][1]:.0f}]")
        print(f"  P(High Risk): {mc['p_high_risk']:.1%}")

    print(f"\
{'=' * 70}")
    print("✅ All scenarios computed successfully.")


if __name__ == "__main__":
    demo()
Usage Guidance
This package appears coherent and self-contained: it runs a local risk model and prints results and sensitivity estimates. Before using in clinical workflows, (1) verify the model's external validity on your patient population and check the cited references, (2) run the script locally in a controlled environment (ensure numpy is installed), (3) avoid supplying identifiable patient data unless you have appropriate privacy safeguards, and (4) treat outputs as decision-support only—do not replace clinical judgment or regulatory requirements. If you need automated integrations (logging, EHR input/output), review and sandbox any added code for data handling and external network activity.
Capability Analysis
Type: OpenClaw Skill Name: ada-predictor Version: 1.0.0 The ADA-Predictor skill is a clinical decision support tool designed to calculate anti-drug antibody risk for biologic therapies. The implementation in `ada_predictor.py` and the instructions in `SKILL.md` are consistent, performing legitimate medical risk stratification using a logistic regression model and Monte Carlo simulations with `numpy`. No indicators of data exfiltration, malicious execution, or prompt injection were identified.
Capability Assessment
Purpose & Capability
Name/description match the provided code and SKILL.md: the script implements the logistic model and Monte Carlo sensitivity analysis described. The only declared dependency (numpy) is used in the code. No unrelated credentials, binaries, or configuration paths are requested.
Instruction Scope
SKILL.md instructs running the local Python script and documents the model and usage. The instructions do not request reading system files, environment variables, or sending data to external endpoints; runtime behavior is limited to local computation and printing.
Install Mechanism
There is no install spec (instruction-only + included script). The dependency list (numpy>=1.24) is proportionate and expected; no downloads, URL-based installs, or archive extraction are present.
Credentials
The skill requires no environment variables, credentials, or config paths. The code does not access os.environ or attempt to load external secrets—requested privileges are minimal and appropriate.
Persistence & Privilege
The skill is not always-included and does not modify other skills or system settings. It runs locally and does not persist credentials or alter agent configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ada-predictor
  3. After installation, invoke the skill by name or use /ada-predictor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial public release of ADA-Predictor, an anti-drug antibody (ADA) risk stratification tool for biologic therapy in rheumatic diseases. - Calculates probability of ADA development against TNF inhibitors and other biologics using clinical and pharmacogenomic variables. - Outputs a 0–100 risk score, risk tier (Low, Moderate, High, Very High), and tailored clinical recommendations (e.g., methotrexate optimization, TDM intervals). - Provides literature-based logistic regression model with interpretable factor weights. - Supports patient-level input validation and Monte Carlo sensitivity analysis. - Simple CLI usage: `python3 ada_predictor.py` - Developed by a rheumatologist and DeSci contributors.
Metadata
Slug ada-predictor
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is ADA-Predictor: Anti-Drug Antibody Risk Stratification?

Predicts the risk of anti-drug antibody development against TNF inhibitors using clinical and genomic data, providing a risk score, tier, and tailored manage... It is an AI Agent Skill for Claude Code / OpenClaw, with 159 downloads so far.

How do I install ADA-Predictor: Anti-Drug Antibody Risk Stratification?

Run "/install ada-predictor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ADA-Predictor: Anti-Drug Antibody Risk Stratification free?

Yes, ADA-Predictor: Anti-Drug Antibody Risk Stratification is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does ADA-Predictor: Anti-Drug Antibody Risk Stratification support?

ADA-Predictor: Anti-Drug Antibody Risk Stratification is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ADA-Predictor: Anti-Drug Antibody Risk Stratification?

It is built and maintained by CryptoReuMD (@cryptoreumd); the current version is v1.0.0.

💬 Comments