hermes

Clear up a misunderstanding

Writes a message that clears up a misunderstanding, covering what you meant, what they likely heard, the part you own and a way forward, without over-apologising.

context

Clearing up a misunderstanding goes wrong in two opposite ways. One is defensive: "you misunderstood", "that's not what I said", "I'm sorry you took it that way", which tells the other person their reaction is the problem. The other is grovelling: apologising so much for an honest misunderstanding that it sounds like guilt, and makes them comfort you. What works is short: acknowledge what they heard and why that was a reasonable reading, say once what you meant, own the specific part that was yours (ambiguous wording, the wrong channel, poor timing), and move forward with a question or next step. It also matters to check that it really was a misunderstanding; if the words meant what they heard, it needs an apology, not a clarification.

task

Help me clear up this misunderstanding by Only if [RELATIONSHIP] is given: with .

what happened

what you meant

  1. Read the situation honestly: what they most likely heard, why that reading was reasonable, and what my part was. If what I meant was in fact close to what they heard, or my words caused real hurt whatever I intended, say so plainly and recommend an apology instead of a clarification; give a short apology rather than this message.
  2. Draft the message or, for in person, a few short opening lines:
  • acknowledge what they understood and that it makes sense they reacted that way;
  • say once, plainly, what I meant;
  • own my specific part in one sentence ("My wording was unclear", "I should have said this privately"), without a string of apologies;
  • a way forward: a question to check how it lands, a correction to the record if others saw it, or the next practical step.
  1. If the original was public (a group chat, a meeting, an email to several people) and it affected how others see them, suggest a short public correction as well and draft it.
  2. Give a shorter version.
  3. List phrases to avoid in this situation and why.
  4. Give two or three lines for if they are still upset: listen first, do not re-explain, and offer to talk in person or later.
constraints
  • One clear apology at most, for my part, if any. No "sorry if", "sorry you felt", or self-criticism beyond what fits.
  • Do not tell them what they felt or why; say what I understand they heard.
  • Keep it proportionate: a minor misunderstanding gets two or three sentences.
  • Match my voice and the relationship; no corporate language with a partner, no slang with a client.
  • Do not invent details of what was said.
output format

Read of the situation

Two to four lines: what they likely heard, why it was reasonable, my part, and whether this is a misunderstanding or needs an apology.

Message

In a quote block, or opening lines for in person.

Shorter version

In a quote block.

Avoid

Two to four bullets: phrase, then why.

If they are still upset

Two or three lines.

2 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
Writing and communication
category
Interpersonal communication
level
Beginner
made for
Anyone, personal use, People manager, Parent / caregiver
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-03
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 clear-up-misunderstanding --target claude-code

This entry is in the full catalog, not the curated set the skills installer and plugins carry, so install it with the Hodios CLI.

PromptInterpersonal communication

Apologise effectively

Writes a sincere apology that names the specific impact, owns it without excuses or conditional wording, offers repair and says what will change, fitted to the relationship and channel.

apologize-effectively
PromptInterpersonal communication

Decode the tone of a message

Reads a message someone received and lays out the plausible readings of its tone and intent, separates what is said from what is inferred, and shows how to check before reacting.

decode-message-tone
PromptInterpersonal communication

Reply to a tricky message

Drafts replies to an awkward personal text or chat, such as a friend's request, a family dig, a date or a group-chat flare-up, in two or three tones and says what each one signals.

reply-to-tricky-message
PersonaInterpersonal communication

Communication coach

Communication coach who helps people say hard things clearly and kindly, rehearses real conversations with them, and teaches listening as much as speaking, at work and at home.

communication-coach
PromptInterpersonal communication

Give feedback with SBI

Turns a reaction into specific, kind feedback using situation, behaviour and impact, adds a clear request and an invitation to respond, and strips out judgements and assumed motives.

give-feedback-sbi
PromptInterpersonal communication

Mediate a disagreement

Mediates a disagreement neutrally by restating each position fairly, finding the interests underneath, separating factual from value differences and proposing options both sides can accept.

mediate-disagreement