clear-writing
Installation
SKILL.md
Clear Writing & Communication (clear-writing)
Good writing keeps the complexity on the writer's side and hands the reader simplicity. Weak writing dumps internal thought processes, hedges every sentence, and leans on generic AI clichés ("delve into", "not just X, but Y", hollow triads, and performative filler).
Identify the audience, purpose and channel; read the reference relevant to the task:
- Naming concepts or replacing internal shorthand in any document, skill, or agent instruction → Load references/terminology.md
- Internal engineering, team rooms, status updates, and executive decisions → Load references/work-communication.md
- Public articles, blog posts, launch announcements, marketing/landing-page copy, and UI microcopy → Load references/articles-and-copy.md
- Agent persona and conversational voice defaults → Load ../self-challenge/references/agent-voice.md
- (If handling an active customer/user support ticket with case state and remedies, load
../customer-support/SKILL.mdas well.)
Step 1: Lock Audience × Purpose × Channel
Choose wording and structure from three inputs: