← 스킬 목록으로 돌아가기

fhir-resource-validator

v1.0.2 approved Knowledge 오늘 업데이트
USK v3 ✅ Verified ⚡ Auto-Convert
⬇ 다운로드
설치 가이드↓
🤖 에이전트용 설치 명령 (curl / MCP / Claude Desktop)
▸ curl 한 줄 다운로드
curl -L -o fhir-resource-validator.skill   "https://aiskillstore.io/v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=ClaudeCode"
▸ MCP 도구 호출 (Skill Store MCP 등록 시)
{
  "tool": "download_skill",
  "arguments": {
    "skill_id": "b043eead-bc1e-44a6-aed4-7444e366949d",
    "platform": "ClaudeCode"
  }
}
▸ Claude Desktop / Cursor MCP 설정 (1회)
{
  "mcpServers": {
    "skill-store": {
      "url": "https://aiskillstore.io/mcp/"
    }
  }
}
📖 에이전트용 전체 API 가이드: /llms.txt  ·  MCP server card

Offline FHIR R4 resource validation (Patient, Observation, Bundle, etc). Checks required fields, data types, and coding rules. Returns structured errors with fix hints. No live FHIR server required.

# fhir # healthcare # hl7 # medical # validation # r4

기본 정보

소유자 👤 aiskillstore-team 카테고리 Knowledge 등록일 2026-06-20 최종 업데이트 2026-06-20 최신 버전 1.0.2 패키지 날짜 2026-06-20 검증 상태 approved 다운로드 수 0회 체크섬 (SHA256) 089ead748d5bb69eee8d8024e5b6f59ee615ee89340757002ad8b241912ac332

⚡ AGENT INFO USK v3

Capabilities
fhir_validation healthcare_data r4_compliance ehr_integration medical_data_quality
Permissions
✗ network
✗ filesystem
✗ subprocess
Interface
type: cli   entry_point: main.py   runtime: python3   call_pattern: stdin_stdout
Agent API
# 스킬 스키마 조회 (에이전트가 호출 방법을 파악) GET /v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/schema # 플랫폼별 자동 변환 다운로드 GET /v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=OpenClaw GET /v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=ClaudeCode GET /v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=ClaudeCodeAgentSkill GET /v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=Cursor GET /v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=GeminiCLI GET /v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=CodexCLI GET /v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=CustomAgent

설치 방법

호환 플랫폼: any

1
openclaw_skill_manager.py로 스킬을 설치합니다.
python openclaw_skill_manager.py --install fhir-resource-validator
2
설치 확인
python openclaw_skill_manager.py --list-installed
3
특정 버전 설치 (선택)
python openclaw_skill_manager.py --install fhir-resource-validator --version 1.0.2
1
스킬 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download
2
Claude Code commands 디렉터리에 배치합니다.
unzip fhir-resource-validator.skill -d ~/.claude/commands/fhir-resource-validator/
3
Claude Code에서 슬래시 커맨드로 사용합니다.
/fhir-resource-validator
1
Agent Skills 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=ClaudeCodeAgentSkill
2
Claude Code skills 디렉터리에 압축을 해제합니다.
unzip fhir-resource-validator-agent-skill-*.skill -d ~/.claude/skills/fhir-resource-validator/
3
Claude Code를 재시작하면 세션 시작 시 자동으로 로드됩니다. 슬래시 커맨드 없이 자연어로 사용 가능합니다.
1
Cursor 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=Cursor
2
압축 해제 후 영구 위치에 저장합니다.
unzip fhir-resource-validator-cursor-*.skill -d ~/.cursor/skills/fhir-resource-validator/
3
.cursor/mcp.json에 MCP 서버 설정을 추가하고 Cursor를 재시작합니다.
cat ~/.cursor/skills/fhir-resource-validator/cursor_mcp_config.json
1
Gemini CLI 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=GeminiCLI
2
압축 해제 후 영구 위치에 저장합니다.
unzip fhir-resource-validator-geminicli-*.skill -d ~/.gemini/skills/fhir-resource-validator/
3
~/.gemini/settings.json에 MCP 서버 설정을 추가하고 Gemini CLI를 재시작합니다.
cat ~/.gemini/skills/fhir-resource-validator/gemini_settings_snippet.json
1
Codex CLI 변환 패키지를 다운로드합니다.
curl -O https://aiskillstore.io/v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download?platform=CodexCLI
2
압축 해제 후 영구 위치에 저장합니다.
unzip fhir-resource-validator-codexcli-*.skill -d ~/.codex/skills/fhir-resource-validator/
3
~/.codex/config.toml에 MCP 서버 설정을 추가하고 Codex CLI를 재시작합니다.
cat ~/.codex/skills/fhir-resource-validator/codex_config_snippet.toml
1
REST API로 스킬 패키지를 다운로드합니다.
GET https://aiskillstore.io/v1/skills/b043eead-bc1e-44a6-aed4-7444e366949d/download
2
에이전트 플랫폼의 skills 디렉터리에 배치합니다.
cp fhir-resource-validator.skill ./skills/
3
설치 가이드 API로 플랫폼별 상세 정보를 조회합니다.
GET https://aiskillstore.io/v1/skills/b043eead-bc1e-44a6-aed4-7444e366949d/install-guide?platform=CustomAgent

