Communitygithub.com

ThomasMoreAI/legal-skills-open

Normalizes diagnostic and procedure codes from medical records into clean, attorney-readable form. Cross-walks ICD-9 to ICD-10-CM, expands ICD-10 codes to narrative descriptions, expands CPT codes to procedure descriptions, and flags bundling or unbundling oddities relevant to billing disputes. Use this skill any time medical codes appear in records being summarized for litigation use, including medical chronologies, demand letters, and billing review. Also use when the user asks what a specific medical code means.

legal-skills-open 是什麼?

legal-skills-open is a Claude Code agent skill that normalizes diagnostic and procedure codes from medical records into clean, attorney-readable form. Cross-walks ICD-9 to ICD-10-CM, expands ICD-10 codes to narrative descriptions, expands CPT codes to procedure descriptions, and flags bundling or unbundling oddities relevant to billing disputes. Use this skill any time medical codes appear in records being summarized for litigation use, including medical chronologies, demand letters, and billing review. Also use when the user asks what a specific medical code means.

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ThomasMoreAI/legal-skills-open/tree/HEAD/general/personal-injury/skills/icd-cpt-normalization

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

ICD-10 / CPT Code Normalization

Medical records are full of codes that mean nothing to attorneys without translation. This skill normalizes ICD-10-CM diagnosis codes, ICD-9 codes (in older records), and CPT procedure codes into a form the attorney can actually use.

When to use

Whenever a code appears in records being summarized:

  • Diagnosis codes in encounter notes
  • Procedure codes in operative reports and billing records
  • Code lists in IME reports
  • HCFA-1500 forms or itemized bills

Lookup tool

Use the configured ICD-10 / CPT lookup tool available in the environment. The tool name varies by deployment; check the available tools list for one that handles medical code lookup.

If no lookup tool is available, fall back to the inline reference below for common codes. For uncommon codes without a lookup tool, mark the code with [code description not verified] and surface in the methodology section.

ICD-10-CM normalization

Format

ICD-10-CM codes are alphanumeric, 3 to 7 characters, often with a decimal point after the third character: M54.5, S83.241A. Records sometimes drop the decimal (M545) or add spaces (M 54.5); normalize to the standard format with the decimal.

Expansion

For each code that appears, render it as:

[Code] - [Full narrative description from ICD-10-CM]

Example:

S83.241A - Other tear of medial meniscus, current injury, right knee, initial encounter

The seventh character (A, D, S, etc.) carries meaning and must be preserved:

  • A: Initial encounter
  • D: Subsequent encounter
  • S: Sequela

A treating provider coding S83.241A (initial) on visit 1 and S83.241D (subsequent) on visit 5 is using the codes correctly. A provider still coding A after twelve visits may have a sloppy billing practice; flag for the attorney if this is a billing-relevant case.

Laterality

ICD-10 distinguishes left, right, and unspecified. Records sometimes code "unspecified" when laterality was actually documented in the narrative. Cross-check:

Encounter narrative: "Right knee pain, status post MVA"
Code billed: M25.50 (Pain in unspecified joint)

This is a coding inaccuracy. Surface in Strategic Analysis if billing is at issue. The accurate code would be M25.561 (Pain in right knee).

ICD-9 to ICD-10 cross-walk

ICD-9 was retired October 1, 2015. Records before that date use ICD-9; records after generally use ICD-10. Some legacy systems and some Workers Comp jurisdictions still emit ICD-9.

When ICD-9 codes appear:

  1. Render the original ICD-9 code with its description
  2. Cross-walk to the most specific ICD-10 equivalent using the General Equivalence Mappings (GEMs)
  3. Note the cross-walk explicitly

Example:

847.2 (Sprain of lumbar) [ICD-9, encounter dated 2014-08-15]
Cross-walk: S33.5XXA - Sprain of ligaments of lumbar spine, initial encounter

GEMs are not always one-to-one. When the cross-walk is ambiguous, surface the alternatives:

787.91 (Diarrhea) [ICD-9]
Cross-walk: R19.7 (Diarrhea, unspecified) most likely; if context indicates
infection, A09 (Infectious gastroenteritis and colitis, unspecified)

CPT normalization

Format

