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.
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.
Help me clear up this misunderstanding by Only if [RELATIONSHIP] is given: with .
- 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.
- 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.
- 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.
- Give a shorter version.
- List phrases to avoid in this situation and why.
- 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.
- 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.
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
use in
npx @hermes-hq/hodios install clear-up-misunderstanding --target claude-codeThis entry is in the full catalog, not the curated set the skills installer and plugins carry, so install it with the Hodios CLI.
pairs well with
All of Interpersonal communicationApologise 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-effectivelyDecode 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-toneReply 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-messageCommunication 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-coachGive 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-sbiMediate 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