Communitygithub.com

ThomasMoreAI/legal-skills-open

Normaliza códigos de diagnóstico e procedimento de registros médicos em formato claro e utilizável por advogados. Converte ICD-9 para ICD-10-CM, expande códigos ICD-10 e CPT em descrições narrativas e sinaliza anomalias de agrupamento relevantes para disputas de faturamento.

O que é legal-skills-open?

Esta skill transforma códigos médicos opacos — ICD-10-CM, ICD-9 e CPT — em descrições narrativas claras, cruciais para advogados que analisam prontuários em litígios de lesão corporal, erro médico ou disputas de faturamento. Ela suporta expansão automática de descrições, conversão de ICD-9 para ICD-10 usando mapeamentos GEMs e interpretação de modificadores de CPT (como 25, 59, LT/RT) que alteram o significado das cobranças. A skill também compara códigos faturados com a narrativa clínica, sinalizando imprecisões de lateralidade (ex.: 'dor no joelho direito' vs. código 'M25.50' inespecífico) ou suspeitas de desmembramento de procedimentos (unbundling). Quando uma ferramenta de consulta externa não está disponível, ela usa uma referência embutida de códigos de alta frequência em PI/Erro Médico e marca códigos não verificados. Projetada para ambientes como Claude Code, Cursor ou Codex, a skill padroniza o formato dos códigos (ex.: inserindo pontos decimais ausentes) e preserva o sétimo caractere do ICD-10 (A/D/S), que carrega significado clínico. O resultado é apresentado em cronologias médicas, cartas de exigência e revisões de faturamento, com análise estratégica separada para questões de faturamento ou causalidade.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Normalização de Códigos ICD-10 / CPT

Registros médicos estão cheios de códigos que nada significam para advogados sem tradução. Esta skill normaliza códigos de diagnóstico ICD-10-CM, códigos ICD-9 (em registros mais antigos) e códigos de procedimento CPT em uma forma que o advogado possa realmente usar.

Quando usar

Sempre que um código aparecer em registros sendo sumarizados:

  • Códigos de diagnóstico em notas de consulta
  • Códigos de procedimento em relatórios cirúrgicos e registros de faturamento
  • Listas de códigos em relatórios de IME
  • Formulários HCFA-1500 ou contas detalhadas

Ferramenta de consulta

Use a ferramenta de consulta ICD-10 / CPT configurada disponível no ambiente. O nome da ferramenta varia conforme a implantação; verifique a lista de ferramentas disponíveis para uma que lide com consulta de códigos médicos.

Se nenhuma ferramenta de consulta estiver disponível, recorra à referência embutida abaixo para códigos comuns. Para códigos incomuns sem uma ferramenta de consulta, marque o código com [descrição do código não verificada] e destaque na seção de metodologia.

Normalização ICD-10-CM

Formato

Os códigos ICD-10-CM são alfanuméricos, de 3 a 7 caracteres, frequentemente com um ponto decimal após o terceiro caractere: M54.5, S83.241A. Registros às vezes omitem o decimal (M545) ou adicionam espaços (M 54.5); normalize para o formato padrão com o decimal.

Expansão

Para cada código que aparecer, renderize-o como:

[Código] - [Descrição narrativa completa do ICD-10-CM]

Exemplo:

S83.241A - Outra ruptura do menisco medial, lesão atual, joelho direito, primeiro atendimento

O sétimo caractere (A, D, S, etc.) carrega significado e deve ser preservado:

  • A: Primeiro atendimento
  • D: Atendimento subsequente
  • S: Sequelas

Um médico que codifica S83.241A (primeiro atendimento) na visita 1 e S83.241D (subsequente) na visita 5 está usando os códigos corretamente. Um médico que ainda codifica A após doze visitas pode ter uma prática de faturamento descuidada; sinalize para o advogado se este for um caso relevante para faturamento.

Lateralidade

O ICD-10 distingue esquerdo, direito e não especificado. Registros às vezes codificam "não especificado" quando a lateralidade foi realmente documentada na narrativa. Verifique:

Narrativa do atendimento: "Dor no joelho direito, status pós acidente de trânsito"
Código faturado: M25.50 (Dor em articulação não especificada)

Isso é uma imprecisão de codificação. Destaque na Análise Estratégica se o faturamento estiver em questão. O código preciso seria M25.561 (Dor no joelho direito).

Conversão ICD-9 para ICD-10

O ICD-9 foi descontinuado em 1º de outubro de 2015. Registros anteriores a essa data usam ICD-9; registros posteriores geralmente usam ICD-10. Alguns sistemas legados e algumas jurisdições de Compensação de Trabalhadores ainda emitem ICD-9.

