Systems Lab

Agent skill

writing-persuasive-emails

Use when writing cold emails, job application emails, sales outreach, investor pitches, networking intros, or any high-stakes email where the reply matters more than the message.

dormantSelf-containedInstructions only1,626 words

Filed under Outbound email.

From thegauravmahto/claude_email_skill · 1 skill · 1 · pushed 2026-04-23

What it does when it runs

Use when writing cold emails, job application emails, sales outreach, investor pitches, networking intros, or any high-stakes email where the reply matters more than the message. Triggers on "cold email", "job application email", "outreach", "pitch email", "sales email", "intro email", "reply rate", "get a response".

Read from the skill and the 0 files bundled beside it. A skill’s own description is written to be selected by an agent, so it describes the job and not the dependencies.

Keys and connectors you must supply
None found.
Hosts it reaches
No third-party host appears in the skill or its bundled files.
Tool permissions it declares
No allowed-tools in the frontmatter. It only issues instructions, so there is nothing to bound.
Actions present in the files
None. Instructions only.

Ask about writing-persuasive-emails

Opens your assistant with this page's verified links already in the prompt.

Is this safe to install?ClaudeChatGPT
Adapt it to my stackClaudeChatGPT
What else do I need for it to workClaudeChatGPT
Rather ask a human? Talk to Cheetah
git clone --depth 1 https://github.com/thegauravmahto/claude_email_skill.git /tmp/claude_email_skill
mkdir -p ~/.claude/skills/writing-persuasive-emails
cp -R "/tmp/claude_email_skill/." ~/.claude/skills/writing-persuasive-emails/

Picked up without a restart. A project skill of the same name is shadowed by your personal one. For one repository only, swap ~/.claude/skills for .claude/skills. Claude Code docs ↗

The folder is the same in every client that implements the format — 46 of them — so if yours is not above, only the destination changes.

Reproduced in full from thegauravmahto/claude_email_skill/blob/825a4c9141d3a0ad0ab0b188f57faa6fce5c607c/SKILL.md, which is licensed MIT (repository). 1,626 words, 18 headings.

Writing Persuasive Emails (World-Building Framework)

Overview

Effective emails are applied psychology, not self-expression.

The reader's experience is the product. Words are just the delivery vehicle. Amateurs focus on transmission ("what I want to say"). Masters focus on reception ("what they hear").

This skill teaches a five-step framework for writing emails that get replies: audience analysis, world-fit, identity mirroring, frame shift, and the single core point.

When to Use

Use when:

  • Sending cold outreach (investors, founders, hiring managers, partners)
  • Writing a job application email
  • Pitching an idea to someone who doesn't know you
  • Asking for a meeting, intro, or favor from a stranger
  • Following up after silence
  • Any email where a reply is the success metric

Do NOT use when:

  • Sending transactional updates to your team
  • Writing to close colleagues who already trust you
  • The email is purely informational (no persuasion needed)
  • You don't yet know the audience — do research first, then come back

The Iron Law

The email is not about you. It is about the reader's worldview.

You are not sending a message. You are executing a program in the reader's mind. Every line earns the right to the next.

The Framework

Step 1 — Audience Analysis (do this before touching the draft)

Ask four questions:

  1. Who are they? Role, ecosystem, stage of career.
  2. What world do they live in? YC founders live in a different world from enterprise buyers, who live in a different world from academic researchers. Each world has its own beliefs, heroes, and villains.
  3. What vocabulary does their tribe use? ("GTM" not "marketing", "cracked engineer" not "talented developer", "NRR" not "retention", "ICP" not "target customer".)
  4. What identity are they trying to confirm about themselves? Founders want to believe they are visionary missionaries. VCs want to believe they back category-defining companies. Hiring managers want to believe they have taste.

If you cannot answer these, do not send the email yet. Read their tweets, their company blog, their podcast appearances. You are looking for the shape of their world.

Step 2 — World-Fit (find the atomic units)

Atomic units are low-information points of common ground that the reader already agrees with. They are so obvious the reader doesn't realize they have agreed — they just nod.

Examples:

  • For founders: "Great companies are built by obsessive people."
  • For investors: "Outcomes follow a power law."
  • For hiring managers: "The best engineers barely apply through forms."

Start here. Build up. Once the reader has nodded three times, you have earned the right to say something they do not yet agree with.

Step 3 — Mirror Their Identity

Reflect back the identity the reader wants to be seen as. This is what the Soham Parekh email did:

"I don't have many hobbies outside coding. I am not athletic, bad at singing, don't drink, can't dance. Building is the only thing I am good at."

This is not self-deprecation. It is the "cracked engineer" archetype YC founders fetishize, delivered as if it were confession. The reader sees themselves in the email and thinks: this is one of us.

The rule: describe yourself in the exact shape of the reader's ideal.

Step 4 — Frame Shift (only when introducing a new idea)

If the reader already agrees with you, skip this step. If you need to move them from their worldview to a new one, do it in stages:

  1. Validate a part of their belief system ("You are right to be skeptical of X. Most of it is noise.")
  2. Introduce one piece of dissonance ("But two of the ten examples are different because…")
  3. Offer resolution (the thing you actually want them to consider)

Never bombard with contradictory facts. The reader's brain has an immune system. Facts that oppose their worldview get rejected before they are read.

Step 5 — The Single Core Point

Amateurs pile on reasons. Masters find the one root premise the reader's decision actually rests on.

"I trust this person" closes a deal that five bullet points of résumé items cannot. One sentence that fits the reader's existing math beats ten sentences that do not.

Before sending, ask: if I could only keep one sentence, which one does the work? Cut the rest to a supporting role.

Quick Reference

SituationMove
Cold email to a founderName the company specifically. Mirror the "cracked builder" identity.
Cold email to an investorUse their math (power-law outcomes, billion-dollar exits), their vocab (GTM, CAC, NRR).
Job applicationMirror the hiring team's ideal employee. Skip generic credentials.
Pitching a new ideaFrame shift. Validate first, then introduce dissonance, then resolve.
Follow-up after silenceAdd one new piece of information. Never just "bumping this up."
Draft feels too longFind the single core point. Everything else is scaffolding.
Draft feels genericAdd one concrete detail only someone who did their homework could know.

Language Rules

  • Simple words, clean sentences. Reducing cognitive load is respect, not dumbing down.
  • Their vocabulary, not yours. If they say "GTM", you do not say "marketing".
  • One concrete story beats any statistic. "92% of customers are satisfied" is forgettable. "Himesh closed two extra deals last Friday" is memorable.
  • Mention the company name. Generic flattery signals copy-paste. Specificity signals research.
  • Lead with them, not you. The first noun in the email should be about the reader's world, not yours.
  • Reach from ground truth. Every claim should be believable from the reader's starting point. One unbelievable line rejects the whole email.

Template: The Soham Pattern (dissected)

Hey, I love everything about what [Company] is doing.
  └─ Personalization that signals research (mention the company name).

[One specific detail about what the company is doing and why it matters.]
  └─ Proof you did your homework. Non-copy-pasteable.

I don't have many hobbies outside [their valued activity].
[A short line that reveals an identity the reader already admires.]
  └─ Identity mirror. Shows you are their tribe.

[2-3 lines of skills/experience in THEIR vocabulary — in-group language,
not résumé-speak.]
  └─ Tribal signal. You speak the language.

[Specific, low-friction ask.]
  └─ Make the yes easy. A 15-minute call, not an hour. A reply, not a commitment.

Worked Example: Why the Soham Parekh Email Worked

LineWhat it does
"I love everything about what [Company] is doing."Not flattery — the company name signals research. Immediately shifts from "what I want" to "what they want."
"I don't have many hobbies outside coding."Mirrors the "obsessive builder" identity YC founders romanticize. Disguised as self-deprecation.
"Building is the only thing I am good at."Closes the identity loop. "I am the engineer you dream of hiring."
"Super lean teams, working across the stack."In-group vocabulary. Signals tribe membership. Not "I'm a full-stack developer."

The email did not ask for a job. It sold an identity the founder was already desperate to buy.

Common Mistakes

  1. Generic flattery — "Your company is amazing." No company name, no specific detail. Reads as copy-paste.
  2. Laundry list of credentials — Ten bullets. No root premise. Hoping one lands. None will.
  3. Using your vocabulary instead of theirs — "Marketing" when they say "GTM". "Talented" when they say "cracked". Signals you are not in the tribe.
  4. Contradicting their worldview head-on — "Actually, you are wrong about X." The brain's immune system rejects this before it is read.
  5. Trying to build a world from scratch — You cannot. Fit into the world they already inhabit, then modify one piece.
  6. Leading with what YOU want — "I am looking for a role." Replace with what they want: "You are hiring the kind of engineer who builds in their sleep."
  7. Unbelievable claims — Even if true. "Reach from ground truth" means every line must be believable from the reader's starting point.
  8. Ask is too big — "Can we hop on an hour call this week?" Shrink it. "Worth a 15-minute reply if this is interesting?" Make the yes frictionless.
  9. No single core point — If you cannot point to the one sentence doing the work, neither can the reader.

Red Flags (stop and rewrite)

  • Email starts with "I"
  • No specific, non-copy-pasteable detail about the recipient
  • More than five bullets in the body
  • Buzzwords the recipient would not use on their own podcast
  • Closes with a vague ask ("let me know if there's a fit")
  • You cannot identify the single core point
  • A stranger reading it could not tell who it was sent to

Before You Send — Checklist

  • I can name the single core point in one sentence.
  • The first specific detail is about them, not me.
  • I used their vocabulary at least twice.
  • I mirrored an identity they already admire.
  • Every claim is reachable from their ground truth.
  • The ask is smaller than they expect.
  • If I cut the three longest sentences, does the email still work? (If yes, cut them.)

Attribution

Framework extracted from a talk on writing as world-building — built around the deconstruction of the Soham Parekh cold email that reached hundreds of founders. The underlying insight (effective writing is applied psychology, not self-expression) is ancient; the world-building vocabulary and the Soham case study are from that talk.

Other skills for the same job

Different authors, same problem. Matched on the words in the skill name, across every library in the catalogue except this one.

Need help setting it up?

This page tells you what writing-persuasive-emails does and what it needs. Cheetah builds the agent setup it runs inside: data, CRM, sequencing and the guardrails.

Book a call →

The directory stays free. There is nothing gated behind this.