validating-us-core

Validate FHIR R4 resources and Bundles for US Core conformance.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies and resolves US Core and USCDI conformance issues that can cause OpenMed-produced FHIR resources and Bundles to be rejected by EHR systems such as Epic and Cerner.

Core Features & Use Cases

  • Official Profile Validation: Validate FHIR R4 resources and Bundles with the HL7 validator_cli.jar, US Core implementation guides, and terminology services.
  • Conformance Gap Detection: Check meta.profile declarations, must-support elements, required statuses, coded values, categories, subjects, UCUM units, and vital-sign profiles.
  • OperationOutcome Conversion: Translate validator findings into structured FHIR OperationOutcome responses for downstream workflows.
  • Use Case: After assembling a de-identified FHIR Bundle, validate it against a pinned US Core release, resolve errors and must-support warnings in the exporter, and confirm it is ready for EHR submission.

Quick Start

Use the validating-us-core skill to validate the assembled synthetic or de-identified FHIR Bundle against a pinned US Core implementation guide and summarize the issues that must be fixed.

Frequently Asked Questions about validating-us-core

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

FAQPage Schema
How do I validate FHIR resources against US Core profiles before EHR submission?

FHIR resources are validated against US Core profiles by running the HL7 validator_cli.jar or validator.fhir.org with the appropriate US Core implementation guide packages and terminology server access to detect conformance gaps. The results are converted into structured OperationOutcome responses for resolution.

What does US Core must-support validation check in FHIR R4 resources?

US Core must-support validation checks FHIR R4 resources for required meta.profile declarations, must-support elements, required statuses, coded values, categories, subjects, and UCUM units to ensure USCDI conformance before EHR ingestion.

Can I use the HL7 validator to check FHIR Bundles for Epic and Cerner interoperability?

Yes, the HL7 validator_cli.jar validates assembled FHIR Bundles against pinned US Core implementation guides to identify and resolve conformance issues that would cause rejection by EHR systems like Epic and Cerner.

Do I need a terminology server to validate FHIR resources for USCDI conformance?

Yes, terminology server access is required alongside the HL7 validator_cli.jar and US Core implementation guide packages to validate coded values and terminology bindings within FHIR resources for USCDI conformance.

Why does my FHIR Bundle fail must-support checks during US Core validation?

FHIR Bundles fail must-support checks during US Core validation when meta.profile declarations are missing, required statuses are absent, coded values do not match terminology bindings, or vital-sign profiles lack UCUM units. Structured OperationOutcome findings pinpoint these exact conformance gaps.

What is the best way to resolve OperationOutcome errors from FHIR US Core validation?

The best way to resolve OperationOutcome errors from FHIR US Core validation is to parse the structured findings, correct the identified must-support and profile declaration gaps in the exporter, and re-run the validator against the pinned US Core release to confirm EHR submission readiness.