mcpbeat Sign in

Written Communication Skill for Claude

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.

13k tokens
context cost
the whole folder, loaded on every use
3
files
instructions only
0
copies elsewhere
how many repositories repackaged it
1215
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/RefoundAI/lenny-skills --skill written-communication

What comes with it

46 922 bytes besides the instruction
references/artifacts.md
references/guest-insights.md

The instruction itself

12 sections, as written by the author

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

  • Framework application - Guide the user in applying the SCR or Minto Pyramid frameworks to their current draft.
  • Narrative sharpening - Help the user identify and lead with their primary conclusion to ensure executive clarity.
  • Tone and conciseness - Review drafts to remove fluff, strengthen logic, and adapt the tone for the intended audience.
  • 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

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

Other skills for the same job

different authors, same section of the catalogue
Doc Coauthoring
by anthropics
vendor ×10

Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.

4k tokens
Changelog Generator
by frostant
×9

Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.

774 tokens
Test Driven Development
by w95
×7

Use when implementing any feature or bugfix, before writing implementation code

2k tokens
Writing Plans
by ZhanlinCui
×4

Use when you have a spec or requirements for a multi-step task, before touching code

816 tokens
Writing Skills
by ZhanlinCui
×4

Use when creating new skills, editing existing skills, or verifying skills work before deployment

26k tokens scripts
Crafting Effective Readmes
by softaworks
×3

Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.

15k tokens
Humanizer
by softaworks
×3

| Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

6k tokens
Opentrons Integration
by christophacham
×3

Official Opentrons Protocol API for OT-2 and Flex robots. Use when writing protocols specifically for Opentrons hardware with full access to Protocol API v2 features. Best for production Opentrons protocols, official API compatibility. For multi-vendor automation or broader equipment control use pylabrobot.

9k tokens scripts

How to use it

Copy the folder

Take refoundai/written-communication from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.