MCPInstall

written-communication

Help users master professional writing to bridge gaps between stakeholders, scale their leadership influence, and ensure organizational clarity through structured narratives and async-first norms.

Installs
2.2K
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/refoundai/lenny-skills --skill written-communication
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads written-communication automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Written Communication for Leaders

Scale your influence and drive alignment through structured, clear, and persuasive writing.

Help the user with written communication for leaders using insights from 12 guests and posts across Lenny's Podcast and Newsletter.

How to Help

  1. Framework application - Guide the user in applying the SCR or Minto Pyramid frameworks to their current draft.
  2. Narrative sharpening - Help the user identify and lead with their primary conclusion to ensure executive clarity.
  3. Tone and conciseness - Review drafts to remove fluff, strengthen logic, and adapt the tone for the intended audience.
  4. Process design - Assist in establishing async communication norms or structured feedback loops for the team.

Core Principles

Write for Personal Mastery

Julian Shapiro: "They're forcing functions for me to hold myself accountable and to be thorough when learning something for my own benefit. That's all they are. Basically if I want to go learn growth or writing well or some other topic, I will go ahead and do a ton of research, read everything I can get my hands on, do a ton of experimentation to try to build a set of novel insights that you couldn't find from other people's research hopefully, and then the next stage is try to make it as concise and actionable as possible so that I can reference it for my own selfish benefit."

Use writing as a selfish tool for your own learning to ensure the resulting work is thorough and high quality.

Scale Influence via Documentation

Kevin Yien: "writing is clarity at scale, and a key component to a PM's job is creating clarity both i"

Effective writing is a primary tool for maintaining clarity and alignment across an entire organization simultaneously.

Standardize Narrative Frameworks

From "The Minto Pyramid Principle and the SCR Framework": "If you simplify this further, there are three parts to every narrative: Situation, Complication, Resolution. 1. Situation: What is the state of affairs today. Facts, data, and unambiguous background. 2. Complication: What has changed that requires action. What is the problem? 3. Resolution: What we need to do to resolve this complication."

Structure business communications around a Situation, Complication, and Resolution to provide necessary context before proposing solutions.

Establish Shared Situations

From "Essential reading for product builders—part 2": "The best executive communication starts with the state of affairs. It’s fact-based, unambiguous. It’s totally not controversial. No matter what side of an issue or a hard choice you’re on, you should be able to read the situation and go, ‘That pretty much sums it up.’"

Achieve executive level clarity by starting with a non-controversial set of facts that everyone can agree on before introducing complications.

Templates & Frameworks

  • SCR (Situation-Complication-Resolution) Framework (The Minto Pyramid Principle and the SCR Framework) - A narrative structure for business communication derived from the universal story arc. Provides context before the recommendation to avoid being too abrupt. Als
  • The Minto Pyramid Principle (The Minto Pyramid Principle and the SCR Framework) - A communication framework developed by Barbara Minto at McKinsey for structuring persuasive business arguments. Instead of building up from data to conclusions
  • 6-Part Ask Template (On asking for help (even when you really don’t want to)) - A structured template for making effective help requests in professional contexts. Can be adapted based on relationship strength, goal overlap, and recipient ex
  • Writing Quality Improvement Checklist (500,000) - Actionable steps for improving newsletter writing quality based on Lenny's experience and three recommended books
  • The Executive Editor GPT (How to become a supermanager with AI) - A custom GPT that grades written communications (emails, decks, Slack messages) on structure, clarity, level of detail, and tone, and provides actionable improv
  • TLDR + Context Message Structure (Wes Kao) - A format for written business communication that puts the most important point at the top followed by optional context below
  • Using AI as a Writing/Editing Partner (Seth Godin) - Seth's specific process for using Claude as an editorial assistant while maintaining authorial voice.
  • Combined SCR + Minto Pyramid Framework (The Minto Pyramid Principle and the SCR Framework) - The integration of both frameworks: SCR provides the narrative wrapper, and the Minto Pyramid structures the Resolution section specifically.

See references/artifacts.md for the full list with details.

Questions to Help Users

  • "Who is the primary audience for this document, and what is the one thing you need them to do after reading?"
  • "What is the shared, non-controversial Situation that everyone involved can agree on?"
  • "If you had to put your main recommendation in the first sentence, what would it say?"
  • "What are the specific areas where you need critical feedback versus just general awareness?"
  • "Which supporting data or facts might be missing that would strengthen your Resolution?"
  • "How can we transition this update from a synchronous meeting to an asynchronous document?"

Common Mistakes to Flag

  • Leading with the discovery process - Busy stakeholders care about the conclusion first and the discovery process second.
  • Burying the ask - Unclear requests create friction and delay the help or decisions you need to move forward.
  • Ignoring the Situation - Proposing solutions without shared context leads to misalignment and unnecessary debate over the problem itself.
  • Over-reliance on AI generation - Using AI without a strict planning phase results in generic content that lacks your unique perspective and authority.

Deep Dive

For all 13 sourced insights from 12 guests, see references/guest-insights.md

Related Skills

  • Product Reviews
  • Executive Communication
  • Managing Up
  • Running Meetings

FAQ

What does the written-communication skill do?

Help users master professional writing to bridge gaps between stakeholders, scale their leadership influence, and ensure organizational clarity through structured narratives and async-first norms.

How do I install written-communication?

Run npx skills add https://github.com/refoundai/lenny-skills --skill written-communication in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/written-communication/ (personal) or .claude/skills/written-communication/ (project).

Which AI agents can use written-communication?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is written-communication safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains written-communication?

It is published by refoundai in refoundai/lenny-skills. It has 2,196 recorded installs.

More from refoundai/lenny-skills

View all →

personal-productivity

refoundai/lenny-skills

Help users manage their time and tasks more effectively. Use when someone is overwhelmed with work, struggling with focus, trying to balance multiple responsibilities, or asking how to get more done.

writing-prds

refoundai/lenny-skills

Help users transform abstract ideas into actionable project specs that align engineering and design teams on the problem and success metrics.

Docs & Writing3.3K installs

ai-product-strategy

refoundai/lenny-skills

Help users decide where to apply AI effectively, manage the transition from deterministic to probabilistic software, and build long-term defensibility through verticalization and proprietary data.

2.7K installs

competitive-analysis

refoundai/lenny-skills

Help users understand and respond to competition. Use when someone is positioning against competitors, evaluating market threats, running competitive war games, or deciding how much to focus on competitors versus customers.

2.7K installs

founder-sales

refoundai/lenny-skills

Help users master the transition from product development to active selling by leveraging their unique status as founders to bridge the trust gap and define a scalable sales motion.

Business & Finance2.7K installs

analyzing-user-feedback

refoundai/lenny-skills

Help users convert massive volumes of qualitative and quantitative feedback into high-confidence product decisions through rigorous synthesis and internal immersion.

2.6K installs

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs