hl7v2-to-fhir-pipeline

Orchestrate HL7v2-to-FHIR converter creation with ticket-driven pipeline stages.

7|3|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/Aidbox/aidbox-hl7v2-example --skill hl7v2-to-fhir-pipeline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hl7v2-to-fhir-pipeline
Source: https://github.com/Aidbox/aidbox-hl7v2-example/tree/main/.claude/skills/hl7v2-to-fhir-pipeline
Command: npx skills add https://github.com/Aidbox/aidbox-hl7v2-example --skill hl7v2-to-fhir-pipeline

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured orchestration layer to extend or create HL7v2→FHIR message converters and field mappings, ensuring consistent collection of examples, requirements, design, implementation, and review steps while enforcing de-identification and commit discipline.

Core Features & Use Cases

  • Orchestration & Pipeline Enforcement: Acts as the primary agent that spawns sub-agents for requirements, exploration, design, planning, implementation, and review while committing progress between steps.
  • Ticket-Driven Workflow: Creates and manages ticket directories under ai/tickets/converter-skill-tickets, collects example messages, runs spec/mapping exploration, and enforces the stepwise pipeline.
  • Safety & Data Handling: Requires de-identification of example messages, supports automated example generation when needed, and mandates strict resume/NEED_USER_INPUT behavior for sub-agents.

Quick Start

Place example HL7v2 messages into ai/tickets/converter-skill-tickets/<ticket-name>/examples and ask the skill to begin work on that ticket.

Frequently Asked Questions about hl7v2-to-fhir-pipeline

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

FAQPage Schema
How do I map HL7v2 messages to FHIR format?

To map HL7v2 messages to FHIR format, use a pipeline orchestration approach that manages example collection, requirements generation, design, and iterative implementation for ADT/ORU/BAR workflows while enforcing de-identification and commit discipline.

How do I de-identify HL7v2 examples before converting them to FHIR?

De-identifying HL7v2 examples before FHIR conversion is enforced automatically by the orchestration pipeline. It requires strict de-identification of example messages during collection and supports automated example generation to maintain data safety throughout the mapping process.

What is the best way to manage HL7v2 to FHIR converter development tickets?

The best way to manage HL7v2 to FHIR converter development tickets is using a ticket-driven workflow that creates directories for examples, runs spec exploration, and enforces a stepwise pipeline with sub-agent handoffs and commit-every-step discipline.

Can I use sub-agents for HL7v2 to FHIR mapping requirements and design?

Yes, you can use sub-agents for HL7v2 to FHIR mapping requirements and design. The orchestration layer spawns sub-agents for requirements, exploration, design, planning, implementation, and review, utilizing NEED_USER_INPUT semantics and strict resume behavior.

Does the HL7v2 to FHIR pipeline support automated example generation?

Yes, the HL7v2 to FHIR pipeline supports automated example generation when needed. It enforces de-identification of collected example messages and mandates strict resume behavior for sub-agents during the iterative implementation process.

What are the limitations of orchestrating HL7v2 to FHIR message converters?

Limitations of orchestrating HL7v2 to FHIR message converters include strict dependency on sub-agent resume behavior and NEED_USER_INPUT semantics, requiring commit-every-step discipline and manual placement of example messages into specific ticket directories to function correctly.