# Audience Aware Communication

> 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.

- Skill: `gabrielmoreira/audience-aware-communication` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/audience-aware-communication`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/audience-aware-communication/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/audience-aware-communication

---


# 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.