Skip to main content
affpapa.org
RU EN
skill CX Codex official · Anthropic

fhir-developer-skill — Claude Code skill: what it does, how to install

Guides FHIR R4 API development across healthcare endpoints: handles resource validation, OperationOutcome errors, standard status codes, and coding systems.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add anthropics/healthcare --skill fhir-developer-skill -a claude-code
npx skills add anthropics/healthcare --skill fhir-developer -a claude-code
Open on GitHub

What fhir-developer-skill does

This skill provides structural rules for building healthcare REST endpoints following FHIR R4. It details resource layouts for Patient, Observation, Encounter, Condition, and MedicationRequest. Inside are concrete validation snippets for Python FastAPI using Pydantic v2 literals and TypeScript Express, paired with application/fhir+json responses.

Field validation strictly depends on cardinality. Only fields marked 1..1 or 1..* are enforced as required. For instance, Encounter leaves subject and period optional under 0..1 cardinality, so rejecting payloads without them is an error. Invalid enum values or missing required fields return a 422 Unprocessable Entity status with an OperationOutcome payload. When an If-Match ETag check fails, the API responds with 412 Precondition Failed rather than 400.

The guide also maps canonical terminology URIs for LOINC, SNOMED CT, RxNorm, and ICD-10, alongside common vital sign identifiers. It prepares agents to wire up SMART on FHIR OAuth scopes and manage batch operations without misinterpreting FHIR requirements.

What it helps with

  • validate FHIR R4 payloads in FastAPI or Express
  • generate compliant OperationOutcome responses with 422 status
  • reference standard terminology URLs for LOINC, SNOMED, and ICD-10
  • enforce required fields strictly by schema cardinality

Example prompts for the agent

  • Write a POST /Observation endpoint in FastAPI with enum validation and OperationOutcome errors.
  • Create a Pydantic v2 model for a FHIR Patient resource using Literal types for gender.
  • Handle If-Match ETag checks for an Encounter endpoint returning 412 Precondition Failed on mismatch.

How to install fhir-developer-skill

1Skills CLI (Vercel)

npx skills add anthropics/healthcare --skill fhir-developer-skill -a claude-code
npx skills add anthropics/healthcare --skill fhir-developer -a claude-code

2Manually: put the files in place

~/.claude/skills/fhir-developer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/fhir-developer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about fhir-developer-skill

How do I install fhir-developer-skill in Claude Code?

Run npx skills add anthropics/healthcare --skill fhir-developer-skill -a claude-code. You can also save the file directly to ~/.claude/skills/fhir-developer/SKILL.md.

What does fhir-developer-skill do?

It instructs coding agents on building FHIR R4 APIs, providing required field schemas, HTTP status codes, OperationOutcome structures, and terminology URLs.

When should an endpoint return 422 versus 400 in FHIR?

Return 400 for malformed JSON or incorrect resourceType values. Return 422 Unprocessable Entity for missing required fields, invalid enum codes, or business logic violations.

Similar skills

Everything for Backend and APIs →
fastapi-developer VoltAgent Community A Claude subagent for building async Python APIs on FastAPI: Pydantic v2 models, dependency injection, OpenAPI docs. ★ 26,065repo stars fastapi-python Mindrally Tells the agent how to write FastAPI code: async I/O, Pydantic v2 models, early returns and router layout. Useful when you build a Python API. CX Codex +1 13,900installs fastapi-patterns affaan-m Provides production patterns for FastAPI, including Pydantic v2 schemas, async dependencies, and service layers. Useful when writing or reviewing API architectures. CX Codex +1 4,900installs stripe-webhooks hookdeck A skill for Stripe webhook work: signature verification, event parsing and ready handler examples. Useful when payment events fail verification. CX Codex +1 595installs api-smoke-testing spencerpauly Finds API endpoints across your codebase, spins up the local dev server, and tests every route with curl. Spots unmounted 404 routes and 500 server crashes before release. CX Codex +1 495installs fastapi-development aj-geddes A skill that steers your AI agent toward idiomatic FastAPI code: async routes, Pydantic validation, JWT auth and automatic OpenAPI docs. CX Codex +1 618installs

From the same set3

clinical-trial-protocol-skill Builds clinical trial protocols for medical devices and drugs. It helps research prior studies and draft study sections for FDA submissions. CX Codex +1 448installs prior-auth-review-skill Automates payer review of prior authorization requests: reads clinical documents, checks medical necessity against coverage policy and issues a decision. CX Codex +1 342installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor