mapping-loinc

Map free-text laboratory tests to validated LOINC codes with UCUM units.

5.0k|615|Updated Oct 4, 2025
One-click install
npx skills add https://github.com/maziyarpanahi/openmed --skill mapping-loinc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mapping-loinc
Source: https://github.com/maziyarpanahi/openmed/tree/main/skills/mapping-loinc
Command: npx skills add https://github.com/maziyarpanahi/openmed --skill mapping-loinc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves free-text laboratory tests and clinical observations into precise LOINC codes, helping prevent ambiguity across analytes, specimens, methods, and measurement scales.

Core Features & Use Cases

  • Observation Mapping: Map laboratory tests, vital signs, and clinical measurements to fully specified LOINC concepts.
  • Terminology Validation: Search and validate candidate codes through FHIR terminology services, then retrieve canonical displays and UCUM units.
  • FHIR Output: Support US Core Laboratory Result Observation resources with traceable source offsets and structured result data.
  • Use Case: Given a note containing serum potassium and hemoglobin A1c results, identify the correct LOINC codes by considering specimen, method, value, and unit while distinguishing panels from individual analytes.

Quick Start

Use the mapping-loinc skill to map each laboratory observation in the provided clinical text to a validated LOINC code with its display name and UCUM unit.

Frequently Asked Questions about mapping-loinc

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

FAQPage Schema
How do I map free-text laboratory tests to LOINC codes from clinical notes?

Map free-text laboratory tests to LOINC codes by applying a mapping workflow to analytes, specimens, methods, and UCUM units extracted from clinical notes. This process uses FHIR terminology search and validation to resolve precise observation codes.

What is the best way to distinguish laboratory panels from individual analytes during observation mapping?

Distinguish laboratory panels from individual analytes during observation mapping by evaluating the extracted specimen, method, value, and unit context. This ensures the selected LOINC code accurately reflects whether the observation is a grouped panel or a single test.

Can I generate US Core Laboratory Result Observation resources with traceable source offsets?

You can generate US Core Laboratory Result Observation resources with traceable source offsets by mapping clinical observations to validated LOINC codes. The output includes structured result data, canonical displays, and UCUM units compliant with FHIR standards.

Do I need to supply UMLS and SNOMED data separately for clinical terminology mapping?

You need to supply UMLS and SNOMED data separately for clinical terminology mapping. The process keeps UMLS and SNOMED data user-supplied and out-of-process, while handling LOINC data license-compliantly to ensure traceable and validated observation mapping.

How does FHIR terminology validation work for laboratory coding?

FHIR terminology validation for laboratory coding works by searching and validating candidate LOINC codes through terminology services. It retrieves canonical displays and UCUM units, ensuring the mapped clinical observations are precise and disambiguated by specimen and method.

Why does mapping clinical observations require specimen and method disambiguation?

Mapping clinical observations requires specimen and method disambiguation to prevent ambiguity across analytes, specimens, methods, and measurement scales. Resolving these contextual elements ensures the final LOINC code accurately represents the specific laboratory test or vital sign.