Automatically recommend ICD-10 diagnosis codes and CPT procedure codes from clinical notes. Trigger when: user provides clinical notes, patient encounter summaries, discharge summaries, or asks for medical coding assistance. Use for healthcare providers, medical coders, and billing professionals who need accurate code recommendations.
A medical coding assistant that parses clinical notes and recommends appropriate ICD-10 diagnosis codes and CPT procedure codes with confidence scoring.
This skill analyzes clinical documentation to extract relevant medical information and map it to standardized coding systems:
⚠️ HUMAN REVIEW REQUIRED: Medical coding directly impacts billing, reimbursement, and clinical documentation. All recommendations must be verified by a certified medical coder or healthcare provider.
python scripts/main.py --input "clinical_note.txt" [--format json|text]
Or use programmatically:
from scripts.main import CodingAssistant
assistant = CodingAssistant()
result = assistant.analyze("Patient presents with acute bronchitis...")
print(result.icd10_codes)
print(result.cpt_codes)
| Parameter | Type | Default | Required | Description |
|---|---|---|---|---|
--input, -i | string | - | Yes | Path to clinical note file |
--format, -f | string | json | No | Output format (json, text) |
--output, -o | string | stdout | No | Output file path |
--confidence-threshold | float | 0.7 | No | Minimum confidence score (0.0-1.0) |
--include-alternatives | flag | false | No | Include alternative code suggestions |
Accepts clinical notes in various formats:
{
"icd10_codes": [
{
"code": "J20.9",
"description": "Acute bronchitis, unspecified",
"confidence": 0.92,
"evidence": ["cough for 5 days", "wheezing on exam"],
"alternatives": ["J20.0", "J44.9"]
}
]
}
{
"cpt_codes": [
{
"code": "99213",
"description": "Office visit, established patient, moderate complexity",
"confidence": 0.85,
"evidence": ["detailed history", "low complexity decision making"],
"time": "20 minutes"
}
]
}
See references/ folder for:
icd10_common_codes.json: Frequently used ICD-10 codes by specialtycpt_common_codes.json: Frequently used CPT codes by specialtycoding_guidelines.md: General coding guidelines and conventionsrequirements.txt for package dependencies| Risk Indicator | Assessment | Level |
|---|---|---|
| Code Execution | Python/R scripts executed locally | Medium |
| Network Access | No external API calls | Low |
| File System Access | Read input files, write output files | Medium |
| Instruction Tampering | Standard prompt guidelines | Low |
| Data Exposure | Output files saved to workspace | Low |
# Python dependencies
pip install -r requirements.txt