skills.rest
anthropics
anthropicsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

fhir-developer-skill

Build FHIR R4 servers with resource validation and OperationOutcome error handling.

376|96|Updated Dec 17, 2025
Search Tags:#validation#rest#healthcare#fhir#fhir-api#smart-on-fhir#operationoutcome
One-click install
npx skills add https://github.com/anthropics/healthcare --skill fhir-developer-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fhir-developer-skill
Source: https://github.com/anthropics/healthcare/tree/main/fhir-developer-skill
Command: npx skills add https://github.com/anthropics/healthcare --skill fhir-developer-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables developers to implement secure, standards-compliant FHIR R4 endpoints with proper validation and error handling across Patient, Observation, Encounter, Condition, and MedicationRequest resources, including SMART on FHIR authorization and OAuth scopes.

Core Features & Use Cases

  • RESTful resource handling for common FHIR resources with correct status codes (200/201/204/422) and proper error reporting via OperationOutcome.
  • SMART on FHIR authorization support, scope enforcement, and example authorization patterns for patient, user, and system contexts.
  • Bundle processing guidance for Batch and Transaction operations, plus pagination and search patterns to build scalable APIs.

Quick Start

Run the FHIR API scaffold to create a compliant server and start testing with Patient and Observation resources.

Frequently Asked Questions about fhir-developer-skill

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

FAQPage Schema
How do I build a FHIR R4 API that validates resources and returns OperationOutcome errors?▼

To build a compliant FHIR R4 API, use this skill to implement RESTful endpoints that validate resources and return proper HTTP status codes (200/201/204/422) with OperationOutcome responses for error handling.

How does SMART on FHIR OAuth scope enforcement work for patient and system contexts?▼

SMART on FHIR OAuth scope enforcement restricts API access by validating authorization scopes for patient, user, and system contexts. This skill provides example authorization patterns to secure FHIR endpoints.

What's the best way to handle FHIR Bundle transactions and pagination for scalable APIs?▼

For scalable FHIR APIs, handle Bundle processing using Batch and Transaction operations provided by this skill, which also includes search patterns and pagination guidance to manage large result sets efficiently.

Can I use this skill to implement Patient, Observation, and MedicationRequest resources together?▼

Yes, this skill supports RESTful resource handling for Patient, Observation, Encounter, Condition, and MedicationRequest resources, allowing you to implement multiple FHIR endpoints with standardized data types and value sets.

Why does my FHIR server return a 422 status code instead of a validation error message?▼

A 422 status code indicates a failed validation. This skill ensures your FHIR server returns correct status codes and includes an OperationOutcome resource detailing the specific validation errors.

Do I need prior FHIR API knowledge to scaffold a compliant server with this skill?▼

No prior FHIR scaffolding knowledge is needed. The skill provides templates and examples to quickly create a compliant FHIR server and start testing with Patient and Observation resources immediately.

Related Skills

Explore More Software Engineering Skills→
Zhow01Zhow01
52

fhir-developer-skill

Develop FHIR-compliant REST endpoints with SMART on FHIR authorization.

Community
Advanced
Fadil369Fadil369

fhir-generator

Generate FHIR R4 Patient, Observation, MedicationRequest, and Condition resources as JSON bundles.

Community
Intermediate
aks-buildsaks-builds
1

terminology-services

Provides healthcare code system validation, FHIR terminology operations, mapping, and reference guidance for engineers.

Community
Advanced
aks-buildsaks-builds
1

fhir-integration

Parse and validate FHIR R4/R5 resources using Python libraries.

Community
Advanced