drug-drug

Original：🇺🇸 English

Translated

Evidence-based Drug-Drug Interaction (DDI) assessment skill modeled after the Micromedex Drug-Reax methodology. Trigger this skill whenever the user types /drug-drug, mentions "drug interaction", "DDI", "drug-drug", "can I take X with Y", "interaction between", "交互作用", "併用", or asks whether two medications can be used together. This skill performs systematic literature retrieval via PubMed, CrossRef, and WebSearch, then produces a structured assessment report with Severity, Documentation, Onset, Mechanism, Clinical Effects, and Management — mirroring the Micromedex Drug-Reax classification framework. Even casual questions like "is it safe to combine A and B" should trigger this skill.

4installs

Sourcehtlin222/drug-drug-skill

Added on2026-04-25

NPX Install

npx skill4agent add htlin222/drug-drug-skill drug-drug

SKILL.md Content

View Translation Comparison →

Drug-Drug Interaction (DDI) Evidence-Based Assessment

Overview

This skill implements a Retrieval-Augmented Generation (RAG) approach to drug-drug interaction assessment, modeled after the Micromedex Drug-Reax System methodology. Rather than relying on LLM training data alone -- which may be outdated, incomplete, or hallucinated -- every claim in the output is grounded in real-time literature retrieval from peer-reviewed sources with full citation traceability. The structured report mirrors Micromedex Drug-Reax classification grades and is designed to complement (not replace) certified drug information systems and clinical pharmacist expertise.

Trigger

```
/drug-drug DrugA DrugB
```
Any query mentioning two drug names and asking about interaction, safety, or concomitant use
Keywords: DDI, interaction, contraindication, concomitant, 交互作用, 併用

Workflow (execute strictly in order)

Step 0: Drug Name Resolution

Extract two drug names from user input. If the user provides brand names, resolve to INN/generic names. If only one drug is provided or names are ambiguous, ask the user to clarify.

Step 1: Literature Search

Execute at least 5 distinct searches to ensure adequate coverage:

PubMed Search (via web_search)

site:pubmed.ncbi.nlm.nih.gov "DrugA" "DrugB" interaction

site:pubmed.ncbi.nlm.nih.gov "DrugA" "DrugB" pharmacokinetic

site:pubmed.ncbi.nlm.nih.gov "DrugA" "DrugB" CYP450

CrossRef Search (via web_fetch)

https://api.crossref.org/works?query=DrugA+DrugB+drug+interaction&rows=10&sort=relevance

General WebSearch

DrugA DrugB drug interaction clinical significance

DrugA DrugB interaction mechanism CYP enzyme

DrugA DrugB interaction case report adverse event

FDA Label / DailyMed

site:dailymed.nlm.nih.gov DrugA interaction

DrugA DrugB FDA drug interaction warning

PubMed MCP Tool (if PubMed MCP server is connected)

Use

PubMed:search_articles

with

"DrugA" AND "DrugB" AND "drug interaction"

Use
```
PubMed:get_article_metadata
```
for key articles

Step 2: Evidence Appraisal

Read

references/evidence-grading.md

for complete grading criteria.

For each retrieved article, extract and document:

Study design (RCT / cohort / case-control / case report / in vitro / review)
Sample size
Key findings (AUC fold-change, Cmax change, clinical events)
Interaction mechanism described
Credibility assessment

Traceability requirement: Every factual claim in the final report must be attributable to a specific source with PMID or DOI. If a claim is inferred from pharmacologic reasoning rather than direct evidence, it must be explicitly labeled as such (e.g., "based on known CYP3A4 inhibition profile" rather than stated as established fact).

Uncertainty signaling: When evidence is limited or conflicting, the report must explicitly state the level of uncertainty. Use phrases such as "limited evidence suggests," "based on case reports only," or "no direct clinical studies available; assessment based on pharmacologic reasoning." Never present uncertain inferences with the same confidence as RCT-level evidence.

Step 3: Structured Classification

Classify using the Micromedex Drug-Reax framework. See

references/evidence-grading.md

for detailed decision trees.

3a. Severity

Grade	Definition
Contraindicated	Drugs are contraindicated for concurrent use
Major	Interaction may be life-threatening and/or require medical intervention to minimize or prevent serious adverse effects
Moderate	Interaction may result in exacerbation of the patient's condition and/or require a change in therapy
Minor	Interaction would have limited clinical effects; may augment side effects but generally does not require a change in therapy

3b. Documentation

