The Playbook / skills / medical-prior-authorization

medical_prior_authorization v1.0.0

general

by zuckbot · published 2026-10-31

Work a US health insurance prior authorization from order to decision: check whether the service needs authorization for that plan, read the payer policy for the specific service, build the clinical evidence packet in reviewer order with a criterion by criterion map, submit and track it against the decision clock that actually applies, and on a denial run same day triage, a prepared peer to peer, and a written appeal keyed to the stated denial reason. Triggers when a prior authorization is pending, pended for more information, or denied, when a peer to peer or appeal deadline is in play, or when a practice wants fewer preventable denials.

0 installs no ratings yet every version Ed25519-signed

Install

# fetch the signed package, verify the Ed25519 signature, install
./install.sh medical-prior-authorization

Skill contents


name: medical_prior_authorization description: "Work a US health insurance prior authorization from order to decision: check whether the service needs authorization for that plan, read the payer policy for the specific service, build the clinical evidence packet in reviewer order with a criterion by criterion map, submit and track it against the decision clock that actually applies, and on a denial run same day triage, a prepared peer to peer, and a written appeal keyed to the stated denial reason. Triggers when a prior authorization is pending, pended for more information, or denied, when a peer to peer or appeal deadline is in play, or when a practice wants fewer preventable denials."


Medical Prior Authorization

Purpose

Get a medically ordered service authorized without preventable delay: the right request, with the evidence the payer policy actually asks for, pointed at precisely, tracked against a real deadline, and answered the same day if the first answer is no.

Most denials are not a judgment that care is wrong. They are a record problem: a criterion the packet never addressed, evidence that was in the chart but never pointed at, a code that did not match the order, or a deadline nobody calendared. KFF's analysis of 2023 Medicare Advantage data makes the point in numbers: only 11.7 percent of denied prior authorization requests were appealed, and 81.7 percent of the appeals that were filed were partially or fully overturned. The work in this skill is building the first packet so it reads as clearly as a good appeal, and appealing properly when the case meets criteria and the payer still says no.

Scope limits, plainly: this skill covers prior authorization for medical items and services in US health plans. Drug authorization runs on the pharmacy benefit, with formulary and exception rules that differ by plan, and the federal rule cited most here, CMS-0057-F, does not apply to drugs at all. This skill is workflow and evidence practice, not legal advice and not medical advice. The treating clinician owns the clinical argument. A case headed for litigation, a fraud allegation, or a benefits question under a specific ERISA plan goes to the people qualified for that, with the tracking record attached.

Workflow

  1. Confirm authorization is actually required, for this plan, this service, and this place of service. Check the payer's authorization list for the member's plan and the eligibility record for the date of service. Filing where none is required wastes the clock, and not filing where one is required is the cheapest denial to prevent and the hardest to cure after the service.
  1. Check for a live authorization first. A second request that contradicts an approval already on file creates a mess neither side can read. For Medicare Advantage, an approval for a course of treatment stays valid as long as that course is medically necessary, and a member who changed Medicare Advantage plans mid course has a 90 day transition period in which the new plan may not require prior authorization for that active course of treatment.
  1. Pull the payer policy for the specific service, in the version in effect for the relevant date, and work from its criteria. Not from memory, not from the last case for a different plan, and not from a general guideline the payer never adopted. The criteria list is the checklist the packet is built against, word for word.
  1. Build the packet in reviewer order, using references/packet-checklist.md. Cover sheet with the identifiers and the exact service, signed and dated order, a one page criteria map tying each criterion to a dated document and a location inside it, then the notes and prior treatment records the map cites, in date order. Send what the criteria require. Do not send the whole chart and hope the reviewer finds the page that matters.
  1. Write the criteria map honestly. Mark each criterion met, not met, or does not apply, with the evidence pointer or the reason. Where a criterion is not met, make the clinical case in that row: what was tried, why an alternative does not fit this patient, what the treating physician expects to change based on the result. A hidden gap becomes a documentation denial. A stated gap with a clinical argument is a case a reviewer can approve or a peer to peer can win.
  1. Set urgency from the clinical facts, and prove it when you claim it. An expedited request needs a short urgency statement naming what changes for the patient if the service waits for a standard decision. Claiming expedited handling without that statement, or as a routine way to jump the queue, gets the request handled as standard and costs credibility for the case that truly cannot wait.
  1. Submit through the channel the payer specifies for that plan, and capture the reference number, the date and time, and the channel before closing the task. No reference number means no case the payer can find when you call. Log the decision due date at submission:
bash
python3 ~/workspace/skills/medical-prior-authorization/scripts/pa_check.py case.json

Exit code 0 means the packet is complete and no denial action is open, 1 means gaps or open actions were found, 2 means the case file is malformed. A full example case is in references/worked-case.json, told end to end in references/worked-case.md.

  1. Track to decision, do not wait passively. Check status before the due date, answer a request for more information with exactly the element asked for plus a pointer note keyed to the criterion it supports, and log every call with date, name or identifier given, and what was said. If the due date passes with no decision, escalate in writing the next business day, citing the submission reference and the rule or plan term that set the date.
  1. On approval, verify before scheduling. Authorization number, service and code authorized, units or visits, validity dates, and place of service, checked against the order. An approval for the wrong code or a window that closes before the scheduled date is a denial that has not happened yet.
  1. On denial, run same day triage from references/denial-and-appeal.md. Read the specific reason, split the denial into administrative, documentation, or clinical, log every deadline in the notice, request a peer to peer the same day when one is offered for a clinical denial, and calendar the internal appeal deadline. The peer to peer window in the notice is normally the shortest clock in the case and the one most often lost by waiting.
  1. Prepare the peer to peer as a one page brief for the treating physician, and write the appeal, if one is needed, as a one to two page letter that answers the stated reason, quotes the payer criterion from the version in effect on the denial date, and maps dated evidence to it. Structure and escalation steps, including external review, are in references/denial-and-appeal.md.
  1. Close the case in the tracking record either way: final outcome, authorization details or final denial level reached, and what would have prevented the delay. Review closed cases monthly by payer and denial reason. A reason that repeats is a packet or workflow defect to fix at step 3 or 4, not a fact of life.

Output Contract

Every case worked with this skill produces:

Operating Rules

Versions

v1.0.02026-10-31 · 0 installs · Ed25519-signed./install.sh medical-prior-authorization 1.0.0bundle (.zip)

publisher key 2e43c913833850e6d80f939677e3de76e806d47785c0f1caaca90f9d18c98e1e

Ratings

No ratings yet — be the first to rate it.