skills/legal/medical-billing-analysis/SKILL.md
Produces a litigation-ready analysis of medical bills and supporting records for personal injury, medical-malpractice, workers'-compensation, and disability cases. Validates CPT/HCPCS/ICD-10 codes against documentation, applies a per-charge causation screen, runs a UCR/FAIR Health/MPFS reasonableness review, surfaces unbundling, upcoding, duplicate and phantom billing, flags letter-of-protection inflation, identifies collateral-source and lien interfaces, and outputs a memo whose every finding cites document, page, and Bates. Trigger on: medical billing analysis, medical bill audit, billing reasonableness review, UCR review, CPT/ICD code review, NCCI/unbundling/upcoding review, billed vs. paid analysis, letter of protection (LOP) analysis, collateral source review, chargemaster markup, causation chain, IME rebuttal prep, demand-package billing exhibit, mediation statement billing section, lien interface identification.
npx skillsauth add casemark/skills medical-billing-analysisInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
A medical-billing analysis is simultaneously the spine of the damages case and a future exhibit at deposition, mediation, and trial. A defective analysis (invented UCR figures, missed unbundling, undocumented charges treated as valid, pre-existing same-body-part treatment not flagged, lien holders not identified) either understates the case or hands opposing counsel impeachment material. This skill produces a memo where every charge is reconciled, every code is checked against the chart, every finding cites document/page/Bates, every red flag carries a stable taxonomy ID, and every jurisdictional assumption is surfaced for counsel.
The skill is billing-side: it does not value the case, draft the demand, build the full chronology, or resolve liens. It hands those off to sibling skills.
medical-record-chronology — full date-ordered treatment narrative; consume it, do not rebuildmedical-treatment-summary — narrative course of treatmentdamages-calculator — valuation, multipliers, present value; this skill feeds it the billing-side line itemslien-resolution-summary — Medicare/Medicaid/ERISA/hospital liens; identify here, resolve thereime-report-analysis, expert-medical-record-omissions — defense-side rebuttal preppi-demand-summary, demand-letter, mediation-statement — downstream consumershipaa-release — verify authorization scope before requesting recordsAsk every time unless the user says "use defaults" or "just draft." Record gaps explicitly; do not silently proceed.
Required
As applicable
Defaults if user does not respond (label every default in the output):
[VERIFY]Missing-material policy. Proceed with what's available. List missing categories in Section 4 (Open Items) of the output. Do not produce reasonableness or causation conclusions on a provider whose itemized bill is absent — name the gap and stop.
Classify each document, assign a short stable doc-label, record Bates range and OCR status. Use the categories listed in references/OUTPUT-TEMPLATE.md Section 5. The doc-label carries through every citation in the memo.
For each provider, verify: billed = paid + contractual adjustments + patient responsibility + outstanding balance. Record the per-provider reconciliation row (Section 7 of the output). Any failure to reconcile is itself a flag — identify the underlying cause (RF-04 duplicate, RF-05 phantom, an unrecorded adjustment, or a data-entry error) and record it. Do not paper over a delta; show it.
Per charge, check that:
-25, -59, X-modifiers, -26, -TC, -50, -RT/-LT, -51, -22) are used correctly.Detailed mechanics, modifier-misuse catalog, NCCI/MUE framing, and DRG considerations: see references/CODE-VALIDATION.md. Never assert a code-text mapping from memory; cite the AMA codebook or CMS file, or label [VERIFY: billing expert].
Three prongs, all required, applied to every billed line item:
Failures get tagged "potentially contested — attorney review" in Section 7's Notes column and surface as red flags (RF-23 through RF-28 as applicable). The causation screen is the same screen used by damages-calculator Step 2 — keep terminology aligned.
Produce a benchmark range, not a single "reasonable amount." Use FAIR Health, MPFS, state WC fee schedules, and the case's own EOB allowed amounts. Geographic adjustment (geozip/locality) matters. Letter-of-protection lines get extra scrutiny.
Methodology, source list, percentile presentation, billed-vs-paid integration, and "when to recommend a billing expert" thresholds: see references/REASONABLENESS-METHODOLOGY.md. Never quote a benchmark figure that was not actually retrieved; if no benchmark was run, say so and recommend a billing expert.
Use the stable IDs in references/RED-FLAGS-CATALOG.md. Categories: billing integrity (RF-01–RF-10), reasonableness (RF-11–RF-14), referral patterns (RF-15–RF-17), documentation (RF-18–RF-22), causation (RF-23–RF-28), IME/peer-review (RF-29–RF-31), liens/collateral source (RF-32–RF-35).
Each row in Section 11 of the output: ID | Name | Detail | Source | Suggested Attorney Action | Severity (H/M/L). Sort H → M → L. If a finding doesn't match any ID, mark it [NEW PATTERN — review needed] rather than inventing a permanent ID.
Identify lien holders (Medicare, Medicaid, ERISA plan, hospital/provider, workers' comp, VA/Tricare), record amounts asserted and notice status, and hand off to lien-resolution-summary. Do not negotiate, reduce, or resolve. Surface the billed-vs-paid jurisdictional rule for counsel; do not pick the measure unilaterally.
Follow references/OUTPUT-TEMPLATE.md section by section. Run the Pre-Delivery Checks at the bottom of that file before declaring the draft complete. The privilege header, citation format ([doc-label, p. N, Bates XXXXXX]), and the [F]/[A]/[O] tagging convention are non-negotiable.
After delivering the draft, ask:
If no response: recommend obtaining the missing provider's itemized bills (highest-value gap) and flag the billed-vs-paid jurisdiction question as the next decision. Proceed with the draft as authorized.
[VERIFY]lien-resolution-summary)[VERIFY] (billed-vs-paid, hospital lien statute, statutory caps, No Surprises Act)A short reference for the agent or paralegal to surface in Section 14. Not a substitute for counsel research. Every entry tagged [VERIFY].
[VERIFY current law][VERIFY current law in jurisdiction][VERIFY current law][VERIFY current CMS process][VERIFY plan language][VERIFY statute][VERIFY current regs][VERIFY current law in jurisdiction][VERIFY] (consult damages-calculator)[VERIFY] unless it appears verbatim in a sibling skill in this repo[F]), assumption ([A]), and opinion ([O]) in Sections 9–11 of the outputdamages-calculator)lien-resolution-summary)This skill produces attorney work product. The memo derives entirely from documentation listed in its Section 2 and assumptions stated in its Section 3. Jurisdictional rules flagged [VERIFY] must be confirmed by counsel before reliance. No output of this skill may be sent outside the legal team without attorney review and approval.
tools
Audits the complete in-scope medical-record universe in a litigation matter and produces an attorney-facing, Bates-cited analysis of treatment gaps, missing records or providers, baseline coverage, material billing or production mismatches, and complaint evolution. Use when asked to find missing medical records, analyze treatment gaps or first-care timing, identify absent providers, assess whether a production is complete, or prepare a records-request target list. Use medical-record-chronology instead when the primary request is a chronological clinical narrative.
development
Drafts a legally compliant Private Placement Memorandum for Regulation D offerings (Rule 506(b)/506(c)), covering full disclosure framework including risk factors, capitalization, securities terms, use of proceeds, and investor qualification requirements. Enforces SEC anti-fraud compliance under Section 10(b)/Rule 10b-5, blue sky law considerations, and accredited investor verification under Rule 501. Use this skill when drafting PPMs, offering memorandums, Reg D disclosure documents, or private offering circulars for issuers raising capital from sophisticated investors. Also trigger when the user mentions private placement disclosure, offering memorandum, Reg D fundraising, or accredited investor verification. Even if the user just says "PPM" or "draft our offering memo," use this skill.
data-ai
Generates structured privacy and data protection law briefings across US, EU, UK, and other jurisdictions. Organizes by jurisdiction with compliance deadlines, enforcement actions, and legislative changes. Use when preparing privacy law briefings, compliance updates, regulatory change summaries, or data protection landscape reviews.
testing
Generates structured summaries of prior art references for patent prosecution, validity analysis, and freedom-to-operate assessments. Maps disclosures to claim elements with precise citations. Use when summarizing prior art, analyzing patent landscapes, mapping references to claims, or preparing office action responses.