fhir-validation

fhir-validation is a skill for Claude Code, Codex from sigistry/marketplace. It costs 103 tokens per session (1,084 once invoked), scanned A, original, MIT.

A set of instructions for validating FHIR R4 healthcare records, profiles, and Implementation Guide examples, including output created by AI tools. FHIR is a standard for exchanging healthcare data.

In plain words
What is it for?
Use it to validate files or directories, interpret OperationOutcome and StructureDefinition errors, map problems to FSH source, and run controlled validation loops.
Why use it?
It helps explain conformance problems, trace them back to source definitions, and perform safe correction and rechecking while protecting clinical data.

Skill for Claude CodeCodex

Written for Claude Code and Codex: ${CLAUDE_PLUGIN_ROOT} variable, but also agents/openai.yaml present. Also seen: mentions Claude Code; mentions Codex; $skill-name invocation.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the records plugin — 3 skills, 5 commands, 1 agent shipped together

Good fit Use it to validate files or directories, interpret OperationOutcome and StructureDefinition errors, map problems to FSH source, and run controlled validation loops.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add sigistry/marketplace
Claude Code
/plugin install records

Made for: Claude Code, Codex.

Or install records, the plugin that ships this one along with the rest of its 3 skills, 5 commands, 1 agent.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for fhir-validation

README.md
[![agentmods](https://agentmods.dev/badge/skills/sigistry/marketplace/fhir-validation/github.svg)](https://agentmods.dev/skills/sigistry/marketplace/fhir-validation)
Your own site
<a href="https://agentmods.dev/skills/sigistry/marketplace/fhir-validation"><img src="https://agentmods.dev/badge/skills/sigistry/marketplace/fhir-validation/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for fhir-validation

Your own site · 80×15
<a href="https://agentmods.dev/skills/sigistry/marketplace/fhir-validation"><img src="https://agentmods.dev/badge/skills/sigistry/marketplace/fhir-validation.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 103 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,084 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00103 $0.01084
Opus 5 $0.00051 $0.00542
Sonnet 5 $0.00021 $0.00217
Haiku 4.5 $0.00010 $0.00108

Measured 6d ago against content hash 7aac5edc8e96, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

fhir-validation scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

The scan reads SKILL.md. This mod also ships 23 executable files (scripts/analyze-structuredefinition.mjs, scripts/derive-quality-rules.mjs, scripts/detect-fhir-project.mjs, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/records/skills/fhir-validation/SKILL.md · 88 lines

How it starts

The opening of the file, as written. The whole thing — 88 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Records FHIR Validation

Validate FHIR resources with Records and local project tooling. Prefer local or already configured execution. Do not send clinical data, patient data, FHIR server URLs, or full patient resources to external services unless the user explicitly consents for this task.

Arguments

Treat the user request as a file, directory, JSON resource, OperationOutcome, FHIR URL, or validation goal. If no target is inferable, ask one concise question.

Bundled Paths

Resolve <skill-root> to the absolute directory containing this SKILL.md. Resolve <plugin-root> two directories above <skill-root>. In Claude Code ${CLAUDE_PLUGIN_ROOT} is also the plugin root; in Codex derive it from the installed skill path. Never resolve bundled scripts relative to the user's workspace.

Fast Start

For file or directory validation, first run the deterministic detector and runtime planner when available:

node "<skill-root>/scripts/detect-fhir-project.mjs" <target-or-repo>
node "<skill-root>/scripts/plan-runtime.mjs" <target-or-repo>

Use their output to pick source directories, generated directories, available runtimes, privacy gates, and validation order.

Then choose the first suitable mode:

  1. Records MCP tools, when available.
  2. Records API, only when RECORDS_API_URL is configured and the privacy boundary is acceptable.
  3. Records CLI, using records validate-file <target>.
  4. Existing local profile-aware validators such as SUSHI, IG Publisher, Firely Terminal, Java validator, or HAPI when already configured and relevant.
  5. Structural fallback via scripts/validate-structural.mjs (scope), clearly labeled as not profile-, terminology-, invariant-, or reference-aware.

Privacy Gates

Ask for explicit consent before fetching FHIR URLs, contacting FHIR servers, sending resources to external APIs, installing validators, or using hosted/non-local validation on data that may contain PHI. Prefer local CLI validation. In summaries, include paths, issue codes, and minimal snippets; do not reproduce complete Patient resources or unnecessary identifiers.

Read the full file on GitHub · 88 lines

Files

What ships with it

32 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 88 lines · 103 tokens per session scan A 7aac5edc8e96

Subscribe to this mod's changes

fhir-validation is a skill published in the GitHub repository sigistry/marketplace (3 stars, last pushed 6d ago), licensed MIT. It adds 103 tokens to every session and 1,084 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

architecture-optimization

Guided journey from a working codebase grown slow and tangled to one measurably fast, cleanly bounded, and readable. Orchestrates eight skills phase by phase - working-with-legacy-code, clean-architecture, software-design-philosophy, refactoring-patterns, system-design, ddia-systems, release-it, pragmatic-programmer …

wondelai/skills · 226 tokens

improve-code-quality

Guided journey from a working-but-untested vibe-coded prototype to a production-ready product with tests, clean structure, a business-rules boundary, and resilience at scale. Orchestrates nine skills phase by phase - working-with-legacy-code, clean-code, refactoring-patterns, software-design-philosophy…

wondelai/skills · 227 tokens

remove-technical-debt

Guided journey from a large aged codebase everyone fears to touch to one that is safe to change, legible, bounded, and resilient - paid down in place without a rewrite. Orchestrates eight skills phase by phase - working-with-legacy-code, refactoring-patterns, clean-code, software-design-philosophy, clean-architecture…

wondelai/skills · 224 tokens

release-it

Build production-ready systems with stability patterns: circuit breakers, bulkheads, timeouts, and retry logic. Use when the user mentions "production outage", "circuit breaker", "deployment pipeline", "chaos engineering", "retry storm", "health checks", "my service keeps crashing", "prevent cascading failures", or…

wondelai/skills · 131 tokens

ask-codex

Consult OpenAI Codex for investigation, debugging, or code review. Use when user explicitly asks to "ask codex", "check with codex", "codex review", or as a last resort when stuck after 4+ failed attempts at debugging, investigation, or bug fix and completely out of ideas. Codex is slow (2-5 min), so only escalate…

umputun/cc-thingz · 103 tokens

verify

Verify Elixir/Phoenix changes — compile, format, and test in one loop. Use after implementation, before PRs, or after fixing bugs.

oliver-kriska/claude-elixir-phoenix · 33 tokens