{"id":48085257,"url":"https://github.com/ajhcs/healthcare-agents","last_synced_at":"2026-05-05T23:01:38.139Z","repository":{"id":345425841,"uuid":"1185818410","full_name":"ajhcs/healthcare-agents","owner":"ajhcs","description":"51 specialized AI agents for US healthcare administration. MHA-level expertise in revenue cycle, compliance, quality, clinical ops, payer relations, health IT, and more. Modeled after agency-agents.","archived":false,"fork":false,"pushed_at":"2026-04-09T21:33:31.000Z","size":2298,"stargazers_count":17,"open_issues_count":4,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-09T23:14:37.074Z","etag":null,"topics":["agents-md","ai-agents","ai-prompts","claude-code","copilot-instructions","cursor-rules","healthcare","healthcare-administration","healthcare-ai","healthcare-ai-agent"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ajhcs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-19T01:12:35.000Z","updated_at":"2026-04-09T21:33:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ajhcs/healthcare-agents","commit_stats":null,"previous_names":["ajhcs/healthcare-agents"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ajhcs/healthcare-agents","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajhcs%2Fhealthcare-agents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajhcs%2Fhealthcare-agents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajhcs%2Fhealthcare-agents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajhcs%2Fhealthcare-agents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ajhcs","download_url":"https://codeload.github.com/ajhcs/healthcare-agents/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajhcs%2Fhealthcare-agents/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32204712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T00:06:41.111Z","status":"ssl_error","status_checked_at":"2026-04-24T00:06:35.224Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents-md","ai-agents","ai-prompts","claude-code","copilot-instructions","cursor-rules","healthcare","healthcare-administration","healthcare-ai","healthcare-ai-agent"],"created_at":"2026-04-04T15:14:13.317Z","updated_at":"2026-05-05T23:01:38.131Z","avatar_url":"https://github.com/ajhcs.png","language":"Python","funding_links":[],"categories":["Ecosystem","Multi-Agent Medical Systems"],"sub_categories":["Quick Setup with cc-safe-setup"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/healthcare-agents-hero.png\" alt=\"Healthcare Agents command center showing specialist agents across revenue cycle, compliance, quality, clinical operations, payer, health IT, population health, pharmacy, strategy, and emergency preparedness workflows\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eHealthcare Agents\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e51 specialist AI agents for US healthcare administration.\u003c/strong\u003e\u003cbr\u003e\n  Installable prompts and skills for Claude Code, Codex, OpenCode, Cursor, Copilot, and other agentic coding tools.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#install\"\u003e\u003cimg src=\"https://img.shields.io/badge/install-curl%20%7C%20github--npx-success?style=flat-square\" alt=\"Install with curl or GitHub npx\"\u003e\u003c/a\u003e\n  \u003ca href=\"#agent-catalog\"\u003e\u003cimg src=\"https://img.shields.io/badge/agents-51-blue?style=flat-square\" alt=\"51 agents\"\u003e\u003c/a\u003e\n  \u003ca href=\"#eval-status\"\u003e\u003cimg src=\"https://img.shields.io/badge/eval-51%2F51%20improved-brightgreen?style=flat-square\" alt=\"51 of 51 agents improved\"\u003e\u003c/a\u003e\n  \u003ca href=\"#supported-tools\"\u003e\u003cimg src=\"https://img.shields.io/badge/Claude%20%7C%20Codex%20%7C%20OpenCode%20%7C%20Cursor-compatible-8A2BE2?style=flat-square\" alt=\"Claude, Codex, OpenCode, and Cursor compatible\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/ajhcs/healthcare-agents/releases/tag/v1.2.0\"\u003e\u003cimg src=\"https://img.shields.io/badge/version-1.2.0-blue?style=flat-square\" alt=\"v1.2.0\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-Apache%202.0-green?style=flat-square\" alt=\"Apache 2.0 license\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003e51\u003c/strong\u003e\u003cbr\u003e\u003csub\u003ehealthcare specialists\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003e10\u003c/strong\u003e\u003cbr\u003e\u003csub\u003eadministrative domains\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003e95.50\u003c/strong\u003e\u003cbr\u003e\u003csub\u003eavg final-pass score\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003eRouting + SKILL.md\u003c/strong\u003e\u003cbr\u003e\u003csub\u003eusable agent formats\u003c/sub\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\nHealthcare Agents is a model-agnostic prompt library for healthcare administration work: revenue cycle, quality and compliance, clinical operations, payer relations, health IT, population health, pharmacy programs, operations, strategy, and emergency preparedness.\n\nEach agent is a long-form Markdown specialist with YAML frontmatter, role-specific source awareness, compliance boundaries, operational workflows, concrete deliverable templates, best-input guidance, output modes, and cross-agent handoff rules. The pack installs into tools that support subagents, custom instructions, repository rules, or `SKILL.md` folders.\n\n## TL;DR\n\n| You need | Healthcare Agents gives you |\n|---|---|\n| Healthcare-specific agent behavior | 51 narrow specialists instead of one generic \"healthcare assistant.\" |\n| Easier agent selection | Task-based chooser docs, starter prompts, output modes, and handoff maps. |\n| Practical administrative output | Appeal packets, audit binders, gap analyses, dashboards, charters, payer matrices, readiness plans, and workflow checklists. |\n| Better regulatory handling | Role-aware references to HIPAA, CMS, OIG, HEDIS, Stars, MIPS/QPP, HRSA 340B, NHSN, TEFCA, HL7/FHIR, X12, and other domain sources. |\n| Portable installation | Claude Code agents, Claude/OpenCode skills, Codex agent prompts, Cursor/Windsurf/Copilot rules, Aider context, and plain Markdown. |\n| Prompt quality controls | An included self-improvement kit with a frozen rubric, role baselines, scorer guidance, and append-only eval results. |\n\nThese agents are for healthcare administration support. They are not clinicians, attorneys, auditors, coders of record, billing authorities, or a safe PHI-processing environment.\n\n## Install\n\nFast path:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/ajhcs/healthcare-agents/main/install.sh | bash\n```\n\nGitHub-backed `npx`:\n\n```bash\nnpx --yes github:ajhcs/healthcare-agents install\n```\n\nThe package metadata is ready for npm, but the package is not currently published to the npm registry from this environment. Use the GitHub-backed `npx` command above.\n\nTarget a specific tool:\n\n| Runtime | Command |\n|---|---|\n| Claude Code subagents | `npx --yes github:ajhcs/healthcare-agents install --claude` |\n| Claude Skills, Claude Desktop, Claude Cowork | `npx --yes github:ajhcs/healthcare-agents install --claude-skills` |\n| Codex CLI / Codex App | `npx --yes github:ajhcs/healthcare-agents install --codex` |\n| OpenCode skills | `npx --yes github:ajhcs/healthcare-agents install --opencode` |\n| Open Agent Skills convention | `npx --yes github:ajhcs/healthcare-agents install --agent-skills` |\n| Cursor rules | `npx --yes github:ajhcs/healthcare-agents install --cursor` |\n| Windsurf rules | `npx --yes github:ajhcs/healthcare-agents install --windsurf` |\n| GitHub Copilot instructions | `npx --yes github:ajhcs/healthcare-agents install --copilot` |\n| All known targets | `npx --yes github:ajhcs/healthcare-agents install --all` |\n\nPreview before writing files:\n\n```bash\nnpx --yes github:ajhcs/healthcare-agents install --all --dry-run\n```\n\nUpdate existing installs:\n\n```bash\nnpx --yes github:ajhcs/healthcare-agents install --all --force\n```\n\nUninstall:\n\n```bash\nnpx --yes github:ajhcs/healthcare-agents uninstall --all\n```\n\n## Choose the Right Agent\n\nStart with the task, not the agent name. Use the [agent selection guide](docs/usage/agent-selection-guide.md) when you know the operational problem, the [starter prompts](docs/usage/starter-prompts.md) when you want copy-ready examples, and the [handoff map](docs/usage/handoff-map.md) when the request spans departments.\n\nEvery agent now supports four output modes:\n\n| Ask for | When to use it |\n|---|---|\n| `quick triage` | Symptoms, weak data, or first-pass root cause analysis |\n| `workplan` | Owners, sequence, dependencies, KPIs, and timeline |\n| `audit/checklist` | Evidence requests, pass/fail criteria, remediation owners |\n| `artifact/template` | A draft work product with assumptions and placeholders |\n\nCommon starting points:\n\n| You need | Start with |\n|---|---|\n| Clean claim or denial problem | `revenue-cycle-specialist` |\n| Survey readiness | `quality-accreditation-specialist` |\n| Prior authorization delays | `clinical-prior-authorization-specialist` |\n| ED boarding or capacity issue | `operations-hospital-administrator` |\n| Interface or FHIR issue | `healthit-interoperability-engineer` |\n| Value-based care performance | `payer-value-based-care-manager` |\n| Safety event or RCA | `quality-patient-safety-officer` |\n| CHNA or community benefit | `pophealth-community-health-coordinator` |\n\n## Quick Examples\n\nClaude Code:\n\n```text\nUse the revenue-cycle-specialist agent in quick triage mode to diagnose why our clean claim rate dropped, then list coding, contract, and prior authorization handoffs.\n```\n\nCodex:\n\n```text\nRead the quality-compliance-officer healthcare agent and use audit/checklist mode to draft a HIPAA Security Rule evidence checklist for a small clinic.\n```\n\nOpenCode:\n\n```text\nUse the revenue-contract-analyst skill to model payer contract underpayment risk from a sample allowed-amount table.\n```\n\nRules-based tools:\n\n```text\nUsing the healthit-interoperability-engineer instructions, review this HL7v2 interface mapping for common ADT and ORU risks.\n```\n\nManual project install:\n\n```bash\ngit clone https://github.com/ajhcs/healthcare-agents.git\nmkdir -p .claude/agents\ncp healthcare-agents/agents/*.md .claude/agents/\n```\n\n## Why Use This\n\n| Generic healthcare prompting | Healthcare Agents |\n|---|---|\n| \"Follow HIPAA.\" | Separates Privacy Rule, Security Rule, Breach Notification, minimum necessary, BAAs, operational evidence, and escalation boundaries. |\n| \"Improve revenue.\" | Uses CARC/RARC, 837/835, charge capture, CDM, denial prevention, payer contracts, 340B, coding, and cost-report mechanics. |\n| \"Check quality.\" | Distinguishes HEDIS, MIPS/QPP, Stars, CAHPS/HCAHPS, accreditation, patient safety, infection prevention, and QI methodology. |\n| \"Analyze healthcare data.\" | Names FHIR, HL7v2, X12, C-CDA, Epic Caboodle/Cogito, USCDI, TEFCA, eCQMs, registries, and data-lineage controls. |\n| \"Make an operational plan.\" | Produces healthcare-specific work products: appeal packets, readiness binders, staffing models, audit trails, gap analyses, and KPI dashboards. |\n\n## Supported Tools\n\n```mermaid\nflowchart LR\n  A[\"agents/*.md\u003cbr/\u003esource prompts\"] --\u003e B[\"Claude Code\u003cbr/\u003e~/.claude/agents\"]\n  A --\u003e C[\"Codex\u003cbr/\u003e~/.codex/agents + AGENTS.md\"]\n  A --\u003e D[\"Rules folders\u003cbr/\u003eCursor · Windsurf · Copilot\"]\n  A --\u003e E[\"Generated SKILL.md\"]\n  E --\u003e F[\"Claude Skills\u003cbr/\u003eDesktop · Cowork\"]\n  E --\u003e G[\"OpenCode Skills\"]\n  E --\u003e H[\"Open Agent Skills\u003cbr/\u003e.agents/skills\"]\n```\n\n| Tool / Standard | Install Target | Notes |\n|---|---|---|\n| Claude Code subagents | `~/.claude/agents/*.md` | Source prompts use lowercase hyphen `name` values matching filenames. |\n| Claude Skills | `~/.claude/skills/\u003cslug\u003e/SKILL.md` | Generated skill wrappers include `name`, `description`, `license`, and `compatibility`. |\n| Claude Desktop / Claude Cowork | Claude-compatible skills | Use `--claude-desktop`, `--claude-cowork`, or `--claude-skills`. |\n| Codex CLI / Codex App | `~/.codex/agents/*.md` plus `~/.codex/AGENTS.md` | Installer adds a managed discovery block telling Codex how to choose specialists, use output modes, and name handoffs. |\n| OpenCode | `~/.config/opencode/skills/\u003cslug\u003e/SKILL.md` | Matches OpenCode's skill directory conventions. |\n| Open Agent Skills | `~/.agents/skills/\u003cslug\u003e/SKILL.md` | Portable fallback for tools that scan a common `.agents/skills` layout. |\n| Cursor | `.cursor/rules/*.md` | Installs the same Markdown prompts as project rules. |\n| Windsurf | `.windsurf/rules/*.md` | Installs the same Markdown prompts as project rules. |\n| GitHub Copilot | `.github/instructions/*.md` | Rename to `.instructions.md` if your Copilot setup requires that extension. |\n| Gemini CLI | `~/.gemini/agents/*.md` | Installs Markdown agent files globally. |\n| Cline | `.clinerules/*.md` | Installs prompt files into project rules. |\n| Amazon Q Developer | `.amazonq/rules/*.md` | Installs prompt files into project rules. |\n| Continue.dev | `.continue/*.md` | Installs prompts as reusable context files. |\n| Aider | `.aider.conf.yml` managed `read:` block | Adds all agent prompts as read-only context entries. |\n\n## Agent Catalog\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cstrong\u003eStrategy \u0026 Advisory\u003c/strong\u003e - 5 agents\u003c/summary\u003e\n\n| Agent | Specialty |\n|---|---|\n| `strategy-healthcare-consultant` | Service line planning, M\u0026A, market analysis, CON strategy |\n| `strategy-operations-consultant` | Lean/Six Sigma, throughput, benchmarking, predictive operations |\n| `strategy-clinical-operations-consultant` | Clinical workflows, staffing models, ED/OR throughput |\n| `strategy-structural-improvement-consultant` | Org redesign, governance, change management, post-merger integration |\n| `strategy-actuarial-advisor` | Risk adjustment, capitation, IBNR, MLR, actuarial caveats |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClinical Operations\u003c/strong\u003e - 8 agents\u003c/summary\u003e\n\n| Agent | Specialty |\n|---|---|\n| `clinical-utilization-management-specialist` | Medical necessity, status, notices, InterQual/MCG boundaries |\n| `clinical-care-management-specialist` | Care coordination, TCM/CCM, readmission prevention, SDOH |\n| `clinical-research-coordinator` | IRB, ICH-GCP E6(R3), 21 CFR Part 11, trial operations |\n| `clinical-documentation-improvement-specialist` | CDI queries, CC/MCC capture, DRG optimization |\n| `clinical-prior-authorization-specialist` | PA workflows, appeals, ePA, payer/state variation |\n| `clinical-referral-specialist` | Referral management, network navigation, care gap closure |\n| `clinical-case-manager` | Discharge planning, post-acute placement, LOS optimization |\n| `clinical-infection-prevention-specialist` | NHSN, HAI surveillance, stewardship, outbreak response |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eQuality, Safety \u0026 Compliance\u003c/strong\u003e - 7 agents\u003c/summary\u003e\n\n| Agent | Specialty |\n|---|---|\n| `quality-improvement-specialist` | HEDIS, MIPS/QPP, Stars, eCQMs, SPC, Baldrige |\n| `quality-process-improvement-analyst` | PDSA, Lean, Six Sigma DMAIC, capability/takt math |\n| `quality-patient-experience-coordinator` | CAHPS/HCAHPS, service recovery, grievance escalation |\n| `quality-patient-safety-officer` | Sentinel events, RCA2, HFMEA, Just Culture, PSO boundaries |\n| `quality-compliance-officer` | HIPAA, Stark, AKS, FCA, OIG, EMTALA, CIA evidence |\n| `quality-risk-manager` | ERM, malpractice, claims, CRP, NPDB/state reporting boundaries |\n| `quality-accreditation-specialist` | TJC, NCQA, URAC, AAAHC, DNV, survey readiness |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eRevenue Cycle \u0026 Finance\u003c/strong\u003e - 6 agents\u003c/summary\u003e\n\n| Agent | Specialty |\n|---|---|\n| `revenue-cycle-specialist` | End-to-end RCM, denials, EDI, A/R, patient financial experience |\n| `revenue-finance-manager` | Budgets, reserves, CMS-2552, cost accounting, margin analysis |\n| `revenue-contract-analyst` | Payer contracts, fee schedules, reimbursement modeling |\n| `revenue-medical-coding-specialist` | ICD-10-CM/PCS, CPT, DRG, HCC, E/M, appeals |\n| `revenue-340b-program-manager` | Covered entity compliance, contract pharmacy, split billing, HRSA audits |\n| `revenue-chargemaster-analyst` | CDM maintenance, price transparency, charge capture integrity |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePayer \u0026 Managed Care\u003c/strong\u003e - 6 agents\u003c/summary\u003e\n\n| Agent | Specialty |\n|---|---|\n| `payer-value-based-care-manager` | ACOs, shared savings, attribution, downside-risk readiness |\n| `payer-relations-specialist` | Network development, contract negotiation, No Surprises Act |\n| `payer-medicare-medicaid-specialist` | CMS regulations, CoPs, MAC requirements, dual-eligible programs |\n| `payer-managed-care-analyst` | Capitation, MLR, PMPM, network adequacy |\n| `payer-credentialing-enrollment-coordinator` | CAQH, PECOS, CMS-855, delegated credentialing |\n| `payer-medicare-outreach-coordinator` | Beneficiary education, enrollment periods, LIS/Extra Help |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eHealth IT \u0026 Informatics\u003c/strong\u003e - 6 agents\u003c/summary\u003e\n\n| Agent | Specialty |\n|---|---|\n| `healthit-informatics-manager` | Clinical informatics, USCDI/TEFCA, ONC HTI-1, data governance |\n| `healthit-epic-applications-analyst` | Epic build/config, Bridges, Caboodle/Cogito |\n| `healthit-information-manager` | HIM operations, ROI, record retention, legal health record |\n| `healthit-clinical-data-analyst` | Registries, eCQMs, MIPS, SQL/Python healthcare analytics |\n| `healthit-interoperability-engineer` | HL7v2, FHIR R4, C-CDA, X12 EDI, HIE connectivity |\n| `healthit-telehealth-program-manager` | Virtual care ops, licensure, RPM/RTM, payer policy matrices |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eOperations \u0026 Administration\u003c/strong\u003e - 7 agents\u003c/summary\u003e\n\n| Agent | Specialty |\n|---|---|\n| `operations-hospital-administrator` | Bed management, capacity planning, throughput |\n| `operations-physician-practice-manager` | wRVU compensation, MGMA benchmarking, practice operations |\n| `operations-ambulatory-manager` | Clinic workflows, scheduling optimization, patient access |\n| `operations-home-health-administrator` | CoPs, OASIS, PDGM, home health VBP |\n| `operations-long-term-care-administrator` | SNF CoPs, MDS, PDPM, Five-Star, PBJ |\n| `operations-supply-chain-manager` | GPOs, value analysis, OR supplies, recalls |\n| `operations-workforce-manager` | Staffing models, scheduling, retention, workforce analytics |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePopulation Health \u0026 Community\u003c/strong\u003e - 3 agents\u003c/summary\u003e\n\n| Agent | Specialty |\n|---|---|\n| `pophealth-population-health-manager` | Risk stratification, care gaps, SDOH, chronic disease programs |\n| `pophealth-surveillance-coordinator` | Reportable diseases, outbreak investigation, syndromic surveillance |\n| `pophealth-community-health-coordinator` | CHNA, Schedule H, health equity, CHW programs, grants |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePharmacy \u0026 Drug Programs\u003c/strong\u003e - 2 agents\u003c/summary\u003e\n\n| Agent | Specialty |\n|---|---|\n| `pharmacy-benefits-specialist` | Formulary, PBM contracts, specialty pharmacy, biosimilars |\n| `pharmacy-medication-safety-specialist` | ISMP, LASA drugs, CPOE, BCMA, USP 797/800 |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eEmergency \u0026 Preparedness\u003c/strong\u003e - 1 agent\u003c/summary\u003e\n\n| Agent | Specialty |\n|---|---|\n| `emergency-preparedness-coordinator` | HICS, CMS EP CoPs, surge planning, HVA |\n\n\u003c/details\u003e\n\n## Eval Status\n\nAll 51 agents have been improved through the repository's lightweight self-improvement loop.\n\n| Pass | Agents | Average Before | Average After | Delta |\n|---|---:|---:|---:|---:|\n| First before/after pass | 15 | 85.0 | 93.9 | +8.9 |\n| Remaining before/after pass | 36 | 85.11 | 95.50 | +10.40 |\n\nThe eval kit is intentionally simple and auditable:\n\n| File | Purpose |\n|---|---|\n| `.claude/commands/eval.md` | Canonical workflow for Claude Code and Codex. |\n| `eval/rubric.md` | Frozen scoring rubric. |\n| `eval/role-baselines/` | Expected-capability baselines for all 51 agents. |\n| `eval/results.tsv` | Append-only results log. |\n| `docs/eval/exam-architect-playbook.md` | Guidance for question writing and scoring behavior. |\n| `docs/eval/model-tuning.md` | Model-role routing notes for current SOTA models. |\n| `eval/run-logs/` | Local ignored artifacts for exact questions, scorer outputs, editor briefs, and summaries. |\n\nSame-question before/after comparisons must preserve full Q001-Q025 artifacts before answers are generated. This keeps score deltas tied to the exact same exam rather than paraphrased weak areas.\n\n## Self-Improvement Kit\n\nInstall the eval loop into another project that already has `agents/*.md`:\n\n```bash\ngit clone https://github.com/ajhcs/healthcare-agents.git\nbash healthcare-agents/scripts/install-self-improvement-kit.sh /path/to/project\n```\n\nRun in Claude Code:\n\n```text\n/eval revenue-medical-coding-specialist\n```\n\nRun in Codex:\n\n```text\nRun the healthcare self-improvement loop for revenue-medical-coding-specialist.\n```\n\nDuring a normal eval run, only the requested `agents/\u003cslug\u003e.md` file should change, `eval/results.tsv` should only receive appended rows, and local artifacts should stay under ignored `eval/run-logs/` paths.\n\n## Repository Layout\n\n```text\n.\n├── agents/                         # 51 source agent prompts\n├── .claude/commands/eval.md         # canonical self-improvement workflow\n├── eval/\n│   ├── rubric.md                    # frozen scoring rubric\n│   ├── results.tsv                  # append-only eval log\n│   ├── role-baselines/              # expected capability baselines\n│   └── run-logs/                    # local ignored exact-question artifacts\n├── docs/eval/                       # scorer and model-routing guidance\n├── docs/usage/                      # agent chooser, starter prompts, handoff map\n├── bin/cli.js                       # GitHub-backed npx entrypoint\n├── install.sh                       # multi-tool installer\n└── scripts/                         # lint and self-improvement kit helpers\n```\n\n## Validation\n\nValidate agent prompt structure:\n\n```bash\nbash scripts/lint-agents.sh\n```\n\nPreview installer behavior:\n\n```bash\nbash install.sh --all --dry-run\n```\n\nCheck CLI help:\n\n```bash\nnpx --yes github:ajhcs/healthcare-agents --help\n```\n\n## Limitations\n\n- The agents provide healthcare administration support, not final clinical, legal, coding, billing, audit, or compliance determinations.\n- Regulations, code sets, payer policies, accreditation standards, and program manuals change. Verify against current primary sources before operational use.\n- The prompts do not make an AI tool HIPAA-compliant and do not create a safe PHI-processing environment. Use approved privacy, security, de-identification, and vendor-review workflows.\n- Tool support differs by runtime. The installer uses best-known current file layouts and keeps plain Markdown as the fallback.\n- The eval scores measure performance against this repository's rubric and role baselines; they are not external certification.\n\n## Troubleshooting\n\n| Problem | Fix |\n|---|---|\n| `npx healthcare-agents` cannot find the package | Use `npx --yes github:ajhcs/healthcare-agents install`; the npm package is not published yet. |\n| Existing files are skipped | Re-run with `--force` after reviewing `--dry-run` output. |\n| Your tool does not auto-discover the agents | Install to a custom path with `--path \u003cdir\u003e` or copy the relevant `agents/\u003cslug\u003e.md` file into the tool's documented rule/context folder. |\n| Claude/OpenCode rejects a skill name | Use v1.1.1 or newer; agent and skill names are lowercase hyphen slugs. |\n| You only want one agent | Copy the specific `agents/\u003cslug\u003e.md` file or generated `SKILL.md` folder manually. The installer is pack-oriented. |\n\n## FAQ\n\n### Are these Claude Code agents or skills?\n\nBoth. The source files in `agents/*.md` install as Claude Code subagents. The installer can also generate one `SKILL.md` folder per agent for Claude Skills, Claude Desktop/Cowork where skills are available, OpenCode, and the open `.agents/skills` convention.\n\n### Do these work in Codex?\n\nYes. The installer copies prompts to `~/.codex/agents` and writes a managed `~/.codex/AGENTS.md` block telling Codex how to select and read specialists. For repo-local Codex App work, keep the prompts in the repository and reference them from `AGENTS.md`.\n\n### Why did the frontmatter names change?\n\nClaude Code and OpenCode expect lowercase hyphen identifiers. v1.1.1 and newer keep human labels in `display_name` while making `name` match the filename slug.\n\n### Can I use these for HIPAA, coding, payer, or compliance work?\n\nUse them for structured analysis, checklists, source-aware workflows, and draft deliverables. Do not treat them as final legal, clinical, coding, billing, audit, or compliance determinations.\n\n### Can I use these with PHI?\n\nOnly inside an environment your organization has approved for PHI, with the right vendor agreements, access controls, retention settings, and de-identification practices. The prompts themselves do not solve that governance problem.\n\n### Can I add my own agents?\n\nYes. Follow the conventions in [CONTRIBUTING.md](CONTRIBUTING.md), run `bash scripts/lint-agents.sh`, and keep the agent narrow, source-aware, and operationally concrete.\n\n## License\n\nApache 2.0. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajhcs%2Fhealthcare-agents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fajhcs%2Fhealthcare-agents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajhcs%2Fhealthcare-agents/lists"}