medical-coding

$npx mdskill add mkurman/zorai/medical-coding

Map clinical codes to billing standards and validate accuracy.

  • Convert ICD-10, CPT, and SNOMED codes to HCC risk categories.
  • Depends on CMS ICD-10 files and official lookup tables.
  • Matches input codes against validated sets to confirm legitimacy.
  • Outputs structured lists of HCC codes or validation status.

SKILL.md

.github/skills/medical-codingView on GitHub ↗
---
name: medical-coding
description: "Medical code mapping and classification tools. ICD-10-CM/PCS, CPT, SNOMED CT, HCPCS, LOINC, RxNorm. Code validation, mapping between terminologies, HCC risk adjustment, and reimbursement modeling."
tags: [icd10, cpt, snomed, loinc, medical-coding, hcc, reimbursement, zorai]
---
## Overview

Medical code mapping and classification: ICD-10-CM/PCS, CPT, SNOMED CT, HCPCS, LOINC, RxNorm. Covers code validation, cross-terminology mapping, HCC risk adjustment, and reimbursement modeling used in healthcare billing and clinical research.

## ICD-10 to HCC Mapping

```python
hcc_map = {
    "E11.9": "HCC 19",   # Diabetes without complications
    "I10": "HCC 134",    # Essential hypertension
    "N18.3": "HCC 138",  # CKD stage 3
}

def calc_hcc(codes):
    hccs = set()
    for c in codes:
        if c in hcc_map:
            hccs.add(hcc_map[c])
    return list(hccs)

print(calc_hcc(["E11.9", "I10"]))
```

## Code Validation

```python
valid_icd10 = set()  # from official CMS file or lookup

def validate_code(code):
    if code in valid_icd10:
        return True, "Valid"
    if code[:3] in valid_icd10:
        return True, "Valid (category)"
    return False, "Unknown code"
```

## References
- [CMS ICD-10](https://www.cms.gov/medicare/coding/icd10)
- [SNOMED CT](https://www.snomed.org/)
- [HCC coding](https://www.cms.gov/medicare/health-plans/medicareadvtgspecratestats/risk-adjustors)

More from mkurman/zorai

SkillDescription
account-management>
agile-scrum>
albumentationsFast image augmentation library (Albumentations). 70+ transforms for classification, segmentation, object detection, keypoints, and pose estimation. Optimized OpenCV-based pipeline with unified API across all CV tasks. Supports images, masks, bounding boxes, and keypoints simultaneously. Note: classic Albumentations (MIT) is no longer maintained; successor AlbumentationsX uses AGPL-3.0. For torchvision-native augmentations, use torchvision.transforms.v2.
aml-complianceAnti-Money Laundering (AML) and Know Your Customer (KYC) compliance workflow. Sanctions screening, PEP detection, transaction monitoring, suspicious activity reporting (SAR), and OFAC compliance.
anki-connectThis skill is for interacting with Anki through AnkiConnect, and should be used whenever a user asks to interact with Anki, including to read or modify decks, notes, cards, models, media, or sync operations.
approval-checkpoint-long-taskCanonical long-task pack for daemon-managed work with deliberate approval checkpoints, status summaries, rollback notes, and mobile-safe governance-aware updates.
auditing-goal-artifactsUse when reviewing recent zorai goal run outputs, closure markers, ledgers, or evidence bundles to judge whether completion is credible or to identify remaining uncertainty.
autogenAutoGen (Microsoft) — multi-agent conversation framework. Agent-to-agent chat, code generation & execution, tool use, group chat, and human-in-the-loop. Build collaborative AI systems with specialized agents.
backtraderPython backtesting framework for trading strategies. Data feeds, brokers, analyzers, and live trading support. Strategy development with commission models, slippage, and signal-based execution.
beautiful-mermaidRender Mermaid diagrams as SVG and PNG using the Beautiful Mermaid library. Use when the user asks to render a Mermaid diagram.