querying-terminology-service

Validate clinical entity spans into FHIR terminology codes via a user-operated server.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps convert clinical entity spans into validated, interoperable FHIR codes without bundling restricted vocabularies or sending patient notes to external services.

Core Features & Use Cases

  • Code Validation: Confirm that SNOMED CT, RxNorm, LOINC, ICD-10, and other codes are valid through a user-operated FHIR terminology server.
  • Terminology Operations: Expand ValueSets with filters or SNOMED ECL, look up code displays and properties, and translate codes through ConceptMaps.
  • OpenMed Integration: Ground entity predictions into validated CodeableConcept structures while preserving text-only fallbacks and warning outcomes for invalid codes.
  • Use Case: Given an OpenMed entity span such as “type 2 diabetes,” validate the candidate SNOMED CT code and produce a coded FHIR CodeableConcept without transmitting the source clinical note.

Quick Start

Use the querying terminology service skill to validate the candidate code for the supplied clinical entity against my licensed FHIR terminology server and return a FHIR CodeableConcept only when validation succeeds.

Frequently Asked Questions about querying-terminology-service

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

FAQPage Schema
How do I validate clinical codes against a FHIR terminology server?

You validate clinical codes by applying terminology validation through a user-operated FHIR terminology server. This confirms that SNOMED CT, RxNorm, LOINC, and ICD-10 codes are valid without bundling restricted vocabularies or sending patient notes to external services.

Can I expand ValueSets with SNOMED ECL filters for clinical coding?

Yes, you can expand ValueSets with filters or SNOMED ECL. The terminology server processes bounded expansions, performs code lookups, and translates codes through ConceptMaps for interoperable clinical coding workflows.

How do I convert clinical entity spans into FHIR CodeableConcept structures?

You ground clinical entity spans into validated FHIR CodeableConcept structures by validating candidate codes against a licensed terminology server. It returns a coded FHIR CodeableConcept only when validation succeeds, preserving text-only fallbacks for invalid codes.

Do I need a licensed FHIR terminology server to validate SNOMED CT codes?

Yes, you must operate a user-managed FHIR terminology server. The skill requires version-aware requests, bounded expansions, and credential protection to perform code validation while strictly excluding PHI from terminology-service calls.

What are the limitations of using a FHIR terminology server for code validation?

Limitations include the requirement to exclude PHI from terminology-service calls and the need for bounded expansions to manage server load. You must also handle credential protection and version-aware requests manually to ensure secure code validation.