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.