Stats
Actions
Tags
From healthcare
Extracts billable ICD-10-CM diagnosis codes from clinical notes for outpatient claims, following professional coding guidelines to decide which conditions belong and find exact codes.
How this skill is triggered — by the user, by Claude, or both
Slash command
/healthcare:icd10-cmThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
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.
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.
A claim reflects the encounter, not the patient's chart. Per the ICD-10-CM Official Guidelines for outpatient coding:
Code, in this order:
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.
Leave off the claim:
A correctly coded outpatient encounter is short — usually 1 to 4 codes. If your draft list is longer, you are coding the problem list rather than the encounter; cut anything that wasn't actually evaluated, managed, or treated this visit.
This is where most miscoding happens. Two rules:
Don't hedge on a diagnosis. Never list sibling codes, candidate alternatives, or a category plus its children for the same diagnosis — commit to the single code the documentation supports for each. If you are torn between two codes for one diagnosis, the documentation is undetailed and the unspecified code wins.
Code exactly what the note documents — never above it, never below it.
Look up every diagnosis with the ICD-10 Codes connector's tools — including diagnoses you're sure you know. Code sets change every October and your memory of common codes can be stale; for example, "depression, unspecified" has been F32.A (not F32.9) since 2022. The connector has the current set; trust it over recall.
search_codes with code_type="diagnosis", building the query from the note's own wording plus the specificity decision from Step 2 — if you decided "unspecified," put "unspecified" in the search terms.lookup_code or validate_code — every code on the claim must be valid and billable.If the connector's tools are not available, stop. Tell the user the ICD-10 Codes connector needs to be installed or enabled, and do not produce codes from memory — codes recalled without verification are exactly where stale-code-set errors come from.
Work through Steps 1–3 using tool calls only. Don't write explanatory text between searches — no running commentary, no candidate-by-candidate analysis in prose. Your reply is consumed by a claims pipeline that reads every code string in it, so the only prose you produce is the final answer itself, and the only code strings in it are the claim.
Walk your draft list once before answering. For each code ask:
Keep the code only if all three hold. If two codes describe the same diagnosis, delete one before answering.
End with the codes on their own labeled lines so the first-listed diagnosis is unambiguous:
First-listed: E11.65
Secondary: I10, Z79.4
Codes appear exactly as returned by the connector — dots included. Any reformatting for a specific claims system happens downstream, not here.
npx claudepluginhub anthropics/healthcare --plugin icd10-codesDocuments patient encounters using the SOAP format (Subjective, Objective, Assessment, Plan) for structured clinical notes. Useful for medical records, communication, and billing.
Provides musculoskeletal and neurological rehabilitation expertise for physical therapy documentation, clinical reasoning, evidence-based interventions, outcome measures, ICD-10 coding, and insurance.
Provides clinical optometry expertise for eye exams, ocular disease assessment, contact lens fitting, refractive assessment, and ophthalmic ICD-10/CPT coding.