concept-mapping-drug

Map source drug concepts to OMOP RxNorm Clinical Drug concepts.

6|1|Updated Aug 25, 2021
One-click install
npx skills add https://github.com/BorisDelange/Linkr --skill concept-mapping-drug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: concept-mapping-drug
Source: https://github.com/BorisDelange/Linkr/tree/main/.claude/skills/concept-mapping-drug
Command: npx skills add https://github.com/BorisDelange/Linkr --skill concept-mapping-drug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It resolves clinical drug terminology by mapping source drug concepts to the correct OMOP RxNorm Clinical Drug, avoiding incorrect matches caused by similar names with different strength or dose form.

Core Features & Use Cases

  • Structured drug parsing: Extracts ingredient, strength, and dose form from concept labels and info_json fields like categorical_data and numerical_data.
  • Two mapping strategies: Uses OMOP relationship traversal (ingredient/ATC → Clinical Drug) and falls back to structured search (ingredient + strength + dose form) plus synonym lookup for trade names.
  • Strict validation & safe outcomes: Enforces component equivalence rules and blocks unsafe mappings for incompatible dose forms, incorrect strengths, categories instead of specific drugs, and homeopathic/diluted products.

Quick Start

Use concept-mapping-drug to map a batch of OMOP Drug domain concepts to RxNorm Clinical Drug candidates from your loaded DuckDB session, then return only the approved mappings to the orchestrator.

Frequently Asked Questions about concept-mapping-drug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map source drug concepts to OMOP RxNorm Clinical Drugs?

To map source drug concepts to OMOP RxNorm, the process parses ingredient, strength, and dose form from concept labels, then validates three-component equivalence against OMOP vocabulary tables loaded in DuckDB. It uses relationship traversal and structured search to return approved mappings.

How do I prevent incorrect drug terminology matches caused by similar names?

Preventing incorrect drug terminology matches requires strict validation of ingredient, strength, and dose form equivalence. The mapping process blocks unsafe matches for incompatible dose forms, incorrect strengths, categories instead of specific drugs, and homeopathic or diluted products to ensure clinical accuracy.

Does concept mapping for OMOP drugs require a specific DuckDB setup?

Concept mapping for OMOP drugs requires a DuckDB session at /tmp/concept-mapping-session.duckdb. This database must contain the concept, concept_synonym, concept_relationship, concept_ancestor, source_concepts, and existing_mappings tables to successfully query and validate RxNorm Clinical Drug candidates.

Can I use trade-name synonyms for RxNorm drug mapping?

Trade-name synonyms can be used for RxNorm drug mapping through optional synonym resolution. When structured search based on ingredient, strength, and dose form is performed, the system queries the concept_synonym table to resolve trade names to their corresponding OMOP RxNorm Clinical Drug concepts.

What are the limitations when mapping drugs to RxNorm Clinical Drug concepts?

Limitations when mapping drugs to RxNorm include blocking mappings for incompatible dose forms, incorrect strengths, categories mapped instead of specific drugs, and homeopathic or diluted products. The strict validation rules ensure only exact three-component equivalence passes the mapping process.