icd10-code-lookup
Installation
SKILL.md
ICD-10 Diagnosis Code Lookup
Search, validate, and browse ICD-10-CM diagnosis codes using the National Library of Medicine (NLM) Clinical Tables API. This skill enables AI agents to perform partial-match text searches against the complete ICD-10-CM code set, validate specific codes for billing accuracy, browse the hierarchical chapter-block-category structure, and retrieve code descriptions with inclusion/exclusion notes -- streamlining medical coding, claims processing, and clinical documentation workflows.
Quick Install
npx skills add Open-Medica/open-medical-skills --skill icd10-code-lookup
What It Does
- Free-text code search with partial matching and auto-completion, allowing natural language queries like "chest pain" or "type 2 diabetes with nephropathy" to return matching ICD-10-CM codes ranked by relevance
- Code validation to verify that a specific ICD-10-CM code (e.g., E11.65) is valid, active in the current fiscal year, and billable (not a header/category code), with clear error messages for invalid or retired codes
- Hierarchical browsing through the ICD-10-CM structure from chapter level (e.g., Chapter IX: Diseases of the Circulatory System) down to subcategory and extension character level, displaying parent-child relationships
- Inclusion and exclusion notes for each code, showing "Includes," "Excludes1" (mutually exclusive), and "Excludes2" (not included here but may coexist) notes critical for accurate coding
- Code-first and use-additional-code instructions identifying when manifestation codes require an underlying etiology code, and when additional codes should be assigned for associated conditions