written-communication

Draft concise written messages with intent, audience calibration, and risk checks.

104|7|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/manager-dot-dev/manager-skills --skill written-communication-manager-dot-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: written-communication
Source: https://github.com/manager-dot-dev/manager-skills/tree/main/skills/written-communication
Command: npx skills add https://github.com/manager-dot-dev/manager-skills --skill written-communication-manager-dot-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Engineering managers often struggle to turn intent into messages that stakeholders read, understand, and act on; this Skill reduces miscommunication, over-explanation, and avoidable friction in async and written updates.

Core Features & Use Cases

  • 3-Step Writing Framework: Prepare, Write Simply, Run a Garbage Collector to produce concise, goal-oriented messages.
  • Async Re-Explanation Trap: Tactics for responding to missed messages without shaming, and for preventing repeated misreads.
  • Compression/Decompression Model: Diagnose whether a message failed due to over-compression or over-explanation and how to fix it.
  • Default Response Shape: Returns intent, audience calibration, a ready-to-send draft, a short rationale, and a risk check.
  • Use Cases: Drafting team announcements, policy changes, stakeholder updates, and diagnosing misunderstood messages in Slack or email.

Quick Start

Draft a concise announcement to my engineering team explaining a change to the pull request policy, including intent, audience calibration, a ready-to-send draft, a short explanation of why it works, and a brief risk check.

Frequently Asked Questions about written-communication

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I draft asynchronous Slack messages that stakeholders actually read and act on?

To draft asynchronous Slack messages that land, use a three-step framework: Prepare your intent, Write Simply, and Run a Garbage Collector to trim excess. This produces concise, goal-oriented updates calibrated for your specific audience.

Why does my written communication get misunderstood by my engineering team?

Your written communication may be misunderstood due to over-compression or over-explanation. A compression/decompression diagnostic model helps identify whether your message lacked necessary context or included too much noise, allowing you to adjust the wording accordingly.

What is the best way to announce a policy change to my engineering team without causing confusion?

The best way to announce a policy change is to return a draft containing intent, audience calibration, concise wording, rationale, and risk checks. This structured approach aligns teams and reduces avoidable friction in async updates.

How do I respond when someone misses the point of my message without shaming them?

To respond to missed messages without shaming, apply the Async Re-Explanation Trap guidance. This provides tactics for re-explaining your intent clearly and preventing repeated misreads in async communication channels.

Can I use this writing framework for stakeholder updates and team announcements?

Yes, you can use this framework for stakeholder updates and team announcements. It applies to engineering managers drafting messages across various contexts, ensuring updates are concise, audience-calibrated, and structurally sound.

When should I not use a concise writing approach for written updates?

You should avoid over-compressing written updates when the audience lacks context, as diagnosed by the compression/decompression model. If a message fails due to missing critical details, a more explanatory approach is needed to prevent misunderstandings.