PranavNagrecha/AwesomeSalesforceSkills / skills/admin/clinical-data-requirements
clinical-data-requirements
VerifiedUse this skill when defining clinical data model requirements for Health Cloud: HL7/FHIR data mapping, interoperability requirements, FHIR R4-aligned object activation, CodeableConcept constraints, and middleware translation requirements. NOT for the field-level mapping work itself — use data/fhir-data-mapping. NOT for choosing legacy HC24__ EHR objects vs standard clinical objects — use data/health-cloud-data-model.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.6 KB |
| references/examples.md | markdown | 5.7 KB |
| references/gotchas.md | markdown | 7.9 KB |
| references/llm-anti-patterns.md | markdown | 5.9 KB |
| references/metadata-examples.md | markdown | 4.4 KB |
| references/well-architected.md | markdown | 4.7 KB |
| scripts/check_clinical_data_requirements.pyexecutable | script | 4.4 KB |
| templates/clinical-data-requirements-template.md | markdown | 2.3 KB |
scripts/check_clinical_data_requirements.py
View on GitHub#!/usr/bin/env python3
"""Checker script for Clinical Data Requirements skill.
Checks org metadata for common clinical data model issues:
- Legacy EHR object usage in Flows and Apex
- FHIR R4-aligned object references
- CodeableConcept field patterns
Uses stdlib only — no pip dependencies.
Usage:
python3 check_clinical_data_requirements.py [--help]
python3 check_clinical_data_requirements.py --manifest-dir path/to/metadata
"""
from __future__ import annotations
import argparse
import sys
from pathlib import Path
def parse_args() -> argparse.Namespace:
parser = argparse.ArgumentParser(
description="Check clinical data model configuration for common issues.",
)
parser.add_argument(
"--manifest-dir",
default=".",
help="Root directory of the Salesforce metadata (default: current directory).",
)
return parser.parse_args()
# Legacy packaged EHR objects and their FHIR R4-aligned standard counterparts, from the Health
# Cloud developer guide (Spring '23 legacy statement). Earlier versions listed objects that do
# not exist in the guide (`HC24__EhrMedication__c`, `HC24__EhrLabResult__c`) and invented
# replacements (`PatientMedication`, `MedicalProcedure`). Corrected 2026-10-03.
FHIR_ALIGNED_REPLACEMENTS = {
"HC24__EhrCondition__c": "HealthCondition",
"HC24__EhrMedicationStatement__c": "MedicationStatement",
"HC24__EhrMedicationPrescription__c": "MedicationRequest",
"HC24__EHRProcedure__c": "PatientMedicalProcedure",
"HC24__EhrObservation__c": "CareObservation",
"HC24__EhrImmunization__c": "PatientImmunization",
"HC24__EhrAllergyIntolerance__c": "AllergyIntolerance",
}
LEGACY_EHR_OBJECTS = list(FHIR_ALIGNED_REPLACEMENTS)
def check_legacy_ehr_object_usage(manifest_dir: Path) -> list[str]:
"""Check for legacy HC24__ EHR object references in Flows and classes."""
issues: list[str] = []
for search_dir in ["flows", "classes", "triggers"]:
dir_path = manifest_dir / search_dir
if not dir_path.exists():
continue
extensions = {"flows": "*.flow-meta.xml", "classes": "*.cls", "triggers": "*.trigger"}
pattern = extensions.get(search_dir, "*")
for file_path in dir_path.glob(pattern):
content = file_path.read_text(encoding="utf-8")
for legacy_obj in LEGACY_EHR_OBJECTS:
if legacy_obj in content:
replacement = FHIR_ALIGNED_REPLACEMENTS.get(legacy_obj, "FHIR R4-aligned standard object")
issues.append(
f"{file_path.name}: References legacy EHR object '{legacy_obj}'. "
f"New Health Cloud orgs (Spring '23+) cannot write to this object. "
f"Use '{replacement}' instead."
)
return issues
def check_fhir_aligned_objects_presence(manifest_dir: Path) -> list[str]:
"""Check for presence of FHIR R4-aligned clinical objects."""
issues: list[str] = []
objects_dir = manifest_dir / "objects"
if not objects_dir.exists():
return issues
fhir_objects = ["HealthCondition", "CareObservation", "PatientImmunization", "AllergyIntolerance"]
present = {d.name for d in objects_dir.iterdir() if d.is_dir()}
found = [obj for obj in fhir_objects if obj in present]
if not found:
issues.append(
"No FHIR R4-aligned clinical objects found in objects/ directory. "
"If clinical data is in scope, verify FHIR R4 Support Settings are enabled in Setup "
"and that clinical objects are included in the metadata retrieval."
)
return issues
def check_clinical_data_requirements(manifest_dir: Path) -> list[str]:
"""Return a list of issue strings found in the manifest directory."""
issues: list[str] = []
if not manifest_dir.exists():
issues.append(f"Manifest directory not found: {manifest_dir}")
return issues
issues.extend(check_legacy_ehr_object_usage(manifest_dir))
issues.extend(check_fhir_aligned_objects_presence(manifest_dir))
return issues
def main() -> int:
args = parse_args()
manifest_dir = Path(args.manifest_dir)
issues = check_clinical_data_requirements(manifest_dir)
if not issues:
print("No issues found.")
return 0
for issue in issues:
print(f"WARN: {issue}", file=sys.stderr)
return 1 if issues else 0
if __name__ == "__main__":
sys.exit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |