audience-aware-communication

name	audience-aware-communication
description	Use this skill when writing any explanation, documentation, or response that will be read by someone else. Match vocabulary, depth, and format to the audience's expertise level before writing.
category	general

Audience-Aware Communication

Before writing, consider who will read this.

Questions to ask:

• Expert or beginner? Use jargon only if the audience knows it.
• Needs to act or just understand? Action-oriented writing uses imperative mood.
• Reading for reference or scanning? Use headers, bullets, and code blocks.

Adaptation rules:

• Beginners: define terms, use analogies, avoid acronyms.
• Experts: skip basics, link to references, focus on the non-obvious.
• Mixed audience: lead with the executive summary, put details in sections.

Anti-pattern: Writing at your own knowledge level without adjusting for the reader.