written-communication

Synthesize written communications using the Pyramid Principle with conclusions first.

Updated Mar 15, 2026

Search Tags:#writing #editing #communication #clarity #conciseness #pyramid-principle #memo-writing

Ready to run

npx skills add https://github.com/cvillamarp-lgtm/skillspodcast --skill written-communication-cvillamarp-lgtm

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: written-communication
Source: https://github.com/cvillamarp-lgtm/skillspodcast/tree/main/skills/written-communication
Command: npx skills add https://github.com/cvillamarp-lgtm/skillspodcast --skill written-communication-cvillamarp-lgtm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Written communication clarity and conciseness are essential for effective product teams and organizations. This Skill helps users craft messages that are clear, persuasive, and actionable, reducing miscommunication and rework.

Core Features & Use Cases

Apply the Pyramid Principle: lead with the conclusion and support it with logical reasoning.
Cut ruthlessly: eliminate unnecessary context and filler to improve reader comprehension.
Two-way writing: draft memos, emails, strategy docs, and announcements that readers can act on, building internal clarity and alignment.
Real-world application: use for weekly updates, project memos, incident notes, and executive summaries.

Quick Start

Create a concise memo that starts with the main conclusion and uses a clear, logical progression to the supporting points.

Frequently Asked Questions about written-communication

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I write a clear and persuasive memo using the Pyramid Principle?▼

The Pyramid Principle improves written communication by placing the conclusion at the very top, followed by supporting logical arguments. This structure reduces reading time and ensures immediate comprehension of actionable insights.

What is the best way to edit emails and strategy documents for conciseness?▼

Editing for conciseness requires ruthlessly removing unnecessary context and filler words. This strips down emails and strategy documents to their core actionable messages, significantly improving overall reader comprehension.

How do I structure an executive summary so readers can act immediately?▼

Structure an executive summary by leading with the main conclusion and organizing supporting points in a clear, logical progression. This top-down approach builds internal alignment and allows readers to make decisions without searching for key takeaways.

Can I use this approach for weekly project updates and incident notes?▼

Yes, this approach works effectively for weekly project updates, incident notes, and announcements. Applying logical progression and eliminating fluff ensures these communications remain clear, persuasive, and actionable for your team.

Why does leading with the conclusion reduce miscommunication in strategy documents?▼

Leading with the conclusion reduces miscommunication by immediately clarifying the document's purpose. When readers understand the main takeaway first, they interpret supporting details accurately and require less rework or clarification.