map-drugs

What problem does it solve?

Mapping heterogeneous pharmaceutical product records to standardized RxNorm/OMOP concepts is complex, error-prone, and requires domain rules beyond simple string matching; this Skill captures the conventions, exceptions, and validation needed to produce reliable mappings.

Core Features & Use Cases

• Mapping conventions: Clear rules for EXACT vs BROAD mappings, terminology adaptation, and unit/weight conversions to align EMA/EU terminology with RxNorm.
• Dose form and precision guidance: Rules for selecting volume-specific vs concentration-only concepts, injectables distinctions, and device-related decisions.
• Validation and reproducibility: A validation script enforces column order, date format, concept_id types, and BROAD mapping suggestions to ensure consistent mapping.tsv outputs.
• Biosimilars and edge cases: Procedures for detecting FDA-suffixed INNs, constructing suggestions when no exact match exists, and avoiding inappropriate use of US brand names.

Quick Start

Map the EMA product with MA number MA123456 to the most precise RxNorm concept, save the results as mapping.tsv in the product folder, and run the .claude/skills/map-drugs/validate_mapping.py script to validate the file.