fhir-developer-skill — скилл для Claude Code: что делает
Скилл помогает создавать медицинские REST API по стандарту FHIR R4: валидировать ресурсы, отдавать корректные статусы HTTP и работать с бандлами.
npx skills add anthropics/healthcare --skill fhir-developer-skill -a claude-code
npx skills add anthropics/healthcare --skill fhir-developer -a claude-codeЧто делает 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.
Какие задачи решает
- настроить валидацию ресурсов FHIR R4 в FastAPI или Express
- сформировать корректный ответ OperationOutcome со статусом 422
- подключить медицинские системы кодирования LOINC, SNOMED и ICD-10
- разграничить обязательные и опциональные поля по кардинальности схемы
Примеры запросов агенту
- Напиши эндпоинт POST /Observation на FastAPI с валидацией статуса и возвратом OperationOutcome при ошибке.
- Покажи модель Pydantic v2 для ресурса Patient с допустимыми значениями gender.
- Добавь обработку ETag для FHIR-эндпоинта с возвратом 412 Precondition Failed при несовпадении.
Как установить fhir-developer-skill
1Через Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill fhir-developer-skill -a claude-codenpx skills add anthropics/healthcare --skill fhir-developer -a claude-code2Вручную: положить файлы
~/.claude/skills/fhir-developer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/fhir-developer/
1Через Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill fhir-developer -a codex2Вручную: положить файлы
.agents/skills/fhir-developer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill fhir-developer -a cursor2Вручную: положить файлы
.cursor/skills/fhir-developer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install anthropics/healthcare fhir-developer2Вручную: положить файлы
.github/skills/fhir-developer/SKILL.md1Через Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill fhir-developer -a gemini-cli2Командой платформы
gemini skills install https://github.com/anthropics/healthcare --path plugins/healthcare/skills/fhir-developerВручную: положить файлы
.devin/skills/fhir-developer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add anthropics/healthcare --skill fhir-developer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о fhir-developer-skill
Как установить fhir-developer-skill в Claude Code?
Выполните команду npx skills add anthropics/healthcare --skill fhir-developer-skill -a claude-code. Также можно поместить инструкцию напрямую в файл ~/.claude/skills/fhir-developer/SKILL.md.
Что делает fhir-developer-skill?
Скилл даёт модели правила работы со спецификацией FHIR R4: схемы ключевых медицинских ресурсов, маппинг систем кодирования LOINC и SNOMED, проверку значений enum и стандарты обработки ошибок.
Какие поля считаются обязательными в ресурсах FHIR?
Обязательными признаются только атрибуты с кардинальностью от единицы (1..1 или 1..*). Если кардинальность поля 0..1 или 0..*, как у subject в Encounter, валидатор не должен требовать его присутствия.
