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
63
GitHub Stars
376
First Seen
Jun 19, 2026
icd10-cm-skill — anthropics/healthcare