fhir-developer-skill
FHIR API development guide for building healthcare endpoints. Use when: (1) Creating FHIR REST endpoints (Patient, Observation, Encounter, Condition, MedicationRequest), (2) Validating FHIR resources and returning proper HTTP status codes and error responses, (3) Implementing SMART on FHIR authorization and OAuth scopes, (4) Working with Bundles, transactions, batch operations, or search pagination. Covers FHIR R4 resource structures, required fields, value sets (status codes, gender, intent), coding systems (LOINC, SNOMED, RxNorm, ICD-10), and OperationOutcome error handling.
npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill fhir-developer-skill --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# FHIR Developer Skill ## Quick Reference ### HTTP Status Codes | Code | When to Use | |------|-------------| | `200 OK` | Successful read, update, or search | | `201 Created` | Successful create (include `Location` header) | | `204 No Content` | Successful delete | | `400 Bad Request` | Malformed JSON, wrong resourceType | | `401 Unauthorized` | Missing, expired, revoked, or malformed token (RFC 6750) | | `403 Forbidden` | Valid token but insufficient scopes | | `404 Not Found` | Resource doesn't exist | | `412 Precondition Failed` | If-Match ETag mismatch (NOT 400!) | | `422 Unprocessable Entity` | Missing required fields, invalid enum values, business rule violations | ### Required Fields by Resource (FHIR R4) | Resource | Required Fields | Everything Else | |----------|-----------------|-----------------| | Patient | *(none)* | All optional | | Observation | `status`, `code` | Optional | | Encounter | `status`, `class` | Optional (including `subject`, `period`) | | Condition | `subject` | Optional (including `code`, `clinicalStatus`) | | MedicationRequest | `status`, `intent`, `medication[x]`, `subject` | Optional | | Medication | *(none)* | All optional | | Bundle | `type` | O
- Quick Reference
- HTTP Status Codes
- Required Fields by Resource (FHIR R4)
- Required vs Optional Fields (CRITICAL)
- Value Sets (Enum Values)
- Patient.gender
- Observation.status
- Encounter.status
- Encounter.class (Common Codes)
- Condition.clinicalStatus
- Condition.verificationStatus
- MedicationRequest.status
- MedicationRequest.intent
- Bundle.type
python scripts/setup_fhir_project.py my_fhir_api
What does the fhir-developer-skill skill do?
FHIR API development guide for building healthcare endpoints. Use when: (1) Creating FHIR REST endpoints (Patient, Observation, Encounter, Condition, MedicationRequest), (2) Validating FHIR resources and returning proper HTTP status codes and error responses, (3) Implementing SMART on FHIR authorization and OAuth scopes, (4) Working with Bundles, transactions, batch operations, or search pagination. Covers FHIR R4 resource structures, required fields, value sets (status codes, gender, intent), coding systems (LOINC, SNOMED, RxNorm, ICD-10), and OperationOutcome error handling.
How do I install it?
Run `npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill fhir-developer-skill --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From FreedomIntelligence/OpenClaw-Medical-Skills, a repository with 2,909 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.