Claude Code skills · updated 2026-10-03

FHIR US Core skill for Claude Code — USCDI v3 profile pins and Patient gaps

9 US Core findings in one FHIR Bundle, with file:line and the version needed

On the bundled sample: 9 findings (6 errors, 3 warnings) in 1 file from 10 rules, including a us-core-patient|3.1.1 pin.

Get it on Whop - $12 onceGet it on Gumroad

Who it's for

FHIR developers at EHR and health IT vendors moving resources, Bundles and test fixtures to US Core 6.1.0.

What breaks, and when

Certified health IT has had to carry USCDI v3 since 2026-01-01. A profile pinned to US Core 3.1.1 or 5.0.1 claims the USCDI v1 or v2 element set, and a Patient without us-core-genderIdentity misses an element USCDI v3 added.

What it printed on the bundled example

== US Core Profile Gap Check (USCDI v3) — 9 findings (6 errors, 3 warnings) in 1 file · 10 rules
  ERROR uscore-sample.json:15  [uscore_v1_pin]
        Profile pinned to US Core 3.1.1 - that is the USCDI v1 element set. Certified health IT has had to carry USCDI v3 since 2026-01-01. (us-core-patient|3.1.1 -> needs 6.1.0) USCDI v3 line passed 275 days ago.
  ERROR uscore-sample.json:43  [uscore_v2_pin]
        Profile pinned to US Core 5.0.1 - that is the USCDI v2 element set. USCDI v3 needs US Core 6.1.0 or above. (us-core-condition|5.0.1 -> needs 6.1.0) USCDI v3 line passed 275 days ago.
  WARN  uscore-sample.json:55  [unpinned_profile]
        US Core profile claimed with no |version. Nothing in this file proves which USCDI version you meet at test time. (us-core-observation-lab)
  ERROR uscore-sample.json:68  [pre_r4_url]
        DSTU2 or STU3 artefact in an R4 resource set. US Core 6.1.0 is FHIR R4 (4.0.1) only. USCDI v3 line passed 275 days ago.

What you get

• SKILL.md, an offline Node scanner and the 10-rule table
• file:line and the version or extension needed
• Edits applied only after you agree
• CI: node scripts/scan.js . exits 1 on any error

Install

Unzip into ~/.claude/skills/ (all projects) or your-repo/.claude/skills/ (one repo), then ask Claude Code: "Check the FHIR JSON in this repo for anything that would not meet USCDI v3. Don't edit anything yet.". Needs Node 16+.

unzip fhir-us-core-profile-check.zip -d ~/.claude/skills/

Ask Claude

“Check the FHIR JSON in this repo for anything that would not meet USCDI v3. Don't edit anything yet.”

What it does not do

Not a FHIR validator: no StructureDefinition, cardinality or value-set checks, no server calls, no edits without your OK.

FAQ

What is a Claude Code skill?

A folder with a SKILL.md and scripts that Claude Code loads when your request matches it. You ask in plain words and Claude runs the scanner the skill carries.

How is this different from asking Claude without the skill?

The skill carries a dated rule table and a scanner that reads every file, so Claude quotes the exact date and line instead of answering from memory.

Does it send my code anywhere?

Not a FHIR validator: no StructureDefinition, cardinality or value-set checks, no server calls, no edits without your OK.

How do I install it?

Unzip into ~/.claude/skills/ (all projects) or your-repo/.claude/skills/ (one repo), then ask Claude Code: "Check the FHIR JSON in this repo for anything that would not meet USCDI v3. Don't edit anything yet.". Needs Node 16+.

What do I get when I buy?

The zip. On Whop it is in your library as a download lesson with the zip attached; on Gumroad it is the product file.