healthcare-agents

agent
Security Audit
Pass
Health Pass
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 17 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool provides 51 specialized AI agents designed for US healthcare administration tasks, such as HIPAA compliance audits, revenue cycle management, and medical coding. It acts as an expert prompt library to integrate into various AI coding assistants and tools.

Security Assessment
The static code scan of 12 files found no dangerous patterns, hardcoded secrets, or requests for risky permissions. However, the recommended installation method uses a remote bash execution command (`curl | bash`), which inherently obscures what the script is doing in real-time and requires implicit trust in the repository's maintainers. Because this tool generates advice regarding healthcare administration and HIPAA compliance, you must assume any prompts you feed into these agents could expose highly sensitive Patient Health Information (PHI) to the underlying AI models. Overall risk is rated as Medium due to the sensitive domain and the piping of remote shell scripts.

Quality Assessment
The project is very new (version 1.0.0) but shows active maintenance with a recent push. It is open-source under the standard Apache-2.0 license. Community trust is currently limited, evidenced by a low number of GitHub stars (17). The repository includes a detailed README and claims of high evaluation scores, though independent community validation is still lacking.

Verdict
Use with caution: the code itself appears clean and safe, but users must rigorously review the installation script and strictly avoid passing real Patient Health Information (PHI) to the underlying AI models.
SUMMARY

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.

README.md

Healthcare Agents

51 AI agents that actually know healthcare administration.
Real CFR citations. Real CMS payment models. Real deliverables. Not a chatbot with a healthcare skin.

Install in 30 seconds 51 Agents Eval Score 80+ 12+ Tools Stars License v1.0.0


Drop 22,000+ lines of healthcare administration expertise into any AI coding tool. These agents handle HIPAA compliance audits, medical coding reviews, revenue cycle management, CMS cost reports, payer contract analysis, and 45 other healthcare admin specialties -- with the depth of an MHA graduate, not a generic prompt.

Built on the conventions of agency-agents by Michael Sitarzewski.

Install in 30 Seconds

One command. Auto-detects your tools.

curl -fsSL https://raw.githubusercontent.com/ajhcs/healthcare-agents/main/install.sh | bash

Or target a specific tool:

