parsing-hl7v2-messages

Extract clinical narrative from pipe-delimited HL7 v2 messages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill extracts usable clinical narrative from pipe-delimited HL7 v2 messages while preserving message structure and supporting privacy-conscious processing before analysis.

Core Features & Use Cases

  • Message Parsing: Decode HL7 v2 segments, fields, components, repetitions, sub-components, and encoding characters across common message versions.
  • Narrative Extraction: Collect free-text content from OBX-5 and NTE-3, including laboratory results, reports, notes, and observations.
  • Segment-Aware De-identification: Redact identifiers and free text while preserving HL7 framing, segment order, and selected linkage keys.
  • Use Case: Process an ORU laboratory feed, extract its impression and comments, de-identify the narrative, and pass it to OpenMed for entity extraction and clinical analysis.

Quick Start

Use the HL7 parsing skill to read the supplied message, extract narrative from eligible OBX and NTE fields, de-identify it with OpenMed, and return structured clinical insights.

Frequently Asked Questions about parsing-hl7v2-messages

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

FAQPage Schema
How do I extract clinical narrative from HL7 v2 messages?

Extract clinical narrative from HL7 v2 messages by parsing pipe-delimited segments and collecting free-text content from OBX-5 and NTE-3 fields. This handles laboratory results, reports, notes, and observations from common message feeds.

Can I parse HL7 ORU and ADT feeds from an interface engine?

Yes, you can parse HL7 ORU and ADT feeds from interface engines. The parsing supports common message types including ORU, ADT, MDM, and ORM feeds originating from laboratory systems, EHRs, and clinical document workflows.

How does HL7 message parsing handle escape sequences and MLLP?

HL7 message parsing handles escape sequences and MLLP by applying delimiter-aware segment parsing. This accurately decodes fields, components, repetitions, and sub-components across common HL7 v2 message versions while preserving message structure.

How do I de-identify free text in HL7 feeds before analysis?

De-identify free text in HL7 feeds using segment-aware redaction that removes identifiers while preserving HL7 framing, segment order, and selected linkage keys. This ensures privacy-conscious processing before clinical analysis.

What is the best way to process laboratory results for entity extraction?

The best way to process laboratory results for entity extraction is to parse ORU feeds, extract impressions and comments from OBX-5 and NTE-3, de-identify the narrative, and pass it to OpenMed for entity extraction and clinical analysis.

Does HL7 v2 parsing preserve segment order during de-identification?

Yes, HL7 v2 parsing preserves segment order during de-identification. The segment-aware redaction process removes identifiers and free text while maintaining the original HL7 framing, segment order, and selected linkage keys.