Quando códigos ICD-9 aparecerem:

  1. Renderize o código ICD-9 original com sua descrição
  2. Converta para o equivalente ICD-10 mais específico usando os Mapeamentos Gerais de Equivalência (GEMs)
  3. Anote a conversão explicitamente

Exemplo:

847.2 (Entorse da região lombar) [ICD-9, atendimento datado de 2014-08-15]
Conversão: S33.5XXA - Entorse dos ligamentos da coluna lombar, primeiro atendimento

Os GEMs nem sempre são um-para-um. Quando a conversão for ambígua, apresente as alternativas:

787.91 (Diarreia) [ICD-9]
Conversão: R19.7 (Diarreia, não especificada) mais provável; se o contexto indicar
infecção, A09 (Gastroenterite e colite infecciosas, não especificadas)

Normalização CPT

Formato

Os códigos CPT são códigos numéricos de 5 dígitos (99213, 97110, 64483). Os códigos da Categoria II acrescentam F (0001F). Os códigos da Categoria III acrescentam T (0042T). Registros ocasionalmente usam códigos HCPCS Nível II que começam com uma letra (G0463, J0696); estes vêm de um conjunto de códigos diferente, mas aparecem junto com CPT em registros de faturamento e devem ser expandidos da mesma forma.

Expansão

Renderize cada código como:

[Código] - [Descrição do procedimento]

Exemplo:

27447 - Artroplastia de joelho, côndilo e platô; compartimentos medial E lateral
        com ou sem ressuturação da patela (artroplastia total do joelho)
99204 - Consulta ambulatorial ou de consultório para avaliação e manejo de um
        novo paciente, que exige história completa, exame completo e tomada de
        decisão médica de complexidade moderada

Modificadores

Os modificadores CPT são sufixos de dois caracteres que alteram o significado do código do procedimento. Modificadores comuns:

  • 25: Serviço de E/M significativo e separadamente identificável no mesmo dia de um procedimento
  • 50: Procedimento bilateral
  • 51: Múltiplos procedimentos
  • 59: Serviço processual distinto (frequentemente controverso em disputas de faturamento)
  • LT/RT: Lado esquerdo / lado direito
  • XE, XS, XP, XU: Substituições mais específicas para o modificador 59 (X-modificadores)

Os modificadores devem ser expandidos assim como o código base:

64483-LT - Injeção, agente anestésico e/ou esteroide, epidural transforaminal;
            lombar ou sacral, nível único (lado esquerdo)

Agrupamento e desmembramento

Em casos relevantes para faturamento (danos por erro médico, disputas de honorários, negociações de penhor), sinalize:

  • Uso excessivo do modificador 59 ou X-modificador: aplicado a procedimentos que deveriam ser agrupados
  • Edits NCCI: pares de códigos que não devem ser faturados juntos de acordo com a National Correct Coding Initiative
  • Códigos E/M faturados junto com códigos de procedimento sem documentação do modificador 25

Isso é destacado na Análise Estratégica, não na cronologia em si. A cronologia declara o que foi feito; a análise interpreta se o faturamento foi limpo.

Formato de saída em cronologias

Em uma entrada de cronologia médica de atendimento, os códigos aparecem nas subseções Diagnósticos e Tratamento:

Diagnósticos:
- S83.241A - Outra ruptura do menisco medial, lesão atual, joelho direito, primeiro atendimento [SMITH00147]
- M17.11 - Osteoartrite primária unilateral, joelho direito [SMITH00147]

Tratamento:
- 99204 - Avaliação de novo paciente, abrangente [SMITH00147]
- 73721 - RM de qualquer articulação de membro inferior, sem contraste (referenciado) [SMITH00147]

Se um código estiver nos registros mas você não puder verificar sua descrição (ferramenta de consulta indisponível, código não padrão), renderize como:

- 99204 [descrição do código não verificada] [SMITH00147]

Destaque na metodologia que alguns códigos não foram verificados.

Referência embutida: códigos de alta frequência em PI / Erro Médico

Estes aparecem repetidamente em registros de lesão corporal e erro médico. Use como fallback se a ferramenta de consulta estiver indisponível. Isto não substitui uma consulta adequada em casos de produção.

ICD-10 - Coluna

  • M54.5 - Dor lombar baixa (obsoleto 2021; substituído por M54.50, M54.51, M54.59)
  • M54.50 - Dor lombar baixa, não especificada
  • M54.51 - Dor lombar baixa vertebrogênica
  • M54.59 - Outra dor lombar baixa
  • M54.2 - Cervicalgia
  • M54.6 - Dor na coluna torácica
  • M51.26 - Outro deslocamento de disco intervertebral, região lombar
  • M50.20 - Outro deslocamento de disco cervical, região cervical não especificada
  • S13.4XXA - Entorse dos ligamentos da coluna cervical, primeiro atendimento
  • S33.5XXA - Entorse dos ligamentos da coluna lombar, primeiro atendimento

