concept-mapping-ai

Map source clinical concepts to OMOP standards via DuckDB search.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It reduces the manual effort and inconsistency of mapping source clinical concepts (measurements, conditions, procedures, observations) to the correct OMOP standard concepts by generating candidate matches and providing structured reasoning.

Core Features & Use Cases

  • Agentic OMOP Concept Mapping: Produces ranked candidates for each source concept using DuckDB search, precomputed similarity scores, and clinical reasoning.
  • SSSOM-graded Equivalence: Assigns equivalence levels (skos:exactMatch, closeMatch, broadMatch, narrowMatch, relatedMatch) with evidence-oriented comments to support reviewer decisions.
  • Two Write Destinations: Saves results either as UI-reviewable suggestions in similarity-scores.parquet or as reviewer-confirmed authored mappings in mappings.json.
  • Batch Processing with Guardrails: Operates on prepared DuckDB session context, supports per-batch review modes, and handles edge cases like missing matches or non-standard concepts.

Quick Start

Ask the concept-mapping orchestrator to run the concept-mapping-ai skill for your selected source concept batch with an existing DuckDB session context and a chosen destination mode (suggestions or mappings).

Frequently Asked Questions about concept-mapping-ai

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

FAQPage Schema
How do I map source clinical concepts to OMOP standard concepts?

Mapping source clinical concepts to OMOP standard concepts is done by generating and ranking candidate matches using DuckDB search, precomputed similarity scores, and clinical reasoning across batches. The Skill assigns SSSOM equivalence levels with evidence comments to support reviewer decisions.

Can I use DuckDB to search OMOP tables for concept mapping candidates?

Yes, DuckDB is used to search loaded OMOP tables for concept mapping candidates. A prepared DuckDB session context with defined OMOP tables is required to generate ranked matches for source measurements, conditions, procedures, and observations.

How do I assign SSSOM equivalence levels to OMOP concept mappings?

SSSOM equivalence levels are assigned by evaluating generated candidate matches and applying clinical reasoning to grade them as exactMatch, closeMatch, broadMatch, narrowMatch, or relatedMatch. Evidence-oriented comments are provided for each graded mapping to support reviewer decisions.

Does concept mapping to OMOP support batch processing and review modes?

Batch processing with per-batch review modes is supported for mapping clinical concepts to OMOP. The Skill operates on prepared DuckDB session context and handles edge cases like missing matches or non-standard concepts across selected source concept batches.

What format does the output need to be in for OMOP concept mapping suggestions?

OMOP concept mapping suggestions can be output as rows formatted for a similarity parquet file for UI review, or as approved ConceptMapping objects written to a mappings.json file for reviewer-confirmed authored mappings.

What's the best way to automate clinical reasoning for OMOP concept mapping?

Automating clinical reasoning for OMOP concept mapping is best handled by an agentic workflow that generates ranked candidates using DuckDB search and precomputed similarity scores. It reduces manual effort and inconsistency by applying structured reasoning across batches.