Hipaa fundamentals
Skill EliasAli0720/HIPAA-agent-skill/skills/hipaa-fundamentals
HIPAA compliance skills for AI coding agents (Claude Code, Codex, Cursor, Gemini). 10 senior-grade skills: scoping, app dev, websites, AI/LLM, code review + PHI scanner, risk analysis, breach response, BAAs, de-identification, compliance programs. Exact 45 CFR citations, OCR enforcement through 2026.
npx -y skills add EliasAli0720/HIPAA-agent-skill --skill hipaa-fundamentalsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 11 days oldThe repository was created 11 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Determines whether and how HIPAA applies to a product, company, or data flow, and explains the core rules with exact regulatory citations — PHI and the 18 identifiers, covered entities vs business associates, Privacy/Security/Breach Notification Rules, patient rights, and penalties. Use when someone asks "does HIPAA apply to us", "is this PHI", "are we a business associate", "do we need a BAA", or needs any HIPAA scoping, definitions, or regulatory overview.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
8.3 KB, as published. Nobody here has run it
HIPAA Fundamentals
You are acting as a senior healthcare regulatory advisor. Answer with the precision of someone who works in 45 CFR Parts 160–164 daily: cite the exact section for every substantive claim (e.g., §164.502(b) for minimum necessary), distinguish what the law requires from what is merely best practice, and say "it depends on X" only when you then resolve X.
Legal disclaimer
This skill provides educational and engineering guidance, not legal advice. Final legal determinations (BA status, breach reportability, preemption) belong with qualified healthcare counsel.
Step 1 — Scope the question: does HIPAA even apply?
HIPAA regulates the relationship, not the data type. The same blood-pressure reading is PHI in one app and unregulated consumer data in another. Walk this tree:
- Is the entity a covered entity (CE)? (45 CFR §160.103) — health plan, healthcare clearinghouse, or a healthcare provider that transmits health information electronically in connection with a Part 162 standard transaction (claims, eligibility). A cash-only provider that never bills electronically is not a CE.
- If not a CE — is it a business associate (BA)? A person or company that creates, receives, maintains, or transmits PHI on behalf of a CE (or another BA). BA status arises by function, not by contract — a vendor handling PHI for a CE is a BA (and directly liable) even if no BAA was ever signed. Cloud/SaaS/hosting that merely stores encrypted ePHI without the key is still a BA ("no-view" services trigger BA status — OCR cloud computing guidance). The conduit exception is narrow: transient transmission only (ISPs, couriers); persistence of custody defeats it.
- Subcontractor of a BA? Also a BA with full direct liability; obligations flow down the chain (§164.502(e)(1)(ii); §164.504(e)(5)).
- Neither? HIPAA does not apply — but the FTC Health Breach Notification Rule (16 CFR Part 318, amended 2024) almost certainly does for consumer health apps, plus FTC Act §5 and state health-privacy laws (WA My Health My Data, etc.). Never tell a consumer-health company "no HIPAA, no rules."
For nuanced scenarios (patient-directed API access, employer wellness, hybrid entities), load references/scoping-decision-guide.md.
Step 2 — Identify whether the data is PHI
PHI = individually identifiable health information (IIHI) held or transmitted by a CE/BA in any form (§160.103). IIHI relates to past/present/future physical or mental health, provision of care, or payment for care, and identifies the individual or gives a reasonable basis to identify them. Exclusions: FERPA education records, employment records held by a CE as employer, decedents dead >50 years.
- ePHI = PHI in electronic form; only ePHI is subject to the Security Rule (§164.302).
- Identifiability is judged against the 18 Safe Harbor identifiers (§164.514(b)(2)) — names, geographic subdivisions smaller than state, all date elements except year, phone, fax, email, SSN, MRN, health plan numbers, account numbers, certificate/license numbers, vehicle IDs, device IDs, URLs, IP addresses, biometrics, full-face photos, any other unique identifying code.
- Properly de-identified data is not PHI (§164.514(a)) — see the
hipaa-deidentificationskill for methods. - Payment + identity counts: an invoice line "John Smith — therapy session" is PHI with zero clinical detail.
Step 3 — Map the applicable rule
| Question | Rule | Citation |
|---|---|---|
| Who may use/disclose PHI, and for what | Privacy Rule | 45 CFR Part 164 Subpart E (§§164.500–534) |
| How ePHI must be secured | Security Rule | Subpart C (§§164.302–318) |
| What happens after an impermissible disclosure | Breach Notification Rule | Subpart D (§§164.400–414) |
| Penalties and investigations | Enforcement Rule | Part 160 Subparts C–E |
| Contracts with vendors | BAA requirements | §164.504(e), §164.314 |
Core Privacy Rule mechanics to apply correctly:
- Default is prohibition (§164.502(a)): PHI may not be used or disclosed except as permitted. Only two required disclosures: to the individual (§§164.524/528) and to HHS.
- TPO — treatment, payment, health care operations — permitted without authorization (§164.506).
- Authorization (§164.508) required for everything else; always required for psychotherapy notes, marketing, and sale of PHI. A cookie banner or checkbox is not a valid authorization.
- Minimum necessary (§164.502(b)): use/disclose/request only what the task requires. Does not apply to treatment disclosures, disclosures to the individual, or authorized disclosures.
- Patient rights: access within 30 days + one 30-day extension (§164.524); amendment (§164.526); accounting of disclosures (§164.528); restriction on disclosures to health plans for self-paid items must be honored (§164.522(a)(1)(vi)).
Full rule-by-rule map with penalty tiers: references/regulatory-map.md.
Step 4 — Answer with enforcement reality
When advising, weight guidance by what OCR actually enforces:
- #1 finding: missing/inadequate risk analysis (§164.308(a)(1)(ii)(A)) — present in ~90% of Security Rule actions; OCR runs a dedicated Risk Analysis Initiative (since Oct 2024). Route deep dives to the
hipaa-risk-analysisskill. - Right of access delays (50+ enforcement actions), missing BAAs, ransomware response failures, unencrypted devices, insider snooping, and social-media disclosures round out the pattern set.
- Civil penalties (2026-adjusted): four culpability tiers from $145 to $2,190,294 per violation, $2,190,294 annual cap per provision (§160.404; 45 CFR 102.3). Criminal exposure (42 U.S.C. §1320d-6) reaches 10 years for disclosure with intent to sell or harm. State AGs can also sue (HITECH §13410(e)).
Hard rules
- No BAA = no PHI to that vendor, ever. Execute the BAA before PHI flows.
- Never treat "the data is encrypted" or "we can't see the data" as an exemption from BA status.
- Never treat consent/cookie banners as HIPAA authorizations (§164.508 elements are specific).
- De-identified ≠ "we removed the name." All 18 identifiers, or documented Expert Determination.
- "HIPAA-certified" does not exist — no HHS-recognized certification. Treat vendor badges as marketing.
- When HIPAA does not apply, check FTC HBNR + state law before declaring the data unregulated.
Routing to specialist skills
- Building an app/backend/cloud infra →
hipaa-app-development - Website, tracking pixels, forms, portals →
hipaa-website-compliance - AI/LLM/agents on health data →
hipaa-ai-compliance - Reviewing code for violations →
hipaa-code-review - Risk analysis / security program →
hipaa-risk-analysis,hipaa-compliance-program - Incident or suspected breach →
hipaa-breach-response - Vendor contracts →
hipaa-baa-management - De-identifying data →
hipaa-deidentification
References
references/regulatory-map.md— rule-by-rule citation map, patient rights table, penalty tiers, current rulemaking status. Load for any "what does the law say about X" question.references/scoping-decision-guide.md— CE/BA/neither decision scenarios (apps, wellness programs, patient-directed access, hybrid entities, conduit exception), FTC HBNR overlay. Load for any "does HIPAA apply to us" question.
Regulatory currency
Content reflects the rules as of mid-2026. The January 2025 Security Rule NPRM (90 FR 898) is not final (Unified Agenda targets ~2027); treat its provisions (mandatory encryption/MFA, asset inventories) as strong best practice, not binding law. The 2024 reproductive health privacy rule was vacated nationwide (Purl v. HHS, June 2025). When an answer depends on NPRM status, current penalty amounts, or a vendor's BAA terms, verify via web search before relying on figures here.