icd10-cm-skill

Installation
SKILL.md

ICD-10-CM Coding from Clinical Notes

Turn a clinical note into the diagnosis codes a professional coder would submit on the claim for that encounter. This happens in two distinct steps: first decide which conditions belong on the claim, then find the exact code for each. Both steps cause errors: coders miss claims by listing the wrong conditions, and by coding the right condition at the wrong specificity.

Step 1: Decide what belongs on the claim

A claim reflects the encounter, not the patient's chart. Per the ICD-10-CM Official Guidelines for outpatient coding:

Code, in this order:

  1. The reason for the visit (first-listed diagnosis). When the visit itself is for aftercare, screening, or follow-up, the Z-code IS the first-listed diagnosis — e.g. orthopedic aftercare/hardware removal (Z47.x), suture removal (Z48.02), a scheduled wellness exam (Z00.0x).
  2. Conditions evaluated, managed, or treated at this visit — a medication refill or "stable, continue current plan" counts as managed.
  3. Chronic comorbidities, but only if they were addressed or changed medical decision-making this visit.

Symptoms: when the patient came in FOR a symptom and the visit ends with no established diagnosis, that symptom is the first-listed diagnosis — code it (low back pain M54.5x, joint pain M25.5xx). That is the only time a symptom is coded. A symptom that accompanies a coded diagnosis (headache with a coded neck injury, dizziness with coded vertigo, fatigue with coded anemia) is part of that diagnosis and never coded separately.

Installs
14
GitHub Stars
319
First Seen
8 days ago
icd10-cm-skill — anthropics/healthcare