ICD-10 - Extremidades

  • S83.241A - Outra ruptura do menisco medial, lesão atual, joelho direito, primeiro atendimento
  • S83.242A - Outra ruptura do menisco medial, lesão atual, joelho esquerdo, primeiro atendimento
  • S43.401A - Entorse não especificada da articulação do ombro direito, primeiro atendimento
  • M25.561 - Dor no joelho direito
  • M25.562 - Dor no joelho esquerdo
  • M75.101 - Ruptura ou laceração não especificada do manguito rotador do ombro direito, não especificada como traumática

ICD-10 - Cabeça / TCE

  • S06.0X0A - Concussão sem perda de consciência, primeiro atendimento
  • S06.0X1A - Concussão com perda de consciência de 30 minutos ou menos, primeiro atendimento
  • F07.81 - Síndrome pós-concussional
  • G44.301 - Cefaleia pós-traumática, não especificada, intratável
  • G44.309 - Cefaleia pós-traumática, não especificada, não intratável

CPT - Avaliação e Manejo

  • 99202-99205 - Consultas de novos pacientes (nível 2 a 5)
  • 99211-99215 - Consultas de pacientes estabelecidos (nível 1 a 5)
  • 99221-99223 - Cuidados hospitalares iniciais
  • 99281-99285 - Visitas ao departamento de emergência

CPT - Fisioterapia / Reabilitação

  • 97110 - Exercício terapêutico (15 min)
  • 97112 - Reeducação neuromuscular (15 min)
  • 97140 - Terapia manual (15 min)
  • 97530 - Atividades terapêuticas (15 min)
  • 97161-97163 - Avaliação de fisioterapia, baixa / moderada / alta complexidade

CPT - Imagem

  • 73030 - Raio-X do ombro, completo (mín 2 vistas)
  • 73721 - RM de articulação de membro inferior sem contraste
  • 72148 - RM da coluna lombar sem contraste
  • 72141 - RM da coluna cervical sem contraste
  • 70450 - TC da cabeça/cérebro sem contraste
  • 70551 - RM do cérebro sem contraste

CPT - Procedimentos para dor

  • 64483 - Injeção epidural transforaminal, lombar/sacral, nível único
  • 64493 - Injeção em articulação facetária, lombar/sacral, nível único
  • 20610 - Injeção em articulação grande (joelho, ombro, quadril)
  • 20550 - Injeção em bainha de tendão / ligamento

CPT - Cirurgia (ortopédica, comum)

  • 29881 - Artroscopia de joelho com meniscectomia (medial OU lateral)
  • 29888 - Artroscopia de joelho, reparo/aumento/reconstrução do ligamento cruzado anterior
  • 27447 - Artroplastia total de joelho
  • 23410 - Reparo de ruptura do manguito musculotendíneo (reparo do manguito rotador)
  • 63030 - Laminotomia lombar com discectomia, espaço intervertebral único
  • 22612 - Artrodese, técnica posterior ou posterolateral, nível único lombar

Esta lista é incompleta por design. Use a ferramenta de consulta para qualquer coisa que não estiver nela.

Solução de problemas

  • Ferramenta de consulta indisponível: Use a referência embutida de alta frequência apenas para códigos listados; caso contrário, marque [descrição do código não verificada].
  • Conversão ICD-9 ambígua: Preserve o código ICD-9 original, liste alternativas ICD-10 plausíveis e explique qual contexto clínico resolveria o mapeamento.
  • Significado do modificador conflita com a documentação: Expanda o modificador, cite os detalhes do procedimento documentado e sinalize o conflito para revisão do advogado ou especialista em faturamento.
  • Diagnóstico narrativo e código faturado discordam: Relate ambos com citações e destaque a incompatibilidade na Análise Estratégica quando faturamento ou causalidade estiverem em questão.

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

Für Anmeldestrategie & Markenportfolio für Luxus-Modehäuser: ordnet Norm, Beweislast und Gegenargument; Ergebnis: Verhandlungs- oder Eskalationslinie.

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

Dubletten und Serienforderungen in Insolvenzanmeldungen erkennen: Anwendungsfall mehrere Gläubiger melden gleichartige oder identische Forderungen an; Inkassounternehmen und Originalgläubiger reichen parallel ein. § 174 InsO Forderungsanmeldung, § 178 InsO Tabelle Bestreiten. Prüfraster Doppelerfassung gleicher Rechnung, Serienrechnungen mit laufenden Nummern, Konzernforderungen und Vertreterwechsel, mehrfach eingereichte Titel. Output Dublettenprotokoll mit Unterscheidung echte Dublette vs. Serienforderung. Abgrenzung zu Aktenanlage-Batchregister und zu Formalprüfung.

ThomasMoreAI/legal-skills-open