요구사항

보안 검증 보고서

검증 결과 APPROVED

✅ 보안 위험 항목이 발견되지 않았습니다.

AI 검수 단계

검수 주체 gemini 위험도 🟢 낮음 검수 요약 FHIR R4 리소스 유효성 검사 스킬로, 선언된 권한과 코드 내용이 일치하며 악의적인 동작이 발견되지 않았습니다.
판단 근거

1. **권한 일치**: 스킬 메타데이터에 `network: false`, `filesystem: false`, `subprocess: false`로 선언되어 있으며, 코드 분석 결과 외부 네트워크 통신, 임의의 파일 시스템 접근 또는 서브프로세스 실행 코드가 발견되지 않았습니다. `main.py`에서 `os.path.dirname(os.path.abspath(__file__))`를 사용하여 로컬 모듈을 임포트하는 경로를 설정하고, `lib/validator.py`에서 `pkgutil.iter_modules(fr.__path__)`를 사용하여 `fhir.resources` 패키지 내부의 리소스 타입을 탐색하는 것은 스킬 자체의 기능 구현을 위한 내부적인 파일 시스템 접근으로, 임의의 파일 접근이나 데이터 유출과는 무관하며 샌드박스 환경에서 일반적으로 허용되는 범위 내의 동작입니다. 2. **악의적 목적 없음**: 코드에 데이터 탈취, 시스템 파괴, 난독화 등 악의적인 목적을 가진 코드는 발견되지 않았습니다. 코드는 명확하고 가독성이 높습니다. 3. **외부 통신 없음**: 선언된 바와 같이 외부 네트워크 통신을 시도하는 코드가 없습니다. 4. **데이터 수집/전송 없음**: 스킬은 표준 입력(stdin)을 통해 FHIR 리소스 JSON을 받아 유효성 검사를 수행하고, 그 결과를 표준 출력(stdout)으로 반환합니다. 어떠한 사용자 데이터도 무단으로 수집하거나 외부로 전송하지 않습니다. 5. **코드 품질**: 코드는 FHIR R4 리소스 유효성 검사라는 스킬의 목적에 부합하며, `fhir.resources` 및 `pydantic` 라이브러리를 활용하여 명확하고 안정적으로 구현되었습니다. 오류 처리도 적절하게 이루어지고 있습니다. 6. **정적 분석 결과**: 제공된 정적 분석 결과에서도 어떠한 위험 요소나 플래그가 발견되지 않았습니다.

버전 히스토리

버전 USK v3 검증 상태 패키지 날짜 다운로드 변경사항
v1.0.2 approved 2026-06-20 ⬇ 0 [{"version": "1.0.2", "date": "2026-06-20", "notes": "spec field corrected to usk/1.0 for USK v3 native recognition. requirements and changelog fields added."}, {"version": "1.0.1", "date": "2026-06-20", "notes": "USK spec declaration added. requirements and changelog fields added for full compliance."}, {"version": "1.0.0", "date": "2026-06-20", "notes": "Initial release. FHIR R4 offline validation for Patient, Observation, Bundle, Condition, Medication and 70+ resource types."}]
v1.0.1 approved 2026-06-20 ⬇ 0 [{"version": "1.0.1", "date": "2026-06-20", "notes": "USK v3 spec declaration added. requirements and changelog fields added for full USK v3 compliance."}, {"version": "1.0.0", "date": "2026-06-20", "notes": "Initial release. FHIR R4 offline validation for Patient, Observation, Bundle, Condition, Medication and 70+ resource types."}]
v1.0.0 approved 2026-06-20 ⬇ 0
v1.0.0 approved 2026-06-20 ⬇ 0

사용 예시 (Examples) 7 개

이 스킬의 대표적인 입출력 예시입니다. 에이전트는 이 예시를 보고 스킬 호출 방법과 결과 형태를 이해할 수 있습니다.

Patient required-field missing
# validate# patient# ehr

