SuperAPI AI Directory

communication-clarity-audit

General & other

View repository

Updated 10-15 22:15

About this skill

Communication Clarity Audit

Most clarity failures are invisible to the sender because the sender knows what they meant. The receiver does not have that context, and the gap between what was meant and what is read is where miscommunication lives. This audit finds that gap by reading the message as the receiver would — without access to the sender's intent.


Your Process

Step 1: Read from the Receiver's Perspective Do not read this as the writer who knows what was meant. Read it as someone receiving it cold. What is actually on the page? This requires a deliberate perspective shift — it is the hardest step and the most important one.

Step 2: Structure Check Can the main point be identified within 10 seconds? If not, the structure is obscuring it. Is the structure serving the reader or the writer's thinking process? The two are often different.

Step 3: Jargon Inventory List every term or acronym that requires context the reader may not have. Each one is a potential comprehension failure. Include terms that feel obvious — "obvious" is always relative to what the writer knows.

Step 4: Assumption Inventory What must the reader already know or believe for this message to make sense? State each assumption explicitly. For each: does this reader have this context? If not, the message has a gap.

Step 5: Ask — Is It Clear? Is there a clear action or next step? Is it clear who does what, by when? A message that informs without directing produces nothing. A message that directs ambiguously produces the wrong thing.

Step 6: Name the Most Likely Misreading State the single most plausible way this message will be misread or misunderstood by a reasonable receiver. This is the most valuable output — it is the failure that will actually happen if the message is sent as written.


Human Check-in

Before proceeding, use the AskUserQuestion tool:

  • Question: "How do you want to run this?"
  • Header: "Scope"
  • Options:
    • Full analysis — Complete all steps, reasoning shown throughout
    • Key findings only — Bottom-line output, skip step-by-step detail
    • Breakpoints only — Where this message will be misread or lost, skip what's already clear
    • Refine the framing — Adjust what we're analyzing before starting

Proceed based on their selection.

Output Format

Issues found:

Category Issue Severity (High/Med/Low) Edit
Structure
Jargon
Assumptions
Ask/Action

Most likely misreading:

[Concrete statement of how a reasonable receiver will misread this — and what they will do or believe as a result]

Priority edits:

  1. [Highest-impact change]
  2. [Second highest]
  3. [Third]

Notes

A single clear next step with a named owner and a deadline eliminates more miscommunication than any amount of structural or vocabulary editing. If the ask is ambiguous, fix that before anything else.


What's Next

After delivering this output, use AskUserQuestion to offer the next move:

  • Question: "Clarity audited. What's next?"
  • Header: "Next"
  • Options:
    • /writing-line-editing — Fix the clarity issues the audit identified
    • /communication-objection-mapping — Address the objections hiding behind confusing points
    • /writing-restructure — Restructure if the clarity issues are structural
    • Done — Wrap up and synthesise what we have so far