langcare-demographics

Patient Demographics Summary

When to Use This Skill

Use when a clinician needs a consolidated view of non-clinical patient data including identifiers, contact information, emergency contacts, insurance coverage, preferred language, and advance directive status.

Clinical Workflow

1. Use fhir_read to retrieve the Patient resource and extract identifiers, name, DOB, gender, race/ethnicity (US Core extensions), address, telecom, preferred language, and marital status
2. Use fhir_search to find RelatedPerson resources linked to the patient for emergency contacts, next of kin, and guarantors
3. Use fhir_search to retrieve active Coverage resources for insurance information including plan name, group, subscriber ID, payor, and coverage order
4. Use fhir_search to check for advance directives via Consent (category=acd) or DocumentReference (LOINC 64298-3)
5. Flag missing critical data: no emergency contact, no active insurance, no preferred language, no phone/email, no address, no advance directive on file

FHIR Resources

• Patient -- Core demographics: name, birthDate, gender, address, telecom, communication, identifier, extension (us-core-race, us-core-ethnicity)
• RelatedPerson -- Emergency contacts, next of kin, guarantors: name, telecom, relationship, period
• Coverage -- Insurance information: status, type, subscriberId, payor, period, class, order
• Consent -- Advance directives: category, status, dateTime
• DocumentReference -- Advance directive documents: type (LOINC 64298-3), status

FHIR Query Examples

Retrieve Patient Resource

fhir_read(resourceType="Patient", id="[patient-id]")

Find Emergency Contacts

fhir_search(resourceType="RelatedPerson", queryParams="patient=[patient-id]")

Retrieve Active Insurance

fhir_search(resourceType="Coverage", queryParams="patient=[patient-id]&status=active")

Check Advance Directives

fhir_search(resourceType="Consent", queryParams="patient=[patient-id]&category=http://terminology.hl7.org/CodeSystem/consentcategorycodes|acd")