UniTox Query Skill

SkillDatabases & data

Query the UniTox drug toxicity database. Use whenever the user asks about organ-system toxicity ratings for a drug, multi-organ toxicity profiles, or wants to look up any entity (drug name, SMILES, SPL_ID) in UniTox.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the UniTox Query Skill skill

What this skill tells your AI

The instructions your AI receives, as published by qsong-github/drugclaw in skills/drug_toxicity/unitox/SKILL.md and read by ahel’s review.

Search UniTox records by any entity. Auto-detects type by pattern:

Input PatternDetected AsMatch Logic
b2b3be70-17d8-... (UUID)SPL_IDexact on SPL_ID
long string with =, [, ], @SMILESexact on smiles / all_smiles
anything elsefree textcase-insensitive substring on generic_name

API

FunctionInputReturns
load_unitox(path)TSV pathlist[dict] (cached)
search(entity)single entity stringlist[dict]
search_batch(entities)list of entity stringsdict[str, list[dict]]
summarize(hits, entity)hits + labelcompact ratings-only text
summarize_with_reasoning(hits, entity, systems)hits + label + organ listtext with truncated reasoning
to_json(hits)hitslist[dict] (ratings + metadata)
list_drugs()–sorted list of all drug names

Toxicity Systems (8 organs)

Each drug has ternary rating (No / Low / High) and binary rating (Yes / No) for:

System keyOrgan
cardiotoxicityHeart
dermatological_toxicitySkin
hematologicalBlood
infertilityReproductive
liver_toxicityLiver
ototoxicityEar / Hearing
pulmonary_toxicityLung
renal_toxicityKidney

Usage

See if __name__ == "__main__" block in 28_UniTox.py for runnable examples covering: single drug name search, batch search, JSON output, detailed reasoning for specific organ systems, and total drug count.

Data

  • Source: UniTox v1 from Zenodo (https://zenodo.org/records/11627822)
  • Paper: https://doi.org/10.1101/2024.06.21.24309315
  • Format: CSV or TSV (delimiter auto-detected from header line)
  • Columns: generic_name, 8 × (*_reasoning, *_ternary_rating, *_binary_rating), smiles, all_smiles, SPL_ID
  • Path: DATA_PATH variable in 28_UniTox.py
  • Method: GPT-4o extraction from FDA drug labels; 85–96% clinician concordance

Signals

GitHub stars
116
Forks
3
Last commit
Aug 2026
Advanced
Item type
skill
Key
unitox-query
Source
github.com/qsong-github/drugclaw