CPT codes are 5-digit numeric codes (99213, 97110, 64483). Category II codes append F (0001F). Category III codes append T (0042T). Records occasionally use HCPCS Level II codes which start with a letter (G0463, J0696); these come from a different code set but appear alongside CPT in billing records and should be expanded the same way.

Expansion

Render each code as:

[Code] - [Procedure description]

Example:

27447 - Arthroplasty, knee, condyle and plateau; medial AND lateral compartments
        with or without patella resurfacing (total knee arthroplasty)
99204 - Office or other outpatient visit for the evaluation and management of a
        new patient, requires a comprehensive history, comprehensive examination,
        and medical decision making of moderate complexity

Modifiers

CPT modifiers are two-character suffixes that change the meaning of the procedure code. Common modifiers:

  • 25: Significant, separately identifiable E/M service on the same day as a procedure
  • 50: Bilateral procedure
  • 51: Multiple procedures
  • 59: Distinct procedural service (often controversial in billing disputes)
  • LT/RT: Left side / right side
  • XE, XS, XP, XU: More specific replacements for modifier 59 (X-modifiers)

Modifiers must be expanded just like the base code:

64483-LT - Injection, anesthetic agent and/or steroid, transforaminal
            epidural; lumbar or sacral, single level (left side)

Bundling and unbundling

In billing-relevant cases (med mal damages, fee disputes, lien negotiations), flag:

  • Modifier 59 or X-modifier overuse: applied to procedures that should bundle
  • NCCI edits: pairs of codes that should not be billed together per the National Correct Coding Initiative
  • E/M codes billed alongside procedure codes without modifier 25 documentation

These are surfaced in Strategic Analysis, not the chronology itself. The chronology states what was done; the analysis interprets whether the billing was clean.

Output format in chronologies

In a medical chronology encounter entry, codes appear in the Diagnoses and Treatment subsections:

Diagnoses:
- S83.241A - Other tear of medial meniscus, current injury, right knee, initial encounter [SMITH00147]
- M17.11 - Unilateral primary osteoarthritis, right knee [SMITH00147]

Treatment:
- 99204 - New patient evaluation, comprehensive [SMITH00147]
- 73721 - MRI any joint of lower extremity, without contrast (referred) [SMITH00147]

If a code is in the records but you cannot verify its description (lookup tool unavailable, code is non-standard), render as:

- 99204 [code description not verified] [SMITH00147]

Surface in methodology that some codes were not verified.

Inline reference: high-frequency codes in PI / Med Mal

These appear repeatedly in personal injury and medical malpractice records. Use as a fallback if the lookup tool is unavailable. This is not a substitute for proper lookup on production cases.

ICD-10 - Spine

  • M54.5 - Low back pain (deprecated 2021; replaced by M54.50, M54.51, M54.59)
  • M54.50 - Low back pain, unspecified
  • M54.51 - Vertebrogenic low back pain
  • M54.59 - Other low back pain
  • M54.2 - Cervicalgia
  • M54.6 - Pain in thoracic spine
  • M51.26 - Other intervertebral disc displacement, lumbar region
  • M50.20 - Other cervical disc displacement, unspecified cervical region
  • S13.4XXA - Sprain of ligaments of cervical spine, initial encounter
  • S33.5XXA - Sprain of ligaments of lumbar spine, initial encounter

ICD-10 - Extremities

  • S83.241A - Other tear of medial meniscus, current injury, right knee, initial encounter
  • S83.242A - Other tear of medial meniscus, current injury, left knee, initial encounter
  • S43.401A - Unspecified sprain of right shoulder joint, initial encounter
  • M25.561 - Pain in right knee
  • M25.562 - Pain in left knee
  • M75.101 - Unspecified rotator cuff tear or rupture of right shoulder, not specified as traumatic

ICD-10 - Head / TBI

  • S06.0X0A - Concussion without loss of consciousness, initial encounter
  • S06.0X1A - Concussion with loss of consciousness of 30 minutes or less, initial encounter
  • F07.81 - Postconcussional syndrome
  • G44.301 - Post-traumatic headache, unspecified, intractable
  • G44.309 - Post-traumatic headache, unspecified, not intractable

CPT - Evaluation and Management

  • 99202-99205 - New patient office visits (level 2 through 5)
  • 99211-99215 - Established patient office visits (level 1 through 5)
  • 99221-99223 - Initial hospital care
  • 99281-99285 - Emergency department visits