Absonderungsrechte und Drittsicherheiten im Insolvenzplan und StaRUG planfest behandeln und Ausfallwerte bestimmen. §§ 49 50 51 224 InsO §§ 2 Abs. 4 StaRUG Drittsicherheiten. Prüfraster: Sicherheitenregister Eingriffsbeschreibung Ausfallwertrechnung gruppeninterne Drittsicherheiten Finanzsicherheiten Eingriffsstopper. Output: Sicherheitenregister Ausfallwertrechnung Drittsicherheitenmodul. Abgrenzung: nicht für allgemeine Gruppenbildung.

ThomasMoreAI/legal-skills-open

Absonderungsrechte und Drittsicherheiten im Insolvenzplan und StaRUG planfest behandeln und Ausfallwerte bestimmen. §§ 49 50 51 224 InsO Absonderung § 2 Abs. 4 StaRUG Drittsicherheiten. Prüfraster: Sicherheitenregister Eingriffsbeschreibung Ausfallwertrechnung Finanzsicherheiten unzulässige Eingriffe. Output: Sicherheitenregister Ausfallwertrechnung Drittsicherheitenmodul. Abgrenzung: nicht für allgemeine Gruppenbildung.

ThomasMoreAI/legal-skills-open

Schnittstelle Zwangsverwaltung und Insolvenz bei Insolvenz des Schuldners. Anwendungsfall Schuldner wird insolvent waehrend Zwangsverwaltung laeuft und Verwalter muss Koordination mit Insolvenzverwalter klaeren. Normen § 165 InsO Absonderungsrecht § 49 InsO Grundpfandgläubiger § 155 ZVG Einnahmen. Prüfraster Insolvenzeroeffnung Absonderung Verwalterkommunikation Forderungsanmeldung Verteilungsauswirkungen. Output Koordinationsprotokoll mit Absonderungsnachweis Forderungsanmeldungsunterlagen und Abstimmungsprotokoll Insolvenzverwalter. Abgrenzung zu zvg-verteilungsplan-155 und zvg-rechnungslegung.

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

Für /tabellenreview-3d:vorlage-arbeitsvertrag-portfolio: ordnet Norm, Beweislast und Gegenargument; Ergebnis: Prüfprodukt mit Risiko und nächstem Schritt.

ThomasMoreAI/legal-skills-open

Big-Law Billing Narratives und Abrechnung für M&A-Mandate erstellen: Anwendungsfall Associate oder Partnerassistenz muss taugliche Time Narratives Phasenbudgets Workstream-Rechnungen Cap- und Success-Fee-Hinweise erstellen. § 3a RVG Stundenhonorar, GoBD Buchungsanforderungen, XRechnung ZUGFeRD. Prüfraster Honorarvereinbarung prüfen, Time Entries nach Phase strukturieren, Cap-Verbrauch ueberwachen, Success-Fee-Bedingungen abgleichen. Output deal-tauffähige Rechnungsnarrative mit Matter-Controlling und GoBD-konformem Buchungsnachweis. Abgrenzung zu E-Rechnung-GoBD für freistehende Abrechnung.

ThomasMoreAI/legal-skills-open

Zeiterfassung mit abrechenbaren Narrativen für Kanzlei-Mandate. Anwendungsfall Anwalt hat Tätigkeit ausgeubt und will Zeit mit praezisem Narrativ erfassen für spaetere Rechnungsstellung. Normen § 10 RVG Pflichtangaben Narrative GoBD-Zeitstempel. Prüfraster Akte Dauer Takt 6-Minuten-Bloecke Bearbeiter Tätigkeit Honorargrundlage Abrechenbarkeit Datenschutzreduktion. Output Zeiterfassungsprotokoll mit Narrativ Abrechenbarkeit und Rechnungsvorbereitungsnotiz. Abgrenzung zu timesheet-aktenzeitung (Gesamtzeittabelle) und kanzlei-allgemein-rechnung.

ThomasMoreAI/legal-skills-open

Kanzlei erstellt Rechnung für M&A-Mandat und braucht praezise zeitgerechte Leistungsbeschreibungen: Time Narratives Phasenbudgets Workstream-Rechnungen Cap/Success-Fee-Berechnung. Normen RVG §§ 1 ff. BRAO § 49b AO-Steuerrecht. Prüfraster Workstream-Zeiterfassung Phasenzuordnung Korrektur Mandantsfreigabe. Output Narratives-Dokument Workstream-Abrechnung Rechnungsentwurf. Abgrenzung zu mittelstand-ma-erechnung-gobd (GoBD/XRechnung-Format).

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

Für Prozessportfolio-Status: ordnet Norm, Beweislast und Gegenargument; Ergebnis: Prüfprodukt mit Risiko und nächstem Schritt.

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

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.

Habilidades Relacionadas