Drugs Com Reviews

---
name: druglib-reviews
description: >
  Query the DrugLib.com Drug Review Dataset (UCI #461). Use whenever the user
  asks about patient drug reviews, drug effectiveness ratings, side-effect
  profiles, or condition-specific treatment experiences from DrugLib.com.
---

# DrugLib Reviews Query Skill

Search patient drug reviews by drug name or medical condition. Auto-detects
entity type and routes to the appropriate field.

| Input Pattern | Detected As | Match Logic |
|---|---|---|
| single/two-word term (e.g. `lamictal`) | drug name | substring on `urlDrugName` |
| multi-word or medical keyword (e.g. `bipolar disorder`) | condition | substring on `condition` |

Condition keywords that trigger condition routing: disease, disorder, syndrome,
infection, pain, cancer, diabetes, hypertension, depression, anxiety, asthma,
arthritis, migraine, allergy, insomnia, nausea, obesity, acne, gerd, copd.

## API

| Function | Input | Returns |
|---|---|---|
| `load_reviews()` | — | list[dict] (cached) |
| `search(entity)` | single entity string | list[dict] |
| `search_batch(entities)` | list of entity strings | dict[str, list[dict]] |
| `summarize(hits, entity)` | list[dict] + label | compact LLM-readable text |
| `to_json(hits)` | list[dict] | list[dict] (JSON-serialisable) |

## Usage

See `if __name__ == "__main__"` block in `16_DRUGLIB_REVIEWS.py` for runnable
examples covering: drug name search, condition search, batch search, and JSON
output.

## Data

- **Source**: Drug Review Dataset (Druglib.com), UCI ML Repository #461
- **Citation**: Kallumadi, S. & Gräßer, F. (2018). *Drug Reviews (Druglib.com)* [Dataset]. UCI Machine Learning Repository. https://doi.org/10.24432/C55G6J
- **License**: CC BY 4.0
- **Files**: `drugLibTrain_raw.tsv`, `drugLibTest_raw.tsv` (TSV, merged at load)
- **Path**: `DATA_DIR` variable in `16_DRUGLIB_REVIEWS.py`
- **Columns**:

| Column | Type | Description |
|---|---|---|
| `urlDrugName` | str | Drug name (lowercase, URL-style) |
| `rating` | int 0–9 | Overall patient satisfaction |
| `effectiveness` | str | Highly / Considerably / Moderately / Marginally Effective, Ineffective |
| `sideEffects` | str | No / Mild / Moderate / Severe / Extremely Severe Side Effects |
| `condition` | str | Medical condition being treated |
| `benefitsReview` | str | Free-text review of benefits |
| `sideEffectsReview` | str | Free-text review of side effects |
| `commentsReview` | str | Free-text general comments |