CPT - PT / Rehab

  • 97110 - Therapeutic exercise (15 min)
  • 97112 - Neuromuscular reeducation (15 min)
  • 97140 - Manual therapy (15 min)
  • 97530 - Therapeutic activities (15 min)
  • 97161-97163 - PT evaluation, low / moderate / high complexity

CPT - Imaging

  • 73030 - X-ray shoulder, complete (min 2 views)
  • 73721 - MRI lower extremity joint without contrast
  • 72148 - MRI lumbar spine without contrast
  • 72141 - MRI cervical spine without contrast
  • 70450 - CT head/brain without contrast
  • 70551 - MRI brain without contrast

CPT - Pain procedures

  • 64483 - Transforaminal epidural injection, lumbar/sacral, single level
  • 64493 - Facet joint injection, lumbar/sacral, single level
  • 20610 - Major joint injection (knee, shoulder, hip)
  • 20550 - Tendon sheath / ligament injection

CPT - Surgery (orthopedic, common)

  • 29881 - Knee arthroscopy with meniscectomy (medial OR lateral)
  • 29888 - Knee arthroscopy, anterior cruciate ligament repair/augmentation/reconstruction
  • 27447 - Total knee arthroplasty
  • 23410 - Repair of ruptured musculotendinous cuff (rotator cuff repair)
  • 63030 - Lumbar laminotomy with discectomy, single interspace
  • 22612 - Arthrodesis, posterior or posterolateral technique, single level lumbar

This list is incomplete by design. Use the lookup tool for anything not on it.

Troubleshooting

  • Lookup tool unavailable: Use the inline high-frequency reference only for listed codes; otherwise mark [code description not verified].
  • ICD-9 crosswalk is ambiguous: Preserve the original ICD-9 code, list plausible ICD-10 alternatives, and explain what clinical context would resolve the mapping.
  • Modifier meaning conflicts with documentation: Expand the modifier, cite the documented procedure details, and flag the conflict for attorney or billing-expert review.
  • Narrative diagnosis and billed code disagree: Report both with citations and surface the mismatch in Strategic Analysis when billing or causation is at issue.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ThomasMoreAI/legal-skills-open

Track the IP portfolio — registrations, renewals, maintenance fees, and use declarations. Use when checking what's renewing, adding or updating an asset, recording a maintenance filing, or auditing the register for gaps, lapses, and use-in-commerce questions. Receives handoffs from prosecution and clearance work.

ThomasMoreAI/legal-skills-open

When the user's message starts with "Canada" (case-insensitive), generate a full Ontario PI Case Assessment Memo from the case_stressor corpus and return it verbatim. This is the primary handler for Canadian fact patterns — DO NOT ask clarifying questions first; run the memo and let the lawyer react.

ThomasMoreAI/legal-skills-open

交通事故责任评估与判定专业技能。当用户需要交通事故责任分析、事故现场照片评估、交通法规咨询、事故责任划分、法律依据查询时触发此技能。适用于车辆碰撞事故、行人事故、非机动车事故等各类道路交通事故的责任认定场景。无论用户使用"交通事故"、"车祸"、"责任判定"、"交通法规"、"事故定责"等何种表述,只要涉及交通事故评估或责任认定,均应调用此技能。

ThomasMoreAI/legal-skills-open

Strategische Markenportfolio-Planung für Luxus-Modehaeuser: Mandant will Marken in DE/EU/international schützen oder Portfolio optimieren. Normen: §§ 32 ff. MarkenG, Art. 32 ff. UMV (EU) 2017/1001, Madrid-Protokoll (WIPO). Prüfraster: Nizza-Klassen (3/14/18/25/35), Multi-Class-Strategie, Prioritaets-Kaskade, Kostenoptimierung, Anmeldezeitpunkt. Output Marken-Portfolio-Plan, Anmelde-Empfehlung je Territorium, Kostenprojektion. Abgrenzung: Einzelne Anmeldung DPMA siehe wortmarke-anmeldung-dpma; Madrid-Protokoll Details siehe madrid-protokoll-und-internationale-registrierung.

ThomasMoreAI/legal-skills-open

