draft-letter
Drafts correspondence for a matter using templates and matter data. Use when Mandy says 'draft letter', 'write to', 'letter to insurer', 'notice of involvement', 'treatment dispute', 'client update',
SKILL.md.claude/skills/draft-letter/SKILL.md
GitHubDraft Letter
Important
- Manual-only. Never auto-invoke.
- ALWAYS save letter to disk BEFORE displaying to Mandy.
- ALWAYS cite specific Act sections from
rules/files — never guess. - Consult
letter-routing.mdto determine which template to use.
Instructions
Step 0: Resolve Matter
Follow _shared/resolve-matter.md. If only letter-type given (e.g., "/draft-letter notice-of-involvement"), resolve matter from conversation context.
Step 1: Determine Letter Type
If specified: use directly.
If unclear: consult letter-routing.md for mapping. Present available types grouped by recipient.
Step 2: Gather Data
- Read
matter.jsonfully - Read template from
templates/{recipient}/{letter-type}.md - Read
rules/{claim_type}.mdfor legislative section numbers - Check template
[DOCUMENT-TIER:]marker — read extracts accordingly - Read
templates/letterhead.jsonfor firm details
Step 3: Check Previous Versions
If letters/ contains a file with same letter type: this is a redraft.
Rename old file to {type}-{date}-v{n}.md, update status to "superseded".
Step 4: Draft
- Replace all
{{variables}}with matter.json data - Follow
[INSTRUCTION:]blocks for generated content - Apply
[TONE:]marker - Fill
[CITE:]markers with actual section numbers from rules/ - Tier 2: reference specific document findings with page numbers
- Follow
reference/style-guide.mdfor formatting
Step 5: Save and Update
- Save to
letters/{letter-type}-{date}.md - Update
matter.jsonletters array: status "draft", date_created, version - Update
matters/index.jsonl - Append to
activity-log.jsonl git -C matters/ add -A && git -C matters/ commit -m "draft-letter: {id} — Drafted {letter-type} to {recipient}."
Step 6: Present and Prompt
Display the letter. Then:
"Review this draft. You can:
- Request changes (tell me what to adjust)
- /approve-letter {name} {filename} — mark ready to send
- /send-letter {name} {filename} — approve and send via Outlook"
Step 7: Proactive Stage Check
Check rules/stage-expectations.json and dates.limitation_expiry.
Error Handling
- Template not found: "No template found for '{letter-type}'. Available types:" then list from letter-routing.md.
- Missing matter data for template variable: "matter.json is missing {field}. Update with
/update-matterfirst, or provide the value now." - Rules file missing: "Cannot find rules/{claim_type}.md. Legislative references will be incomplete."
Example
/draft-letter chen treatment-rejection-dispute
→ Resolve: WC-2026-012 (Sarah Chen)
→ Template: insurer/treatment-rejection-dispute.md
→ Tier 2: read relevant extract sections
→ Draft with legislative citations from rules/workcover.md
→ Save to letters/treatment-rejection-dispute-2026-03-28.md
→ Present and prompt for review