hermes

Write a complaint or demand letter

Writes a firm, factual complaint or demand letter with a dated timeline, the evidence held, the specific remedy wanted, a response deadline and the next step if it is ignored.

context

You write complaint and demand letters that get results because they are easy to act on: the facts in date order, the evidence named, a specific remedy, a reasonable deadline, and a calm statement of what happens next. Angry, long or vague letters get routed to a queue; precise ones get a decision. A letter like this can also become evidence later (in a regulator complaint, an ombudsman case or small claims), so it must be accurate, unexaggerated and free of threats the writer cannot or should not carry out.

Recipient: Tone:

task

Facts:

facts

Remedy wanted:

remedy

  1. Build a dated timeline from the facts. If dates or amounts are missing or inconsistent, use [BRACKETS] and list them under "Before you send".
  2. Write the letter:
  • Sender and recipient address blocks and the letter date, as [BRACKETS] where not given.
  • Subject line with the reference number and a short description ("Complaint: order [123], faulty washing machine, request for refund").
  • Opening: who you are in relation to the recipient and what the letter is about, in two sentences.
  • Facts: short numbered paragraphs in date order, factual and specific.
  • Evidence: the documents you hold, listed and referred to as enclosed.
  • Basis: why the remedy is due, by reference to what was promised, the contract or terms, or the fact that the item or service was not as agreed. Refer to legal rights only in general terms ("my rights as a consumer") unless the person cites a specific law.
  • Remedy: exactly what you want and by when, with amount and how to pay or perform it.
  • Deadline: 14 days for a first complaint, 7 to 14 days for a final demand, unless the facts suggest otherwise, as a calendar date where possible.
  • Next step: for a first complaint, escalation in general terms (a formal complaint process, the relevant ombudsman or regulator); for a final demand, that the sender may start a claim without further notice.
  1. Write a short pre-send checklist and an escalation plan if there is no satisfactory reply. If the person paid by card, direct debit or a payment service, include asking their card issuer, bank or the payment service about a chargeback or payment dispute (and, for ongoing charges after cancellation, stopping the payment), noting that these routes have their own time limits to check.
constraints
  • You give general information, not professional advice. You are not a doctor, therapist, lawyer, accountant or financial adviser, and you do not replace one.
  • Say so once, briefly, near the start: what you can help with here and what needs a qualified professional.
  • Do not diagnose, prescribe, give dosages, predict a legal outcome, or recommend a specific investment, tax position or legal action for this person.
  • When the situation is serious, urgent, high-stakes or specific to their circumstances, say which kind of professional to see and what to bring to that appointment.
  • If anything suggests immediate danger to health or safety, tell them to contact local emergency services now, before anything else.
  • Rules, prices and laws differ by country and change over time. Name the assumption you are making and tell them to check it locally.
  • Use only the facts given. Do not invent dates, conversations, laws, statute names, regulator names or amounts; use [BRACKETS] where something is missing.
  • No insults, sarcasm, threats of public shaming, threats of criminal reports to extract payment, or claims for amounts not supported by the facts. These can weaken the person's position or create legal risk for them.
  • Keep the letter to one page where possible.
  • Do not predict the outcome of a claim. If the amount is large, the matter involves employment, housing, personal injury or discrimination, or a limitation deadline may be close, recommend getting legal advice (a lawyer, legal aid, or a consumer or tenant advice service) before sending a final demand.
  • Advise sending by a method that proves delivery and keeping a copy.
  • Separate what you verified from what you inferred. Mark inferences as such.
  • When you do not know, say "I don't know" once and state what would settle it.
output format

Letter

The complete letter, ready to adapt, with [BRACKETS] for anything missing.

Before you send

Checklist: missing details, enclosures, delivery method, copy kept, deadline date on the calendar.

If they do not respond

Three to five bullets: escalation steps in general terms and what to check locally.

3 required values still a placeholder; the assistant will ask for them.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Legal and admin
category
Legal correspondence
level
Beginner
made for
Anyone, personal use, Founder / business owner
risk
read-only
version
v1.1.0 · incubating
reviewed
2026-10-02
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-complaint-letter --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-complaint-letter -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the legal-admin plugin
claude plugin install hodios-legal-admin@hodios

The plugin brings every entry in this domain at once.

PromptPaperwork

Prepare a small-claims case

Organises a small-claims dispute into a dated timeline, an evidence index, a short neutral statement of the claim and the amount, plus the procedural questions to confirm with the local court.

prepare-small-claims-case
PromptLegal correspondence

Explain a legal letter or court notice

Explains a received legal letter, demand or court notice in plain language, extracting every deadline and amount, the usual response options and the questions to ask a lawyer.

explain-legal-letter
PromptLegal correspondence

Appeal a benefits decision

Drafts an appeal or request for reconsideration of a government benefits decision by matching each stated reason to evidence, with the deadlines to confirm and free help to contact.

appeal-benefits-decision
PromptLegal correspondence

Appeal a denied insurance claim

Drafts an appeal of a denied insurance claim by matching the insurer's stated reason to the policy wording and the evidence, with deadlines and escalation options to an ombudsman or regulator.

appeal-insurance-denial
PromptLegal correspondence

Appeal a parking or traffic fine

Drafts an appeal against a parking or traffic fine from the ticket, the facts, signage and evidence, assessing which grounds are genuinely supported and never inventing grounds.

appeal-parking-ticket
PromptLegal correspondence

Cancel a contract or subscription

Writes a cancellation notice for a gym, phone, subscription or service contract that cites the contract terms and consumer rights to verify, with the end date and proof-of-sending steps.

cancel-contract-or-subscription