Audit an intellectual-property portfolio for ownership, protection, scope, deadlines, territorial coverage, use, value, encumbrances, and enforcement risk. Use for diligence, integration, financing, governance, renewal planning, product launches, or recurring portfolio reviews.

ThomasMoreAI/legal-skills-open

Use whenever the user asks about a motor-vehicle statute, citation, contributing factor, OR a Canadian personal-injury fact pattern — always query Specter's Harvester API before answering. The API auto-routes between two collections (US statutes + Canadian PI case law).

ThomasMoreAI/legal-skills-open

Assesses product liability exposure on given facts — classifying the defect as manufacturing, design, or warning/instruction, mapping which party in the supply chain is potentially exposed, and grading the realistic exposure. Use this whenever a user wants product liability worked through rather than a general deficiency test — including phrasings like "what's our exposure if this product injured someone", "is this a design defect or a manufacturing defect", "who in the supply chain is on the hook here", "assess our product liability risk on these facts", or "how exposed are we if the warning label was inadequate". Distinct from deficiency-analyst, which tests service and trade-practice thresholds — this is specific to defective products and supply-chain exposure. Fires for any product liability question, in any jurisdiction, for manufacturers, assemblers, sellers, distributors, or importers.

ThomasMoreAI/legal-skills-open

KI-VO Hochrisiko-Anforderungen für Personalwesen in Kanzleien ab August 2026: Anwendungsfall Kanzlei setzt KI im HR-Bereich ein oder beraet Mandanten zum AGG-konformen KI-Einsatz bei Bewerberauswahl. Anhang III Nr. 4 KI-VO Hochrisiko Bewerberauswahl, Inkrafttreten 2. August 2026, AGG Diskriminierungsverbot. Prüfraster Hochrisiko-Klassifizierung eigener HR-KI, Konformitätsbewertung, Transparenzpflichten für Betroffene, Beratungsmandate Arbeitsrecht. Output Checkliste Hochrisiko-Anforderungen mit Umsetzungsplan für August 2026. Abgrenzung zu Bias-und-Diskriminierung-Prüfung und zu KI-VO-Betreiber-Pflichten.

ThomasMoreAI/legal-skills-open

Vorlagetabelle für Portfolio-Review von Arbeitsvertraegen im 3D-Format: Forderung/Prüfung/Stellung. Normen: BGB, KSchG, ArbZG. Prüfraster: Vertragsbedingungen, Klauselgueltigkeit, HR-Compliance. Output: Arbeitsvertrag-Portfolio-Tabelle. Abgrenzung: nicht allgemeine 3D-Review-Konfiguration.

ThomasMoreAI/legal-skills-open

Unternehmen oder Kanzlei muss IP-Portfolio verwalten und anstehende Fristen im Blick behalten. Schutzrechtsportfolio-Verwaltung. Prüfraster: Eintragungen Verlaengerungen Jahresgebühren Benutzungsnachweise Fristkalender. Output: Fristenkalender und Portfolio-Audit mit Luecken Verfall und Benutzungsfragen. Abgrenzung zu schutzschrift-eilverfuegung (Verletzungsverteidigung) und markenanmeldung-dpma.

ThomasMoreAI/legal-skills-open

Statusuebersicht aller laufenden Prozessmandate: Fristen, Verfahrensstand, naechste Schritte. Normen: ZPO, RVG. Prüfraster: Fristenliste, offene Anträge, Termine, Mahnfristen. Output: Portfolio-Statusbericht Prozessmandate. Abgrenzung: nicht Einzelmandat-Briefing.

ThomasMoreAI/legal-skills-open

Workflow-Skill zu aufklaerungsfehler beweisstrategie. Nutzt Normtext, Nutzerangaben und verifizierte Quellen; Rechtsprechung nur nach Live-Pruefung mit Gericht, Datum und Aktenzeichen.

ThomasMoreAI/legal-skills-open

Strukturierte Prüfung von Ansprüchen wegen Behandlungsfehler nach §§ 630a ff. BGB iVm § 823 BGB. Behandlungsvertrag Aufklärungspflicht § 630e BGB Dokumentationspflicht § 630f BGB Beweislastregeln § 630h BGB grober Behandlungsfehler Beweislastumkehr voll beherrschbares Risiko Anfaengerstandard Schmerzensgeld § 253 BGB. Schlichtungsstelle Aerztekammer MDK-Gutachten. Verjährung drei Jahre § 195 BGB Hoechstfrist dreissig Jahre § 199 Abs. 2 BGB.

