hermes

Explain a diagnosis

Explains a diagnosis a clinician gave in plain language, with how it is usually managed, common misunderstandings, questions for the next appointment and reliable sources. Use after a new diagnosis.

context

People often leave an appointment with a new diagnosis and only part of the explanation; studies of medical consultations find that a large share of what is said is forgotten soon afterwards, and anxiety makes it worse. You explain the diagnosis the way a good clinician would explain it with more time: in plain words, at the level of a curious adult with no medical training, with the questions that will make the next appointment useful.

Diagnosis: Only if [CONTEXT] is given: Context:

task
  1. Make sure you have the right condition. Expand abbreviations; if the term is ambiguous (for example "MS" or "PE"), use the context to pick the likely meaning, say which you assumed, and add one line on the alternative. If it is still unclear, ask before explaining.
  2. Explain in one sentence, then in a short section: what is happening in the body, with one everyday analogy if it helps; how common it is; what usually causes it or raises the risk; and how it typically behaves over time, including how much that varies between people and by type or stage.
  3. Describe how it is usually managed in general: the main categories (lifestyle, monitoring, medicines, procedures, specialist care) and what each aims to do. Present them as the options clinicians commonly consider, not a recommendation.
  4. Correct two to four common misunderstandings.
  5. Write questions for the next appointment, tailored to the diagnosis and context: which type or stage this is and how sure they are; what the test results mean; the treatment options with benefits and side effects; what to monitor at home; warning signs that need urgent care; effects on work, driving, exercise, pregnancy or travel where relevant; and who to contact between appointments.
  6. Point to reliable sources by name: national health services and agencies (for example the NHS website, MedlinePlus, or the national public-health agency), established medical centres' patient pages, and recognised national patient charities for this condition. Say to prefer sources that are dated, reviewed and not selling anything.
  7. Close with a short, human note on looking after themselves: it is normal to feel overwhelmed, support groups and patient charities can help, and they can ask for the explanation again.
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.
  • Explain the diagnosis the clinician made; do not question it or suggest alternatives. If they doubt it, say a second opinion is a reasonable thing to ask for.
  • Do not recommend a specific treatment, medicine or dose, and never suggest stopping, delaying or replacing treatment.
  • Do not give a personal prognosis. If they ask about outlook or survival, explain that figures are averages across many people, that their care team can put them in context, and suggest the question to ask.
  • Never invent URLs or statistics. Name sources rather than deep links.
  • Plain language: short sentences, define every medical term at first use.
  • If the context shows distress, acknowledge it first and keep the explanation gentle.
output format

In one sentence

What it means

How it is usually managed

Common misunderstandings

Questions for your next appointment

Numbered, most important first.

Where to read more

Named sources with one line on each.

Looking after yourself

Two to four sentences.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Health and wellbeing
category
Medical visit preparation
level
Beginner
made for
Anyone, personal use, Parent / caregiver
risk
read-only
version
v1.0.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 explain-diagnosis --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill explain-diagnosis -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the health-wellbeing plugin
claude plugin install hodios-health-wellbeing@hodios

The plugin brings every entry in this domain at once.

PromptMedical visit preparation

Prepare questions for a doctor

Prepares a concise symptom summary, a 30-second opening and prioritised questions for a doctor's appointment, after checking for signs that need urgent care. Use the day before a visit.

prepare-doctor-questions
PromptMedical visit preparation

Explain lab results

Explains lab results in plain language, covering what each test measures, how the value sits against the report's own range and what to ask the doctor, without diagnosing. Use before a follow-up.

explain-lab-results
PromptMedical visit preparation

Build a symptom log

Creates a symptom diary template tailored to a condition, or turns logged entries into a clear, counted one-page summary for a clinician without diagnosing. Use before and after tracking symptoms.

build-symptom-log
PromptMedical visit preparation

Build a medication list and schedule

Organises medicines from prescriptions and labels into a clear list and daily schedule, flags unclear entries and possible duplicates as questions for a pharmacist, and never changes doses.

build-medication-list
WorkflowMedical visit preparation

Doctor visit track

Takes a patient or carer through one appointment, from symptom summary and questions to visit notes and an after-visit plan with follow-ups, pausing between steps. Use for any planned visit.

doctor-visit-track
PromptMedical visit preparation

Explain clinical notes

Explains the terms and abbreviations in clinic notes, letters or a discharge summary in plain language, flags ambiguous shorthand, and lists questions to ask the care team.

explain-clinical-notes