Un Claude Skill qui transforme le dossier d’une affaire de dommages corporels — dossiers médicaux, relevés de facturation, justificatifs de perte de salaire, le rapport de police et les notes de dossier du cabinet — en un premier brouillon de lettre de réclamation amiable (demand letter). Il construit une chronologie médicale datée avec une citation de page du dossier derrière chaque entrée, ventile les dommages spéciaux (special damages) à partir des factures, calcule une fourchette de dommages généraux (general damages) à partir du playbook de multiplicateurs du cabinet et assemble la lettre à partir du modèle du cabinet. Chaque chiffre du brouillon remonte à une page source ; chaque affirmation que les dossiers n’étayent pas est listée sous « données insuffisantes » au lieu d’être écrite dans la lettre. L’avocat révise et signe. Le skill ne fixe jamais le montant de réclamation final et n’envoie jamais.
La révision par l’avocat est obligatoire. Ce skill rédige ; il n’exerce pas le droit. La fourchette de dommages généraux qu’il produit est de l’arithmétique sur le playbook propre au cabinet, pas une évaluation juridique. L’avocat fixe le montant de la réclamation, confirme chaque fait cité contre le dossier et répond de la lettre qui part.
Quand l’utiliser
Un cabinet de dommages corporels côté demandeur où les paralégaux assemblent les paquets de réclamation et où une lettre de 6 à 12 pages prend 3 à 6 heures de rédaction en plus de la revue des dossiers. Le goulot d’étranglement est le premier brouillon, pas le jugement juridique.
Le cabinet a un modèle de lettre de réclamation écrit et une méthodologie de dommages (bandes de multiplicateur par gravité de la blessure, ou un tarif journalier). Le skill structure le brouillon autour de la méthode du cabinet ; il n’en invente pas une.
Les dossiers sont déjà collectés et convertis en texte (PDF passés en OCR, ou un export de récupération de dossiers). Le skill rédige à partir des dossiers qui existent — il ne court pas après les factures manquantes.
Quand NE PAS l’utiliser
Fixer le montant de la réclamation. Le skill produit une fourchette à partir du playbook de multiplicateurs. L’avocat fixe le chiffre — le nombre est un choix stratégique qui pèse le for, l’assureur, la solidité de la responsabilité et les limites de la police que le skill ne modélise pas.
Affaires à responsabilité contestée ou à complexité de faute comparative. Quand la responsabilité est tout l’enjeu, la lettre de réclamation est un document de plaidoirie que l’avocat rédige. Le skill est pour les affaires à responsabilité claire, des tissus mous aux blessures modérées, où le travail consiste à assembler le dossier, pas à débattre du lien de causalité.
Écritures contentieuses. Une lettre de réclamation est pré-contentieuse. Assignations, requêtes et réponses de discovery sont des documents judiciaires avec leurs propres règles — hors périmètre.
Avis médical. Le skill résume ce que disent les dossiers (diagnostic, traitement, impressions du soignant). Il n’infère ni pronostic, ni causalité, ni permanence au-delà de ce qu’un soignant a écrit. Ce sont des avis médicaux ; ils viennent du médecin traitant ou d’un expert mandaté.
Dossiers contenant des PHI que vous ne pouvez pas traiter selon vos accords. Les informations de santé protégées (PHI) transitent par ce skill. Confirmez que votre déploiement de Claude et vos termes d’engagement client les couvrent avant qu’un dossier n’entre (voir Points de vigilance).
Installation
Déposez le bundle. Placez apps/web/public/artifacts/demand-letter-drafter-claude-skill/SKILL.md dans votre répertoire de skills Claude Code avec le dossier references/.
Rédigez le modèle de réclamation du cabinet. Remplacez le squelette dans references/1-demand-letter-template.md par la lettre réelle du cabinet — ordre des sections, boilerplate, le paragraphe de réclamation et de délai, le bloc de signature. Le skill assemble dans ce modèle ; c’est la voix du cabinet, pas celle du skill.
Codez le playbook de dommages. Remplissez references/2-damages-playbook.md avec la méthodologie du cabinet : bandes de multiplicateur par gravité de la blessure (la fourchette courante est 1.5-5× des dommages spéciaux ; les blessures graves ou défigurantes vont plus haut), le tarif journalier si le cabinet en utilise un, et tout plafond ou règle spécifique au for que le cabinet suit. Sans ce fichier le skill n’a aucune base pour une fourchette de dommages généraux et refusera d’en produire une.
Définissez le schéma de chronologie.references/3-medical-chronology-schema.md définit les colonnes (date de soin, soignant, traitement, montant facturé, page du dossier) et le format de citation. Conservez le format de citation que le cabinet utilise pour que l’avocat puisse vérifier contre les mêmes références de page.
Faites un essai à blanc sur trois affaires clôturées. Lancez le skill sur trois dossiers déjà réglés où la réclamation est connue. Comparez son total de dommages spéciaux aux spéciaux réels, sa chronologie à celle du paralégal, et sa fourchette de dommages généraux à ce que le cabinet a réclamé. Ajustez les bandes du playbook jusqu’à ce que la fourchette encadre la réclamation historique.
Ce que fait le skill
Sept étapes. La chronologie médicale est construite avant l’arithmétique des dommages, parce que chaque dollar de spéciaux et chaque ligne du récit des blessures cite une entrée de la chronologie, et chaque entrée de la chronologie cite une page du dossier.
Indexer l’ensemble des dossiers. Ingère les dossiers, factures, justificatifs de salaire, rapport de police et notes de dossier. Construit un index de pages pour que chaque citation ultérieure résolve vers un document et une page précis. Les fichiers illisibles (OCR échoué, image seule) sont listés, pas sautés en silence.
Construire la chronologie médicale datée. Une ligne par date de soin : soignant, plainte, traitement, montant facturé et la page du dossier dont elle provient. Les ruptures de traitement sont signalées (une rupture de 6 semaines entre la visite aux urgences et le premier suivi est un fait que l’assureur utilisera ; l’avocat devrait le savoir avant que la lettre ne parte, pas après).
Ventiler les dommages spéciaux. Totalise les factures médicales par soignant, ajoute la perte de salaire documentée et ajoute les frais déboursés. Chaque ligne cite la page de sa facture. Le skill signale les factures référencées dans les dossiers mais absentes du dossier, ainsi que les privilèges (liens) ou soldes qu’il ne peut pas rapprocher — ceux-ci vont à l’avocat comme « à confirmer avant l’envoi », pas dans le total comme une supposition.
Rédiger le récit de responsabilité et des faits. À partir du rapport de police et des notes de dossier, rédige la section du comment-c’est-arrivé. Les affirmations que le rapport n’étaye pas sont signalées, pas écrites. Là où le rapport et le récit du client diffèrent, le skill expose le conflit au lieu d’en choisir un.
Rédiger le récit des blessures et du traitement. Ancré dans la chronologie — diagnostic, déroulé du traitement, impressions du soignant, état actuel tel que les dossiers l’énoncent. Aucun langage de pronostic ou de permanence sauf si un soignant l’a écrit ; si le cabinet veut un argument de permanence, cela est signalé comme requérant la déclaration du médecin traitant.
Calculer la fourchette de dommages généraux. Applique la bande de multiplicateur du playbook aux spéciaux (ou la méthode journalière, selon le playbook). La sortie est une fourchette avec la bande affichée — « $X-$Y à 2.5-4× de spéciaux de $Z » — explicitement étiquetée comme un point de départ. Le skill ne choisit pas un point dans la fourchette.
Assembler le brouillon et la checklist de révision. Remplit le modèle du cabinet. Laisse la ligne du délai de réponse comme un placeholder que l’avocat fixe. Produit la checklist de révision appariée : chaque chiffre avec sa citation source, chaque rupture signalée, chaque élément « données insuffisantes » et la ligne du délai de réponse en placeholder. La lettre est un brouillon ; la checklist est la façon dont l’avocat la vérifie en minutes au lieu de relire le dossier.
Réalité des coûts
Tokens LLM — un dossier complet fait 40-120k tokens en entrée (dossiers, factures, rapport) et 4-8k en sortie (chronologie + brouillon). Aux tarifs de Claude Sonnet cela fait environ $0.30-0.90 par réclamation ; sur un ensemble de dossiers lourd avec Opus, $1.50-4. Des centimes aux dollars contre les heures de rédaction que cela compense.
Temps de paralégal / avocat — le gain. Un paquet de réclamation est couramment cité à 3-6 heures de rédaction de paralégal. Le skill produit la chronologie et le premier brouillon en minutes ; le paralégal vérifie et comble les ruptures, l’avocat révise et fixe le chiffre. L’économie réaliste est la moitié rédaction, pas la moitié révision — disons 2-4 heures par réclamation.
Temps d’installation — 45 minutes plus la rédaction du modèle et du playbook du cabinet (une ou deux heures uniques qui se rentabilisent sur chaque affaire).
Métrique de succès
Temps brouillon-à-avocat — temps d’horloge de « dossiers collectés » à « brouillon sur le bureau de l’avocat ». Devrait tomber de 1-2 jours (dans la file d’un paralégal) au jour même.
Taux de rapprochement des spéciaux — part des réclamations où le total de dommages spéciaux du skill correspond au total vérifié sans correction. Visez au-dessus de 90% ; les écarts pointent vers une lacune d’indexation des dossiers ou de parsing des factures, pas une raison d’abandonner le brouillon.
Profondeur d’édition de l’avocat — combien du brouillon survit jusqu’à la lettre signée. Suivez-la ; si le récit est réécrit en entier, le modèle ou les critères de sélection d’affaires ont besoin d’ajustement, pas le skill.
Face aux alternatives
Face à EvenUp Express Demands et services managés similaires. EvenUp combine rédaction par IA et rédacteurs humains et livre un paquet fini ; le délai annoncé est de 1-24 heures, bien que les cabinets rapportent une livraison sur plusieurs jours en pratique. Le compromis est le contrôle et la résidence des données : le service managé détient vos PHI et possède le playbook ; ce skill tourne sur votre propre Claude avec votre modèle et votre méthode de dommages, et le brouillon ne quitte jamais votre environnement. Utilisez le service managé quand vous voulez le paquet rendu fini et que vous êtes à l’aise avec les termes de données et de délai ; utilisez le skill quand vous voulez le brouillon en interne, aujourd’hui, sur votre propre méthodologie.
Face à Eve et aux plateformes de préparation complète d’affaire. Eve et les plateformes d’IA contentieuse travaillent toute l’affaire, pas seulement la réclamation. Si le cabinet veut l’évaluation d’affaire, l’analytique des ruptures de traitement et la préparation contentieuse en suite, c’est un achat de plateforme. Le skill est une étape de ce pipeline — le brouillon de réclamation — pour les cabinets pas prêts à acheter la plateforme.
Face au paralégal qui rédige de zéro. Le statu quo. Il produit la voix et le jugement du cabinet mais c’est le chemin le plus lent et celui qui varie le plus selon qui a rédigé. Le skill standardise le premier brouillon et la discipline de citation ; le jugement du paralégal se déplace vers la vérification et les cas limites.
Points de vigilance
Faits ou chiffres médicaux hallucinés. Une lettre de réclamation avec un diagnostic inventé ou une facture gonflée est une perte de crédibilité que l’assureur exploitera, et un risque de sanctions si elle atteint une écriture. Garde-fou : chaque entrée de chronologie, chaque ligne de dommages spéciaux et chaque affirmation de fait cite une page du dossier ; tout ce que le skill ne peut pas citer va sur la liste « données insuffisantes », pas dans la lettre. L’avocat vérifie contre les pages citées.
La fourchette de multiplicateur lue comme une évaluation. La bande de dommages généraux est de l’arithmétique sur le playbook du cabinet, aveugle au for, à l’historique de l’assureur, à la solidité de la responsabilité et aux limites de la police. Garde-fou : la sortie est une fourchette étiquetée avec la bande affichée, jamais un nombre unique ; l’avocat fixe la réclamation.
Exposition des PHI. Le skill traite des dossiers médicaux — des informations de santé protégées. Garde-fou : confirmez les termes de données du déploiement de Claude (posture zéro-rétention / sans entraînement, et un BAA là où votre programme de conformité l’exige) et que vos termes d’engagement client couvrent le traitement par IA avant qu’un dossier n’entre. Faites-le tourner sur un déploiement qui satisfait le programme HIPAA du cabinet ; jamais un endpoint grand public.
Ruptures de traitement et conflits de responsabilité enterrés. Un brouillon qui se lit proprement mais omet une rupture de traitement ou un conflit rapport-vs-client prépare l’avocat à être surpris par l’assureur. Garde-fou : les ruptures et conflits sont exposés dans la checklist de révision comme des marqueurs explicites, pas lissés dans le récit.
Factures manquantes comptées comme zéro. Si la facture d’un soignant est référencée mais absente du dossier, totaliser seulement ce qui est présent sous-estime les spéciaux et la réclamation. Garde-fou : les factures référencées-mais-manquantes sont signalées « à confirmer avant l’envoi » et exclues du total au lieu d’être devinées ; le paralégal les récupère avant que la réclamation ne soit finalisée.
Playbook périmé ou faux pour le for. Les plafonds de dommages, les règles d’honoraires et les exigences de notification pré-contentieuse varient par for et changent. Garde-fou : le fichier playbook est la seule source que le skill cite pour ses bandes ; révisez-le contre les règles en vigueur par affaire, et traitez les plafonds et exigences de notification comme confirmés par l’avocat, pas affirmés par le skill.
Stack
Le bundle vit dans apps/web/public/artifacts/demand-letter-drafter-claude-skill/ :
SKILL.md — la définition du skill
references/1-demand-letter-template.md — le squelette de lettre de réclamation du cabinet à remplacer par le modèle réel du cabinet
references/2-damages-playbook.md — la méthodologie de dommages du cabinet (bandes de multiplicateur, tarif journalier, notes de for)
references/3-medical-chronology-schema.md — le schéma du tableau de chronologie et le format de citation
Outils : Claude. Pour le motif d’extraction structurée derrière l’étape de chronologie, voir extraction de données de contrats. Outils adjacents dans le cluster dommages corporels : EvenUp, Eve.
---
name: demand-letter-drafter
description: Draft a first-pass personal-injury settlement demand letter from a case file (medical records, bills, wage-loss docs, police report, case notes). Build a cited medical chronology, itemize special damages, compute a general-damages range from the firm's playbook, and assemble the letter into the firm's template. Every figure cites a record page; unsupported claims go to an "insufficient data" list. Attorney review required — never sets the demand number, never sends.
---
# Personal-injury demand letter drafter
## When to invoke
Use this skill when a paralegal or attorney has a collected, text-readable PI case file and wants a first-draft demand letter — a cited medical chronology, itemized special damages, a general-damages range, and a letter assembled into the firm's template.
Do NOT invoke this skill for:
- **Setting the final demand number** — output is a range; the attorney sets the figure.
- **Disputed-liability or comparative-fault cases** — the demand is an advocacy document the attorney drafts; this skill is for clear-liability assembly work.
- **Litigation filings** — complaints, motions, discovery responses are court documents, out of scope.
- **Medical opinion** — the skill reports what providers wrote; it does not infer prognosis, causation, or permanency.
**Attorney review is required on every draft.** The skill assembles and cites; the attorney verifies every cited fact, sets the demand number, and signs.
## Inputs
- Required: `case_file_path` — directory of text-readable records (OCR'd PDFs, exports). Bills, medical records, wage-loss docs, police report, case notes.
- Required: `template` — path to the firm's demand-letter template (`references/1-demand-letter-template.md` is the starting skeleton).
- Required: `damages_playbook` — path to the firm's damages methodology (`references/2-damages-playbook.md`).
- Optional: `chronology_schema` — path to the chronology schema (`references/3-medical-chronology-schema.md`); defaults to the bundled schema.
- Optional: `client_account` — the client's written/recorded account of the incident, for the facts-conflict check.
## Reference files
- `references/1-demand-letter-template.md` — the firm's demand-letter skeleton.
- `references/2-damages-playbook.md` — multiplier bands, per-diem rate, jurisdiction notes.
- `references/3-medical-chronology-schema.md` — chronology columns and citation format.
## Method
Seven steps. Chronology before damages, because every special-damages line and every injuries-narrative sentence cites a chronology entry, and every chronology entry cites a record page.
### 1. Index the record set
Ingest every file. Build a page index keyed by document name + page so later citations resolve. List unreadable files (failed OCR, image-only, password-locked) in an `unprocessed` block — never silently skip them. Stop and report if the bills or the medical records are entirely absent; there is no demand to draft without them.
### 2. Build the dated medical chronology
One row per date of service, per the chronology schema:
| Date | Provider | Complaint / treatment | Billed | Record page |
- Sort by date.
- Flag treatment gaps over the playbook's gap threshold (default 30 days between consecutive visits) — adjusters use gaps to argue the injury resolved.
- Flag any entry where the date, provider, or billed amount is unreadable in the source — cite the page and mark `[illegible — confirm]`.
### 3. Itemize special damages
- **Medical specials** — total billed by provider, citing each bill page. Use billed amounts, not paid/adjusted, unless the playbook says otherwise (jurisdictions differ on the collateral-source and billed-vs-paid question — the playbook controls).
- **Wage loss** — from the documentation (employer letter, pay stubs, tax records), citing the page.
- **Out-of-pocket** — mileage, devices, co-pays, with citations.
- Flag bills referenced in records but missing from the file as `missing — retrieve before sending`. Exclude them from the total. Do not estimate a missing bill.
- Flag liens and unreconciled balances for attorney confirmation.
### 4. Draft the liability and facts narrative
From the police report and case notes, draft how the incident happened. Statements the report does not support are flagged, not written. If `client_account` is provided and it conflicts with the report, surface the conflict — do not pick one side.
### 5. Draft the injuries and treatment narrative
Grounded in the chronology: diagnosis, course of treatment, provider impressions, current status as the records state it. No prognosis, permanency, or causation language beyond what a provider wrote. If the firm wants a permanency argument, emit a flag: `permanency argument requires treating-physician statement — not in record`.
### 6. Compute the general-damages range
Per the playbook:
- **Multiplier method** — apply the severity band to the medical specials. Output `range_low = band_low × specials`, `range_high = band_high × specials`. Show the band.
- **Per-diem method** — if the playbook uses it, multiply the daily rate by the documented recovery period.
Output a labelled range, never a single number:
```
General damages (starting point — attorney sets the figure):
$X – $Y (2.5–4.0× medical specials of $Z, per playbook §severity-moderate)
```
### 7. Assemble the draft and the review checklist
Fill the firm's template. Leave the response-deadline line as a placeholder (`[ATTORNEY: set response deadline — commonly 30 days]`). Produce the review checklist alongside the letter (see Output format) so the attorney verifies in minutes.
## Output format
Two artifacts: the draft letter (firm template, filled) and the review checklist below.
```markdown
# Demand draft — {matter_id} — REVIEW CHECKLIST
⚠️ DRAFT. Attorney sets the demand number and confirms every cited fact. Not sent.
## Figures and citations
| Item | Amount | Source page |
|---|---|---|
| Medical specials — City ER | $4,210 | bills.pdf p.3 |
| Medical specials — Apex PT | $6,880 | bills.pdf p.7-9 |
| Wage loss | $3,100 | wages.pdf p.1 |
| **Special damages total** | **$14,190** | (sum, verified) |
| General damages range | $35,000–$57,000 | playbook §severity-moderate (2.5–4.0×) |
## Flags — resolve before sending
- ⚠️ Treatment gap: 41 days between ER (03-04) and first PT (04-14). records.pdf p.12.
- ⚠️ Missing bill: imaging referenced (records.pdf p.15) — no bill in file. Retrieve.
- ⚠️ Lien: hospital lien noted (records.pdf p.4) — confirm amount.
- ⚠️ Facts conflict: report says "stopped"; client account says "slowing." report.pdf p.2.
## Insufficient data — not written into the letter
- Permanency: no treating-physician permanency statement in record.
- Future medical: no life-care plan or future-treatment estimate in record.
## Provenance
- Case file: {path} ({N} files indexed, {M} unprocessed)
- Template: {path}
- Playbook: {path} §{section}
- Drafted: {ISO timestamp} · Skill v1.0 · {model}
```
## Watch-outs
- **Hallucinated facts/figures.** *Guard:* every figure and factual claim cites a record page; uncitable claims go to "insufficient data," never into the letter.
- **Range read as a valuation.** *Guard:* general damages is always a labelled range with the band shown; the attorney sets the number.
- **PHI exposure.** *Guard:* run only on a Claude deployment whose data terms (zero-retention, BAA where required) meet the firm's HIPAA program. Never a consumer endpoint.
- **Missing bills counted as zero.** *Guard:* referenced-but-absent bills are flagged and excluded, not estimated.
- **Jurisdiction-wrong playbook.** *Guard:* caps, fee rules, and notice requirements are attorney-confirmed; the skill cites the playbook, it does not assert the law.
# Demand-letter template (firm skeleton — replace with the firm's actual letter)
This is a starting skeleton. Replace it with the firm's real demand letter so the skill assembles into the firm's voice, section order, and boilerplate. Keep the `{{placeholder}}` tokens — the skill fills them. Everything else is the firm's prose.
The skill assembles into this template. It does not invent sections. If the firm's letter has a section this skeleton lacks (e.g. a punitive-damages paragraph, a UM/UIM section), add it here with its own placeholders.
---
**{{firm_letterhead}}**
{{date}}
{{adjuster_name}}
{{insurer_name}}
{{insurer_address}}
**RE:** Claim of {{client_name}} · Claim No. {{claim_number}} · Date of loss: {{date_of_loss}} · Your insured: {{insured_name}}
Dear {{adjuster_name}},
This firm represents {{client_name}} for injuries sustained in the {{incident_type}} of {{date_of_loss}}. This letter presents our client's claim and our demand for settlement.
## 1. Facts and liability
{{facts_narrative}}
<!-- Skill fills from police report + case notes. Statements unsupported by the report are flagged in the checklist, not written here. Report-vs-client conflicts are surfaced, not resolved. -->
## 2. Injuries and treatment
{{injuries_narrative}}
<!-- Skill fills from the medical chronology. Diagnosis, course of treatment, provider impressions, current status as the records state it. No prognosis/permanency/causation beyond what a provider wrote. -->
### Treatment chronology
{{chronology_table}}
<!-- The dated medical chronology, per references/3-medical-chronology-schema.md. -->
## 3. Damages
### Special damages
{{special_damages_itemization}}
<!-- Itemized, each line citing its source page. Missing/unreconciled items are flagged in the checklist and excluded here. -->
**Total special damages: {{special_damages_total}}**
### General damages
{{general_damages_narrative}}
<!-- The pain-and-suffering / non-economic narrative. The amount is the attorney's; the skill provides the range in the checklist, not in this paragraph, unless the firm's template states a number here (in which case the attorney inserts it). -->
## 4. Demand
Based on the foregoing, {{client_name}} demands **{{demand_amount}}** to resolve this claim in full.
<!-- {{demand_amount}} is left for the attorney. The skill never fills it. -->
This demand remains open until **{{response_deadline}}**, after which we reserve all rights, including filing suit.
<!-- {{response_deadline}}: attorney sets it. Commonly 30 days; jurisdiction and pre-suit notice rules vary — confirm. -->
Please direct all communication regarding this claim to this office.
Sincerely,
{{attorney_name}}
{{firm_name}}
**Enclosures:** {{enclosures_list}}
<!-- Medical records, bills, wage documentation, photographs, etc. The skill lists what it indexed; the attorney confirms the production. -->
---
## How to adapt this template
1. Paste the firm's actual demand letter over this skeleton.
2. Mark every spot the skill should fill with a `{{placeholder}}` token. The tokens above are the minimum set; add more (UM/UIM, future medicals, lien summary) as the firm's letter requires.
3. Leave `{{demand_amount}}` and `{{response_deadline}}` as placeholders the attorney fills — the skill is configured never to set them.
4. Keep boilerplate (reservation of rights, confidentiality, FRE 408 "for settlement purposes only" legend if the firm uses one) as fixed prose, not placeholders.
# Damages playbook (firm methodology — fill before first use)
The skill computes the general-damages range from this file and nothing else. If a band is not here, the skill refuses to produce a range rather than guessing. Fill every section with the firm's actual methodology and review it against current law per matter.
**This is methodology, not legal advice.** Multiplier bands, caps, and notice rules vary by jurisdiction and change. The attorney confirms the numbers in this file against current rules before they drive a demand.
## 1. Method selection
Choose the firm's default and when it switches:
- **Multiplier method** (default for most soft-tissue to moderate cases): general damages = band × medical specials.
- **Per-diem method** (use when the recovery period is long and well-documented, or when the firm prefers it for a venue): general damages = daily rate × documented recovery days.
State the rule for which method applies to which case type. The skill follows it.
## 2. Multiplier bands by injury severity
Common practice puts the multiplier in the 1.5–5× range, higher for severe or disfiguring injuries. Replace these placeholders with the firm's calibrated bands:
| Severity tier | Definition (firm's criteria) | Band (× specials) |
|---|---|---|
| Minor | Soft-tissue, full resolution < 90 days, no injections/surgery | 1.5 – 2.0 |
| Moderate | Soft-tissue with injections or extended PT, resolution 3–9 months | 2.5 – 4.0 |
| Serious | Fracture, surgery, or documented lasting limitation | 4.0 – 5.0 |
| Severe / catastrophic | Permanent impairment, disfigurement, TBI, spinal | attorney-set; multiplier insufficient |
For the severe/catastrophic tier the skill does NOT output a multiplier range — it flags the case as requiring attorney valuation. A multiplier on specials understates these.
## 3. Per-diem rate
- Daily rate: `${{per_diem_rate}}` (the firm's chosen rate; some firms anchor to the client's daily wage, others to a fixed figure — state which and why).
- Recovery period: documented start (date of loss) to documented end (release from care / maximum medical improvement as the records state it). The skill uses documented dates only — it does not estimate an end date.
## 4. Billed vs. paid
State the firm's position, because it changes the specials total the multiplier runs on:
- [ ] Use **billed** amounts (gross charges).
- [ ] Use **paid/adjusted** amounts.
- [ ] Per jurisdiction — note the rule and the venues where each applies.
Collateral-source rules and billed-vs-paid admissibility vary by jurisdiction. This is an attorney call; the skill applies whatever this section states.
## 5. Jurisdiction notes (attorney-maintained)
The skill cites this section; it does not assert the law. Maintain per venue the firm practices in:
- **Damages caps** — non-economic caps, if any, and the case types they apply to.
- **Pre-suit notice** — required notice periods (e.g. claims against government entities), and the deadline math.
- **Comparative fault** — the rule (pure / modified / contributory) and how the firm reflects it in the demand.
- **Statute of limitations** — for the deadline-awareness flag, not for legal advice.
## 6. Gap threshold
- Treatment-gap flag threshold: `{{gap_days}}` days (default 30). Gaps at or above this are flagged in the checklist for the attorney.
## How to update
Review §2 and §5 at least annually and whenever the firm enters a new venue. The skill's output is only as current as this file; a stale playbook produces a stale range.
# Medical chronology schema (citation format the attorney verifies against)
The chronology is the spine of the demand. Every special-damages line and every sentence of the injuries narrative cites a chronology row; every chronology row cites a record page. Keep the citation format identical to what the firm uses so the attorney verifies against the same references.
## Columns
| Column | Content | Rule |
|---|---|---|
| `Date` | Date of service (YYYY-MM-DD) | Sort ascending. Illegible date → `[illegible — confirm]` + page cite. |
| `Provider` | Treating provider / facility | As named in the record. No normalization that loses the source name. |
| `Complaint / treatment` | The visit's complaint and what was done | From the record only. No inferred diagnosis. |
| `Billed` | Billed amount for the date of service | Per the playbook's billed-vs-paid rule. `[no bill in file]` if records reference it but the bill is absent. |
| `Record page` | `document.pdf p.N` | Every row. A row with no citation is invalid — drop it to the checklist instead. |
## Citation format
`{document_name} p.{page}` — e.g. `records-apex-pt.pdf p.7`. For a page range: `bills.pdf p.7-9`. The skill reuses the exact filenames from the indexed case file so the attorney opens the same document.
## Worked row
| Date | Provider | Complaint / treatment | Billed | Record page |
|---|---|---|---|---|
| 2026-03-04 | City General ER | Neck/back pain post-MVA; X-ray, discharged | $4,210 | bills.pdf p.3 |
| 2026-04-14 | Apex Physical Therapy | Eval + start of PT, 2×/week | $880 | records-apex.pdf p.2 |
## Gaps and flags
- A gap between consecutive `Date` rows at or above the playbook's gap threshold (default 30 days) is flagged in the review checklist with both dates and the page cites bracketing the gap.
- An entry the skill cannot fully read (illegible billed amount, ambiguous provider) is kept in the chronology with the legible fields, the unreadable field marked `[illegible — confirm]`, and the page cited.
## What does NOT go in the chronology
- Prognosis, permanency, causation — unless a provider wrote it, and then it is quoted, not paraphrased into a stronger claim.
- Bills with no corresponding date of service in the records — those go to the checklist as `bill — no matching service date — confirm`, not into a chronology row.