ThomasMoreAI/legal-skills-open

Workflow-Skill zu fachanwalt medizinrecht aufklaerungsfehler. Nutzt Normtext, Nutzerangaben und verifizierte Quellen; Rechtsprechung nur nach Live-Pruefung mit Gericht, Datum und Aktenzeichen.

ThomasMoreAI/legal-skills-open

Behandlungsfehler §§ 630a 630h BGB Verletzung medizinischer Standard. Diagnosefehler Therapiefehler Befunderhebungsfehler Hygienefehler. Beweisregeln § 630h BGB Vermutung Kausalität bei grobem Behandlungsfehler § 630h Abs. 5 BGB Befunderhebungsfehler Dokumentationsmangel. Schadensersatzanspruch §§ 280 823 BGB Schmerzensgeld § 253 BGB. Verjährung drei Jahre § 195 BGB ab Kenntnis 30 Jahre Hoechstfrist.

ThomasMoreAI/legal-skills-open

Mandant hatte Verkehrsunfall und fragt: Wer haftet wie viel und welche Schadensposten koennen geltend gemacht werden? §§ 7 17 18 StVG iVm § 254 BGB Haftungsquote. Prüfraster: Betriebsgefahr beidseitig Anscheinsbeweis Auffahrunfall Spurwechsel Rotlicht Vorfahrt Mithaftung Tempo Sicherheitsabstand Anschnall. Schadenspositionen Reparatur fiktive Abrechnung Mietwagen Nutzungsausfall Sachverständige Schmerzensgeld. Output: Haftungsquoten-Berechnung und Schadenstabelle. Abgrenzung zu fachanwalt-verkehrsrecht-regulierungsanforderung (Gläubigerseite vs. Versicherer) und fachanwalt-verkehrsrecht-versicherer-quotenverhandlung-vergleich.

ThomasMoreAI/legal-skills-open

Verkehrsunfall-Mandat im Zivilprozess vorbereiten: Schadensersatz, Schmerzensgeld, Versicherungskorrespondenz. Normen: §§ 7 18 StVG, §§ 823 253 BGB, § 115 VVG. Prüfraster: Haftungsquote, Schadensposten, Verjaebrung, Regulierungsablauf. Output: Klageschrift Verkehrsunfall oder Klageerwiderung. Abgrenzung: nicht Strafrecht oder Ordnungswidrigkeiten.

ThomasMoreAI/legal-skills-open

Analyzes an entire portfolio of contracts at scale — extracting key terms, obligations, renewal dates, risk provisions, and financial commitments across hundreds or thousands of agreements simultaneously. Produces structured reports, obligation trackers, renewal calendars, and risk matrices. Also supports playbook-based redlining where contracts are compared against preferred positions and automatically marked up. Use when an in-house legal team, GC, legal ops, procurement, or finance team needs portfolio-wide visibility into contract terms, upcoming renewals, obligation compliance, or batch contract review against organizational standards.

ThomasMoreAI/legal-skills-open

Classifies personal vs non-personal data per GDPR Art. 4(1) definition test with decision tree for borderline cases. References Breyer v Germany CJEU C-582/14 dynamic IP ruling and WP29 Opinion 4/2007. Keywords: personal data, GDPR Art 4, data classification, Breyer ruling, identifiability test, PII.

ThomasMoreAI/legal-skills-open

Use when a matter involves marriage, divorce, property division, custody, or inheritance for non-Muslim residents of the UAE under Federal Decree-Law 41/2022 (the UAE Civil Personal Status Law) or the DIFC Wills Service Centre. Covers no-fault divorce, joint-custody default, equal-property division, testamentary freedom for non-Muslims, pre-nuptial agreement enforceability, and the parallel DIFC/ADGM wills regimes. Contrasts with the UAE Personal Status Law 28/2005 (Sharia-based) which governs Muslim residents. Triggers on non-Muslim divorce UAE, UAE civil marriage, DIFC wills, UAE prenup, or expat family law UAE questions.

相關技能