Healthcare Agents

Healthcare administration support, from a messy problem to a reviewable artifact.

This is the v2.0.0-beta.1 development candidate. It adds six deep workflows, compact skills, a custom workflow builder and repeatable aggregate calculations. Publication and customer cloud-host qualification are pending; the prepared POSIX Codex profile has bounded native qualification recorded below; npx healthcare-agents from the public registry does not yet deliver this candidate.

The picture is generated from the committed synthetic case and the actual local calculation. These are invented demonstration data, not patient records or measured customer outcomes.

Start with a task

Use the Healthcare Agents skill in an approved agent environment:

Investigate the denial-rate increase. Use the supplied aggregate reports, identify evidence gaps, and draft an owner-led recovery plan.

The host model develops the administrative artifact. The local CLI routes tasks, validates workflow contracts and calculates supported aggregate quantities; it does not call a model or execute an operational workflow.

For this checked-out candidate:

npm ci --ignore-scripts
node bin/cli.js workup "Commercial payer denial rate jumped" --workflow denial-spike-workup --json
node bin/cli.js admin run examples/admin-v2/denial-spike-workup.json

Use synthetic or approved aggregate evidence. This package is not a PHI-processing environment and does not make final clinical, legal, coding, billing, audit or compliance authority.

Six deep workflows

Task	Useful artifact	Local calculation
Denial spike	Cohort comparison, hypotheses, evidence pulls and recovery owners	Baseline/current rates, percentage points and relative change
Ambulatory access	Demand/capacity scenario and monitored access plan	Shortfall, net weekly capacity and backlog clearance scenario
Survey evidence	Standard-to-evidence gap register and retest plan	Missing-evidence counts; no compliance certification
Prior authorization appeal	Source-linked administrative packet and document gap map	Supplied calendar window and missing documents
Underpayment	Contract-linked variance register	USD line/net variance, with overpayments retained
Discharge barriers	Aggregate barrier owners and dependencies	Supplied barrier counts and reported avoidable days

Each contract contains domain checks, evidence requirements, decisions and an observable completion gate. See the catalog and case contract. All six have committed synthetic examples and independently specified expected arithmetic in the regression suite.

The existing 51 specialists and 16 workups remain available. Compact role briefs load only the chosen role; detailed original prompts remain optional references. Free-text choose/workup calls offer discovery candidates without selecting a primary specialist or executable workup. The user or host interprets intent, negation, completed work and multiple goals, then supplies validated IDs or a structured selection. Explicit multi-selections retain every workstream. Routing authority and migration documents the deliberate change from lexical auto-selection; routing scores remain discovery heuristics.

Specialist coverage

51 specialists across 10 administrative domains remain available on demand.

Domain	Specialists
Clinical Operations	8
Emergency Preparedness	1
Health IT & Informatics	6
Operations & Administration	7
Payer & Managed Care	6
Pharmacy Programs	2
Population Health & Community Health	3
Quality, Safety & Compliance	7
Revenue Cycle & Finance	6
Strategy & Advisory	5

Build your own workflow

Define the outcome, specialist, human owner, evidence fields and acceptance criteria. Use the example or the builder skill.

node bin/cli.js admin validate workflows/admin-v2/custom-example.json
node bin/cli.js admin build workflows/admin-v2/custom-example.json --output ./community-workflow

The new directory contains SKILL.md, a detailed reference, a source-attributed case template and a hash manifest. Existing output directories are refused. Custom workflows are instruction packs; the builder does not invent executable formulas, install services or grant external-action authority. A valid contract still needs task-level behavioral evaluation.

Customer deployment surfaces

node bin/cli.js admin export codex denial-spike-workup --output ./codex-denials
node bin/cli.js admin export azure denial-spike-workup --output ./azure-denials

Host	Delivered surface	Qualification
Codex	Skills, portable plugin manifests and local stdio MCP	Actual packaged-server client tests; pinned native MCP campaign receipt separate
Claude	Skills and correlated Messages client-tool callback	Local callback/contract tests; live Claude pending
ChatGPT	Plugin manifests and local MCP transport	Local protocol/packaging tested; remote web connection pending
Azure / Microsoft Foundry	Instructions and Responses function callback	Local bridge tested; SDK/model/tenant deployment pending
Databricks	Instructions and Chat Completions callback	Local bridge tested; hosted ResponsesAgent and tenant