# fhir-developer-skill

Скилл помогает создавать медицинские REST API по стандарту FHIR R4: валидировать ресурсы, отдавать корректные статусы HTTP и работать с бандлами.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 663 установки · ★ 431
- Автор: anthropics · официальный репозиторий Anthropic
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/anthropics/healthcare/tree/HEAD/plugins/healthcare/skills/fhir-developer/SKILL.md
- Обновлён: 2026-08-27
- HTML: https://affpapa.org/nevibecode/skills/fhir-developer-skill

## Что делает

Скилл задаёт правила для разработки серверных эндпоинтов здравоохранения. Он содержит спецификации ресурсов FHIR R4: Patient, Observation, Encounter, Condition и MedicationRequest. Внутри собраны шаблоны валидации для FastAPI на Python с моделями Pydantic v2 и для Express на TypeScript, включая формирование ответов с типом `application/fhir+json`.

Агент учится правильно расставлять обязательные поля и коды ошибок. Обязательными считаются только поля с кардинальностью `1..1` или `1..*`. Например, для Encounter поля `subject` и `period` остаются необязательными, так как их кардинальность `0..1` — попытка требовать их приведёт к ложным ошибкам. Для неверных значений справочников и отсутствующих параметров скилл возвращает статус 422 и объект OperationOutcome, а при несовпадении заголовка If-Match ETag отдаёт 412 Precondition Failed вместо 400.

Также встроены справочники систем кодирования: адреса для LOINC, SNOMED CT, RxNorm и ICD-10, плюс частые коды жизненных показателей. При работе с авторизацией скилл ориентируется на спецификацию SMART on FHIR и скоупы OAuth.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add anthropics/healthcare --skill fhir-developer-skill -a claude-code
```
```bash
npx skills add anthropics/healthcare --skill fhir-developer -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/fhir-developer/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/fhir-developer/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add anthropics/healthcare --skill fhir-developer -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/fhir-developer/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add anthropics/healthcare --skill fhir-developer -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/fhir-developer/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install anthropics/healthcare fhir-developer
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/fhir-developer/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add anthropics/healthcare --skill fhir-developer -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/anthropics/healthcare --path plugins/healthcare/skills/fhir-developer
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/fhir-developer/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add anthropics/healthcare --skill fhir-developer -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/anthropics/healthcare/tree/HEAD/plugins/healthcare/skills/fhir-developer/SKILL.md

## Когда брать
- настроить валидацию ресурсов FHIR R4 в FastAPI или Express
- сформировать корректный ответ OperationOutcome со статусом 422
- подключить медицинские системы кодирования LOINC, SNOMED и ICD-10
- разграничить обязательные и опциональные поля по кардинальности схемы

## Примеры запросов агенту
- Напиши эндпоинт POST /Observation на FastAPI с валидацией статуса и возвратом OperationOutcome при ошибке.
- Покажи модель Pydantic v2 для ресурса Patient с допустимыми значениями gender.
- Добавь обработку ETag для FHIR-эндпоинта с возвратом 412 Precondition Failed при несовпадении.

## Похожие
- [fastapi-developer](https://affpapa.org/nevibecode/agents/fastapi-developer.md) — субагент · ★ 26065
- [fastapi-python](https://affpapa.org/nevibecode/skills/fastapi-python.md) — скилл · 13900 установок
- [fastapi-patterns](https://affpapa.org/nevibecode/skills/fastapi-patterns.md) — скилл · 4900 установок
- [stripe-webhooks](https://affpapa.org/nevibecode/skills/stripe-webhooks.md) — скилл · 595 установок
- [api-smoke-testing](https://affpapa.org/nevibecode/skills/api-smoke-testing.md) — скилл · 495 установок
- [fastapi-development](https://affpapa.org/nevibecode/skills/fastapi-development.md) — скилл · 618 установок

Из того же набора: [anthropics/healthcare](https://affpapa.org/nevibecode/by/anthropics/healthcare.md) — 3 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md