Tool Command
Claude Code curl -fsSL https://raw.githubusercontent.com/ajhcs/healthcare-agents/main/install.sh | bash -s -- --claude
Cursor curl -fsSL https://raw.githubusercontent.com/ajhcs/healthcare-agents/main/install.sh | bash -s -- --cursor
Copilot curl -fsSL https://raw.githubusercontent.com/ajhcs/healthcare-agents/main/install.sh | bash -s -- --copilot
Gemini CLI curl -fsSL https://raw.githubusercontent.com/ajhcs/healthcare-agents/main/install.sh | bash -s -- --gemini
Codex CLI curl -fsSL https://raw.githubusercontent.com/ajhcs/healthcare-agents/main/install.sh | bash -s -- --codex
Windsurf curl -fsSL https://raw.githubusercontent.com/ajhcs/healthcare-agents/main/install.sh | bash -s -- --windsurf
All tools curl -fsSL https://raw.githubusercontent.com/ajhcs/healthcare-agents/main/install.sh | bash -s -- --all
Manual install (git clone)
git clone https://github.com/ajhcs/healthcare-agents.git
cp healthcare-agents/agents/*.md ~/.claude/agents/    # Claude Code
cp healthcare-agents/agents/*.md .cursor/rules/        # Cursor
cp healthcare-agents/agents/*.md .github/instructions/  # Copilot

Then just ask:

"Activate the Compliance Officer and audit our HIPAA Security Rule compliance against 45 CFR 164.308"

Full setup instructions for all 12+ tools: INSTALL.md

What Makes These Different

Generic AI Healthcare Agents
Compliance "Follow HIPAA" Cites 45 CFR 164.500-534, breach notification at 164.400-414
Finance "Optimize revenue" PMPM decomposition, CARC/RARC denial analysis, CMS-2552 cost reports
Coding "Use correct codes" CC/MCC capture rates, NCCI edits, E/M 2021+ guidelines
Systems "Use your EHR" Epic Caboodle/Cogito, CAQH ProView, 340B OPAIS, PECOS, NHSN
Accreditation "Get certified" Joint Commission tracer methodology, NCQA HEDIS measures, CMS CoPs by facility type

22,000+ lines of dense domain knowledge across 51 agents. Average 420 lines/agent of real expertise -- regulatory citations, payment model math, system-specific workflows -- not filler.

Real Output, Not Summaries

Ask the 340B Program Manager about contract pharmacy compliance and you get this:

340B CONTRACT PHARMACY COMPLIANCE ASSESSMENT
=============================================

1. ENTITY ELIGIBILITY VERIFICATION
   - Covered entity type: [Federally Qualified Health Center / DSH Hospital / ...]
   - 340B ID: [HRSA-assigned ID]
   - Registration status in 340B OPAIS: [Active / Pending]

2. CONTRACT PHARMACY NETWORK REVIEW
   - Total contract pharmacies registered: [count]
   - Chain vs. independent mix: [ratio]
   - HRSA contract pharmacy registration dates: [verify all current]

3. COMPLIANCE RED FLAGS
   [ ] Duplicate discounts -- Medicaid claims cross-referenced against 340B purchases
   [ ] Diversion -- prescriptions for non-eligible patients filled at contract pharmacy
   [ ] GPO prohibition violations (for DSH hospitals under 100 beds)
   [ ] Missing contract pharmacy agreements or expired registrations

4. RECOMMENDED ACTIONS
   ...

Every agent produces structured, actionable deliverables -- compliance assessments, financial models, audit checklists, gap reports. Not summaries of what a deliverable would look like.

Use Cases

HIPAA compliance audit -- The Compliance Officer walks through 45 CFR 164.308 administrative safeguards, 164.310 physical safeguards, and 164.312 technical safeguards. Produces a gap assessment with specific remediation steps and regulatory citations.

Revenue cycle denial management -- The Revenue Cycle Specialist analyzes denial patterns using CARC/RARC codes, identifies root causes (registration errors, medical necessity, timely filing), and builds an appeals workflow with payer-specific requirements.

Medical coding accuracy review -- The Medical Coding Specialist audits documentation for CC/MCC capture, E/M level support under 2021+ guidelines, and NCCI edit compliance. Flags undercoding and overcoding with CPT/ICD-10 specifics.

CMS cost report preparation -- The Healthcare Finance Manager structures CMS-2552 worksheets, calculates cost-to-charge ratios, and identifies reclassification opportunities for wage index and DSH adjustments.

Payer contract negotiation -- The Contract Analyst models reimbursement scenarios across fee-for-service, capitation, and value-based arrangements. Compares rates against Medicare benchmarks and MGMA data.

Eval Status

10 of 51 agents currently score 80+ on a frozen eval rubric. Each agent goes through iterative question-answer-judge-improve cycles: the scorer generates domain-specific exam questions, grades the agent's answers, identifies weak areas, and produces a targeted improvement brief. An editor model patches only the weak spots while preserving the agent's identity and voice.

Agent Best Score
Revenue Medical Coding Specialist 82.15
Revenue Finance Manager 81.55
340B Program Manager 81.20
Quality Compliance Officer 81.15
Healthcare Interoperability Engineer 81.10
Quality Process Improvement Analyst 80.85
Revenue Cycle Specialist 80.65
Revenue Contract Analyst 80.45
Health Informatics Manager 80.30
Payer Managed Care Analyst 80.30

Full scores and iteration history: eval/results.tsv

Infrastructure: The /eval skill runs the loop. A frozen rubric at eval/rubric.md keeps scoring consistent across runs. A calibration pipeline ensures scorer reliability before any agent edits land.

The 51 Agents

Strategy & Advisory -- 5 agents
Agent Specialty
Healthcare Strategy Consultant Service line planning, M&A, market analysis, CON strategy
Healthcare Operations Consultant Lean/Six Sigma, throughput, benchmarking (MGMA/Vizient)
Clinical Operations Consultant Clinical workflows, staffing models, ED/OR throughput
Structural Improvement Consultant Org redesign, governance, change management, post-merger integration
Healthcare Actuarial Advisor Risk adjustment (HCC/RAF), capitation, IBNR, MLR modeling
Clinical Operations -- 8 agents
Agent Specialty
Utilization Management Specialist Medical necessity, InterQual/Milliman, Two-Midnight Rule
Care Management Specialist Care coordination, TCM/CCM, readmission prevention, SDOH
Clinical Research Coordinator IRB, ICH-GCP E6(R3), 21 CFR Part 11, trial management
Documentation Improvement Specialist CDI queries, CC/MCC capture, DRG optimization
Prior Authorization Specialist PA workflows, appeals, gold carding, ePA (CMS-0057-F)
Referral Specialist Referral management, network navigation, care gap closure
Case Manager Discharge planning, post-acute placement, LOS optimization
Infection Prevention Specialist HAI surveillance (NHSN), antimicrobial stewardship, outbreak response
Quality, Safety & Compliance -- 7 agents
Agent Specialty
Quality Improvement Specialist HEDIS, MIPS/QPP, CMS Stars, Leapfrog, eCQMs
Process Improvement Analyst 80+ PDSA, Lean, Six Sigma DMAIC, value stream mapping
Patient Experience Coordinator HCAHPS, service recovery, VBP patient experience domain
Patient Safety Officer Sentinel events, RCA/FMEA, Just Culture, PSO reporting
Compliance Officer 80+ HIPAA, Stark, Anti-Kickback, FCA, OIG compliance programs, EMTALA
Risk Manager Enterprise/clinical risk, malpractice, claims management
Accreditation Specialist Joint Commission, NCQA, URAC, AAAHC, DNV, survey readiness
Revenue Cycle & Finance -- 6 agents
Agent Specialty
Revenue Cycle Specialist 80+ End-to-end RCM, denials (CARC/RARC), A/R optimization
Healthcare Finance Manager 80+ Budgets, cost accounting, CMS-2552 cost reports, margin analysis
Healthcare Contract Analyst 80+ Payer contracts, fee schedules, reimbursement modeling
Medical Coding Specialist 80+ ICD-10-CM/PCS, CPT, DRG, HCC, E/M coding
340B Program Manager 80+ Covered entity compliance, contract pharmacy, split billing, HRSA audits
Chargemaster Analyst CDM maintenance, price transparency, charge capture integrity
Payer & Managed Care -- 6 agents
Agent Specialty
Value-Based Care Manager ACO operations (MSSP/ACO REACH), shared savings, risk contracts
Payer Relations Specialist Network development, contract negotiation, No Surprises Act
Medicare & Medicaid Specialist CMS regulations, CoPs, MAC requirements, dual-eligible programs
Managed Care Analyst 80+ Capitation modeling, MLR, PMPM, network adequacy
Credentialing & Enrollment Coordinator CAQH, PECOS, CMS-855, privileging, delegated credentialing
Medicare Outreach Coordinator Beneficiary education, enrollment periods, LIS/Extra Help
Population Health & Community -- 3 agents
Agent Specialty
Population Health Manager Risk stratification, care gaps, SDOH, chronic disease programs
Public Health Surveillance Coordinator Reportable diseases, outbreak investigation, syndromic surveillance
Community Health Coordinator CHNA, Schedule H, health equity, CHW programs, grant management
Health IT & Informatics -- 6 agents
Agent Specialty
Health Informatics Manager 80+ Clinical informatics, USCDI/TEFCA, ONC HTI-1, data governance
Epic Applications Analyst Epic build/config, Bridges, Caboodle/Cogito, certification
Health Information Manager HIM operations, ROI, record retention, legal health record
Clinical Data Analyst Registries, eCQMs, MIPS reporting, SQL/Python for healthcare data
Healthcare Interoperability Engineer 80+ HL7v2, FHIR R4, C-CDA, X12 EDI, HIE connectivity
Telehealth Program Manager Virtual care ops, licensure compacts, RPM/RTM billing
Operations & Administration -- 7 agents
Agent Specialty
Hospital Operations Administrator Bed management, capacity planning, patient throughput
Physician Practice Manager wRVU compensation, MGMA benchmarking, practice operations
Ambulatory Operations Manager Clinic workflows, scheduling optimization, patient access
Home Health Administrator CoPs (42 CFR 484), OASIS, PDGM, home health VBP
Long-Term Care Administrator SNF CoPs (42 CFR 483), MDS, PDPM, Five-Star, survey readiness
Supply Chain Manager GPO management, value analysis, OR supplies, FDA recalls
Healthcare Workforce Manager Staffing models, scheduling, retention, burnout prevention
Pharmacy & Drug Programs -- 2 agents
Agent Specialty
Pharmacy Benefits Specialist Formulary, PBM contracts, specialty pharmacy, biosimilars
Medication Safety Specialist ISMP, LASA drugs, CPOE, BCMA, USP 797/800
Emergency & Preparedness -- 1 agent
Agent Specialty
Emergency Preparedness Coordinator HICS, CMS EP CoPs (42 CFR 482.15), surge planning, HVA

Self-Improving Agents

These agents are not static. The repo ships a self-improvement kit for Claude Code and Codex that runs automated eval-and-improve loops:

bash healthcare-agents/scripts/install-self-improvement-kit.sh /path/to/your/project

Then run from either tool:

  • Claude Code: /eval revenue-medical-coding-specialist
  • Codex: Run the healthcare self-improvement loop for revenue-medical-coding-specialist

The loop generates domain-specific exam questions, scores the agent's answers against a frozen rubric, identifies weak areas, and patches the prompt -- while preserving the agent's identity and voice. In runtimes that support native subagents, the strongest model scores while a faster model edits.

This does not require the Python eval harness. See INSTALL.md for the full setup.

Compatible Tools

Tool Install Method
Claude Code cp agents/*.md ~/.claude/agents/
Cursor cp agents/*.md .cursor/rules/
Windsurf cp agents/*.md .windsurf/rules/
GitHub Copilot cp agents/*.md .github/instructions/
Gemini CLI cp agents/*.md ~/.gemini/agents/
Codex CLI cp agents/*.md ~/.codex/agents/
Cline cp agents/*.md .clinerules/
Amazon Q cp agents/*.md .amazonq/rules/
Continue.dev cp agents/*.md .continue/
Aider Add to .aider.conf.yml as read: entries
Claude Desktop Paste into project instructions or Cowork plugins
Claude Web Upload .md files as project knowledge
OpenClaw Copy as skills (see INSTALL.md)
Any tool Paste .md content into system prompt / custom instructions

Validation

bash scripts/lint-agents.sh

FAQ

Can AI agents handle HIPAA compliance?

These agents cite specific CFR sections (45 CFR 160, 162, 164), know the difference between addressable and required implementation specifications, and produce structured gap assessments. They do not handle PHI or make legal determinations -- they give you the regulatory framework and audit methodology that a compliance officer would use.

What healthcare certifications and regulations do these agents cover?

The agents cover CMS Conditions of Participation, Joint Commission standards, NCQA HEDIS measures, MIPS/QPP quality programs, CMS Five-Star ratings, OASIS/PDGM for home health, MDS/PDPM for skilled nursing, HRSA 340B requirements, OIG compliance program guidance, and dozens of other regulatory frameworks. Each agent's specialty section lists its specific coverage.

Do these agents work with Epic, Cerner, or other EHR systems?

The Epic Applications Analyst has deep knowledge of Epic build/configuration, Bridges integration, and Caboodle/Cogito analytics. Other agents reference EHR-specific workflows where relevant (CPOE for medication safety, CDI queries for documentation improvement, eCQMs for quality reporting). The agents are not EHR plugins -- they provide the healthcare administration expertise that complements your EHR workflows.

How are agents evaluated and improved?

Each agent goes through iterative eval cycles: a scorer generates domain-specific exam questions (regulatory scenarios, calculation problems, workflow decisions), grades the agent's responses on a frozen rubric, and produces an improvement brief. An editor model patches weak areas while preserving the agent's identity. 10 agents currently score 80+ out of 100. Scores and methodology are fully transparent in eval/results.tsv.

Can I use these agents for revenue cycle management?

Six agents cover the full revenue cycle: Medical Coding Specialist (ICD-10, CPT, DRG, HCC coding), Revenue Cycle Specialist (denials management, A/R optimization, CARC/RARC analysis), Healthcare Finance Manager (CMS-2552 cost reports, budgeting), Contract Analyst (payer reimbursement modeling), 340B Program Manager (drug discount compliance), and Chargemaster Analyst (CDM maintenance, price transparency).

Contributing

New agents, deeper regulatory citations, updated CMS rules -- all welcome. See CONTRIBUTING.md.

Disclaimer

These agents provide healthcare administration knowledge for informational and operational purposes. They do not provide clinical advice, legal opinions, or handle PHI. Regulations change -- verify against primary sources (CMS.gov, Federal Register, state regulatory bodies).

License

Apache 2.0 -- see LICENSE.

Reviews (0)

No results found