Grade	Definition
Excellent	Controlled studies have clearly established the existence of the interaction
Good	Documentation strongly suggests the interaction exists, but well-controlled studies are lacking
Fair	Available documentation is poor, but pharmacologic considerations lead clinicians to suspect the interaction exists; or documentation is good for a pharmacologically similar drug
Poor	Documentation is very limited, e.g., only isolated case reports or theoretical rationale
Unlikely	No reasonable pharmacologic basis for the interaction

3c. Onset

Grade	Definition
Rapid	Clinical effects of the interaction occur within 24 hours
Delayed	Clinical effects of the interaction occur after 24 hours
Not specified	Onset not clearly documented in the literature

3d. Mechanism

Classify the interaction mechanism into:

Pharmacokinetic (PK):

CYP450 enzyme inhibition (specify isoform: CYP3A4, CYP2D6, CYP2C19, CYP2C9, CYP1A2, etc.)
CYP450 enzyme induction
P-glycoprotein (P-gp) / transporter-related
Protein binding displacement
Renal tubular secretion competition
Absorption-level (pH alteration, chelation, etc.)

Pharmacodynamic (PD):

Additive effect (e.g., QTc prolongation, bleeding risk, CNS depression)
Synergistic effect
Antagonistic effect

Step 4: Report Generation

Produce the final report in the following format:

markdown

# Drug-Drug Interaction Assessment Report

## Drug Pair

- **Drug A:** [Generic Name] ([Brand Names])
- **Drug B:** [Generic Name] ([Brand Names])

## Structured Classification

| Parameter       | Grade          | Note              |
|-----------------|----------------|-------------------|
| Severity        | [Grade]        | [note]            |
| Onset           | [Grade]        | [note]            |
| Documentation   | [Grade]        | [note]            |

## Interaction Effect

[Description of the clinical effect of the interaction — what happens when these drugs are used together]

## Clinical Management

[Specific clinical management recommendations:]

- Whether to avoid concomitant use
- Dose adjustments required
- Monitoring parameters
- Alternative drug suggestions

## Probable Mechanism

[Pharmacological mechanism — PK and/or PD, including specific enzymes, transporters, or receptors involved. Include PK data (AUC/Cmax changes) if available from studies.]

## Evidence Sources

[Key references: Author, Journal, Year, PMID/DOI]

## Disclaimer

> **This report is generated by AI using a retrieval-augmented generation (RAG) approach and
> is intended as a clinical decision support aid only.** It does not constitute medical advice
> and cannot replace certified drug information systems (Micromedex, Lexicomp, Clinical
> Pharmacology) or the judgment of qualified healthcare professionals. AI-generated content
> carries inherent limitations including potential for incomplete literature retrieval,
> misinterpretation of source data, and inability to account for individual patient factors.
> All clinical decisions must be made by licensed practitioners with access to complete
> patient information, institutional formulary policies, and current prescribing guidelines.
> When in doubt, consult a clinical pharmacist or drug information specialist.

Key Principles

Retrieval before generation: Never rely on LLM training data alone. Always perform real-time literature search before generating any assessment. Training data may be outdated, incomplete, or reflect unverified sources (social media, blogs). Real-time retrieval from peer-reviewed databases ensures currency and reliability.
Multi-source cross-validation: Use at least PubMed + CrossRef + WebSearch (three sources). Cross-validate findings across sources to reduce the risk of hallucination or bias from any single retrieval.
Full citation traceability: Every factual claim must cite its source (PMID, DOI, or URL). This enables clinicians to fact-check AI-generated answers against the original sources -- a core requirement for explainable AI (XAI) in clinical settings.
Conservative grading: When evidence is insufficient, err on the side of higher severity and lower documentation grade (err on the side of caution). Patient safety takes precedence over precision.
Mechanism is king: Even without clinical studies, if the pharmacologic mechanism is clear (e.g., known CYP inhibitor + known CYP substrate), document it and assign at least Fair documentation.
Transparency of uncertainty: The report must clearly distinguish between evidence-supported facts, pharmacologic inferences, and areas of genuine uncertainty. Never present inferred information with the same confidence as controlled-study evidence.
Context matters: Note dose-dependent or population-specific differences when evidence supports them (e.g., high-dose vs. low-dose regimens may carry different risk profiles).
Complement, not replace: This tool supports clinical decision-making but does not substitute for professional judgment. The output is designed to be reviewed by a clinician, not acted upon autonomously.
Language: The report body defaults to English. If the user writes in another language, respond in that language but keep drug names, grade labels, and pharmacological terms in English.

Reference Files

```
references/evidence-grading.md
```
: Complete evidence grading criteria, decision trees, CYP450 quick reference, and common PD interaction patterns