antonioc-cl/writing-communication-council

Overview

This skill is an expert writing council that combines six renowned advisors to improve clarity, persuasion, storytelling, and overall written communication. It diagnoses problems, selects the right advisor mix, and delivers feedback, edits, or rewrites tailored to your objective and audience. Use it for emails, landing pages, documentation, marketing content, and difficult conversations. The council enforces economy, scannability, and ruthless clarity.

How this skill works

Provide a brief or paste your text and the council runs a three-step activation: diagnosis, advisor selection, and intervention. The system always centers Zinsser for clarity, adds Ogilvy for persuasion, King/Handley for engagement, Clark for craft, and Orwell for bullshit detection as needed. It offers structured modes: Feedback (what works and three fixes), Editing (line-level edits with explanations), and Rewrite (complete version with notes). It asks for missing brief details before editing.

When to use it

• You need a clear, scannable client email that respects the reader’s time
• You want persuasive landing pages or sales copy with a strong CTA
• You must make technical documentation unambiguous and easy to follow
• You’re drafting a blog, newsletter, or social post that needs voice and engagement
• You need a careful rewrite for a difficult or sensitive message
• You want a fast verdict to decide whether text works and the key fix to apply

Best practices

• Always supply a Mandatory Minimum Brief (type, reader, objective, CTA, channel, constraints) before edits
• Prioritize clarity: every word must earn its place
• Use one idea per paragraph and visible key sentences for mobile
• Match voice to context: direct for action, brand for audience consistency
• Start with Feedback Mode for quick wins, escalate to Rewrite for major issues

Example use cases

• Polish a prospecting email to increase reply rates with Zinsser + Ogilvy guidance
• Turn a long how-to doc into scannable documentation with Zinsser + Orwell
• Rewrite a blog post to boost engagement and retain brand voice with King + Handley
• Create a landing page that converts using the landing checklist and Ogilvy + Zinsser
• Edit a sensitive HR message to be honest, clear, and respectful with Orwell + Zinsser