Validate a Patient resource that has no 'name' — detects structural issues. (Data validation only, not medical advice.)

📥 입력
{
  "action": "validate",
  "resource": {
    "birthDate": "1985-06-15",
    "gender": "male",
    "id": "ex-001",
    "resourceType": "Patient"
  }
}
📤 출력
{
  "action": "validate",
  "errors": [],
  "resource_type": "Patient",
  "valid": true
}
Observation missing required code
# validate# observation# error-detection

Validate an Observation that omits the required 'code' field. Returns structured error with fix hint. (Data validation only, not medical advice.)

📥 입력
{
  "action": "validate",
  "resource": {
    "resourceType": "Observation",
    "status": "final",
    "subject": {
      "reference": "Patient/ex-001"
    }
  }
}
📤 출력
{
  "action": "validate",
  "errors": [
    {
      "fix_hint": "Add the required field \u0027code\u0027 to the resource.",
      "message": "Field required",
      "path": "Observation.code",
      "severity": "error"
    }
  ],
  "resource_type": "Observation",
  "valid": false
}
Bundle collection validation
# validate# bundle# ehr-pipeline

Validate a Bundle resource of type 'collection'. Confirms required 'type' field is present. (Data validation only.)

📥 입력
{
  "action": "validate",
  "resource": {
    "entry": [],
    "resourceType": "Bundle",
    "type": "collection"
  }
}
📤 출력
{
  "action": "validate",
  "errors": [],
  "resource_type": "Bundle",
  "valid": true
}
get_required_fields for Medication
# schema# medication# automation

Retrieve the field schema for Medication resource. Useful for prescription automation pipelines.

📥 입력
{
  "action": "get_required_fields",
  "resource_type": "Medication"
}
📤 출력
{
  "action": "get_required_fields",
  "fields": [
    {
      "name": "id",
      "required": false,
      "type": "\u003cclass \u0027str\u0027\u003e"
    },
    {
      "name": "code",
      "required": false,
      "type": "Optional[CodeableConcept]"
    }
  ],
  "required_count": 0,
  "resource_type": "Medication"
}
Unknown resource type error
# validate# error# unknown-type

Passing an unrecognized resourceType returns UNKNOWN_RESOURCE_TYPE error with actionable hint.

📥 입력
{
  "action": "validate",
  "resource": {
    "id": "bad-001",
    "resourceType": "SuperPatient"
  }
}
📤 출력
{
  "action": "validate",
  "errors": [
    {
      "fix_hint": "Use a valid FHIR R4 resource type such as Patient, Observation, Bundle, Condition, Medication, Encounter, DiagnosticReport.",
      "message": "Unknown FHIR R4 resource type: \u0027SuperPatient\u0027.",
      "path": "resourceType",
      "severity": "error"
    }
  ],
  "resource_type": "SuperPatient",
  "valid": false
}
EHR pipeline pre-send validation
# validate# condition# strict-mode# ehr-pipeline

Validate a Condition resource before transmitting to EHR system. Strict mode adds optional-field warnings. (Data validation only, not clinical assessment.)

📥 입력
{
  "action": "validate",
  "resource": {
    "clinicalStatus": {
      "coding": [
        {
          "code": "active",
          "system": "http://terminology.hl7.org/CodeSystem/condition-clinical"
        }
      ]
    },
    "code": {
      "coding": [
        {
          "code": "44054006",
          "display": "Type 2 diabetes mellitus",
          "system": "http://snomed.info/sct"
        }
      ]
    },
    "resourceType": "Condition",
    "subject": {
      "reference": "Patient/ex-001"
    }
  },
  "strict": true
}
📤 출력
{
  "action": "validate",
  "errors": [],
  "resource_type": "Condition",
  "valid": true,
  "warnings": [
    {
      "fix_hint": "Consider populating \u0027category\u0027 for richer FHIR compliance.",
      "message": "Optional field \u0027category\u0027 is absent.",
      "path": "Condition.category",
      "severity": "warning"
    }
  ]
}
list_resource_types
# discovery# resource-types

List all FHIR R4 resource types supported by the validator.

📥 입력
{
  "action": "list_resource_types"
}
📤 출력
{
  "action": "list_resource_types",
  "count": 74,
  "resource_types": [
    "Account",
    "Bundle",
    "Condition",
    "Medication",
    "Observation",
    "Patient"
  ]
}

모든 예시는 에이전트 API로도 조회 가능: /v1/agent/skills/b043eead-bc1e-44a6-aed4-7444e366949d/schema

리뷰 & 평점

아직 리뷰가 없습니다. 첫 번째 리뷰를 남겨보세요!

✍️ 리뷰 작성