cold-email
Skill2 starsChanged 3 months agoMITView on GitHub
Write, audit, and fix cold outbound email — targeted B2B outreach that actually reaches an inbox and earns a reply. Covers the three things that decide the outcome: sending-domain authentication (SPF, DKIM, DMARC, alignment, and the Google/Yahoo/Microsoft bulk-sender rules), the legal requirements that differ by jurisdiction (CAN-SPAM, GDPR/ePrivacy, CASL), and copy discipline measured against reply rate rather than open rate. Use this whenever the user is writing a cold email, outbound sequence, sales email, intro email to a stranger, investor or partnership outreach, or a follow-up; asks why their emails get no replies, land in spam, or bounce; asks about deliverability, warming up a domain, sending volume, or "am I blacklisted"; wants a draft critiqued, shortened, or rewritten; or asks whether they are allowed to email a list. Trigger even when they never say "cold email" — "help me reach out to this VP", "why is nobody responding to my outreach", "is this sequence any good", and "we're launching outbound next month" are all this skill.
97 other projects use a version of this.
Adopted by
Most recently taken up by
- revnu-app/revnu-plugintheir own version, first seen Nov 8, 2026
- darkweb19/skillstheir own version, first seen Nov 8, 2026
- f13i/f13i-clitheir own version, first seen Nov 8, 2026
- yht-4403/jc-agent-skillstheir own version, first seen Nov 8, 2026
- alpit-patel/seo-aeo-geo-kittheir own version, first seen Nov 8, 2026
- bereach-ai/linkedin-prospecting-skillstheir own version, first seen Nov 8, 2026
Used with
Projects with it also use free-tools, popups and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
CesarjoquinSkillfree-tools
When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions "engineering as marketing," "free tool," "marketing tool," "calculator," "generator," "interactive tool," "lead gen tool," "build a tool for leads," "free resource," "ROI calculator," "grader tool," "audit tool," "should I build a free tool," or "tools for lead gen." Use this whenever someone wants to build something useful and give it away to attract leads or earn links. For downloadable content lead magnets (ebooks, checklists, templates), see lead-magnets.
Also in 25 projects that use this
CesarjoquinSkillpopups
When the user wants to create or optimize popups, modals, overlays, slide-ins, or banners for conversion purposes. Also use when the user mentions "exit intent," "popup conversions," "modal optimization," "lead capture popup," "email popup," "announcement banner," "overlay," "collect emails with a popup," "exit popup," "scroll trigger," "sticky bar," or "notification bar." Use this for any overlay or interrupt-style conversion element. For forms outside of popups, see cro. For general page conversion optimization, see cro.
Also in 23 projects that use this
coreyhaines31Skillmarketing-council
When the user wants multiple expert perspectives on a marketing question — a simulated board of advisors staffed by legendary marketers (Seth Godin, David Ogilvy, Eugene Schwartz, April Dunford, Rory Sutherland, Alex Hormozi, Byron Sharp, and more). Also use when the user mentions 'marketing council,' 'board of advisors,' 'advisory board,' 'what would Seth Godin say,' 'what would Ogilvy think,' 'channel Hormozi,' 'get multiple perspectives,' 'debate this,' 'have the council review,' 'marketing mentors,' or asks how a famous marketer would approach their problem. The council gives each advisor's take through their documented frameworks, surfaces where they disagree, and synthesizes a recommendation. For executing the winning direction, hand off to positioning, offers, copywriting, ads, or the relevant skill.
Also in 18 projects that use this
Hussain-ElfalahSkillandreessen
Also in 4 projects that use this
Hussain-ElfalahSkillbusiness-investment-advisor
Also in 4 projects that use this
roerohanSkillemails
When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold outreach emails, see cold-email. For in-app onboarding, see onboarding.
Also in 24 projects that use this
- +5 more from Cesarjoquin
- +1 more from Hussain-Elfalah
Other versions97 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 97
- coreyhaines31/marketingskills★ 59ksame name
- LeoYeAI/openclaw-marketing-skills★ 1ksame name
- Cesarjoquin/Marketing-Skills★ 190same name
- b1rdmania/ghostclaw★ 91same name
- LOGIN-TB/claude-skills★ 82same name
- open-fox/agents★ 55same name
- SZcalligrapher/slash-skills-subscription★ 32same name
- roerohan/skills★ 29same name
- Mikefluff/skills★ 26same name
- ukunal91app/Marketing-Skills-by-Corey-Haines★ 26same name
87 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository4 other files it gives its agents.
- cro-auditSkill
- pitch-deckSkill
- seo-auditSkill
- wireframeSkill
The file
We split this skill into the rules it gives an agent
11 rules. 0 are common, 10 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 90 edited versions we read keep these.
10
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 33
If the user wants high-volume untargeted blasting, say plainly that it will burn the sending domain, and that the domain reputation damage …
- Distinctive: line 39
Run this first, every time, even if the user only asked for copy help:
- Distinctive: line 63
If the domain fails authentication, stop and fix that.
- Distinctive: line 67
Ask where the recipients are.
- Distinctive: line 69
US (CAN-SPAM): No prior consent needed. But the message must carry a valid physical postal address, a working opt-out, and non-deceptive …
- Distinctive: line 89
No trigger means it is a broadcast wearing a costume, and it reads as one.
- Distinctive: line 100
If there is no trigger, that is the finding.
- Very specific: line 104
Read references/copy.md first.
- Distinctive: line 114
The first sentence is about them, and is falsifiable: If it could be sent to anyone, it is not a first sentence.
- Distinctive: line 134
Treat the score as a lint pass, not a verdict.
- Distinctive: line 146
When auditing an existing outbound program, structure the finding as:
“Common” is measured: kept by at least 6 in 10 of the 90 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Cold Outbound That Reaches and Gets Replies
What decides the outcome
Three independent systems have to succeed, in this order:
- Delivery. An unauthenticated message never gets read, however good it is. This is deterministic, checkable, and the most common silent failure.
- Legality. What you must include, and whether you may send at all, depends on where the recipient is. The US, EU/UK, and Canada have materially different regimes.
- The reply. Copy craft, which is where nearly all published advice lives and where the least of it is verifiable.
Most outbound fails at (1) while the sender rewrites (3). So diagnose in order, and never skip Step 1 because the copy looks like the interesting problem.
The discipline in this skill: every recommendation names its mechanism, and metrics that
cannot be measured are called out rather than reported. Open rates in particular are
close to meaningless now — see references/deliverability.md.
Scope
This is for targeted outreach at low volume: a researched list where you can state, per recipient, why you emailed that person. That is both the legally defensible posture and the one that actually works — reply rate collapses as list size grows, because the specific reason for the email is what earns the reply.
If the user wants high-volume untargeted blasting, say plainly that it will burn the sending domain, and that the domain reputation damage is slow to reverse. Then help them do the targeted version.
Step 1 — Audit the sending domain before writing anything
Run this first, every time, even if the user only asked for copy help:
python3 scripts/check_domain.py example.comIt resolves SPF, DKIM (probing common selectors), DMARC, MX, MTA-STS and TLS-RPT, then
reports each as PASS / WARN / FAIL with the specific fix. Add --json for machine output,
--selectors s1,s2 to probe custom DKIM selectors.
Interpret the result against references/deliverability.md, which has the actual provider
requirements — including the distinction almost everyone gets wrong: Google requires SPF
or DKIM from all senders, but SPF and DKIM and DMARC with alignment from bulk
senders (5,000+ messages/day to Gmail). Know which set applies before you tell the user
what is mandatory.
Two findings matter more than the rest:
p=nonewith noruais the most common state and is not a passing grade. It means nothing is enforced and nobody is reading the reports, so authentication failures are invisible.- Cold outbound from the primary domain puts transactional and cold mail on one reputation. Recommend a dedicated sending subdomain or a separate domain.
If the domain fails authentication, stop and fix that. Rewriting the email is wasted work.
Step 2 — Establish who may be emailed
Ask where the recipients are. This is not optional detail — it changes what is legal:
- US (CAN-SPAM). No prior consent needed. But the message must carry a valid physical postal address, a working opt-out, and non-deceptive headers and subject.
- EU/UK (GDPR + ePrivacy). Consent rules for unsolicited email vary by member state, and B2B is treated differently from B2C. The UK permits mail to corporate subscribers without consent; Germany effectively does not. GDPR also requires a lawful basis — usually legitimate interests — which must be assessed and documented before sending.
- Canada (CASL). Consent is required, express or implied. "Conspicuously published business address, message relevant to their role" is the implied-consent route most cold outbound relies on, and it has conditions.
Full requirements, including exactly what must appear in the message body per regime, are
in references/compliance.md. Read it before drafting for any non-US recipient.
State the constraint to the user; do not quietly drop it. And be clear that this is operational guidance, not legal advice — a real list crossing several jurisdictions warrants counsel.
Step 3 — Find the trigger
An email needs a specific, checkable, recent reason it was sent to this person now. No trigger means it is a broadcast wearing a costume, and it reads as one.
Usable triggers, roughly in descending order of strength: they are hiring for the problem you solve; they shipped or announced something that creates the need; they raised; they changed role; they published a specific technical or strategic position; a peer company they benchmark against just did the thing.
Weak triggers, which are usually automation tells: "I loved your post," "I saw you're the VP of X," "congrats on the funding" with nothing following it, and anything that a merge field could have produced.
If there is no trigger, that is the finding. Say so before writing copy.
Step 4 — Draft
Read references/copy.md first. It has the anatomy, the subject-line rules, the
anti-patterns with the reason each one fails, and worked before/after rewrites in
assets/example-emails.md.
The constraints that matter most:
- 50 to 80 words. 125 is a ceiling, not a target. The ask must be visible on a phone without scrolling.
- One sentence per section. The second sentence is almost always you explaining the inference you just drew — cut it. Give them the observation, not your conclusion about it.
- The first sentence is about them, and is falsifiable. If it could be sent to anyone, it is not a first sentence.
- The ask is concrete and soft. Name one small thing you can send immediately, then close in two words: "I can send the 20-line query we used. Want it?" Soft-but-vague ("worth a look?") fails because the recipient has to invent the next step; concrete-but- heavy (a calendar link) fails because it asks for thirty minutes from a stranger.
- One question mark. Two questions halve the odds of either being answered.
- One link maximum, no attachments. Both are reputation and filtering liabilities in a first touch.
Step 5 — Score the draft
python3 scripts/score_email.py draft.txtIt reports word count, the ask, question count, link count, the you/we ratio, reading
grade, jurisdiction-required elements, and phrase-level flags — quoting the offending text
rather than just naming a rule. --jurisdiction us|eu|ca adjusts the compliance checks.
Treat the score as a lint pass, not a verdict. A 100 does not make an email worth sending; a trigger-less email can score perfectly. Fix what it flags, then judge the draft on whether it earns a reply.
Step 6 — Build the sequence
Two to three follow-ups, each carrying new information rather than "bumping this," and
a hard stop. Timing, thread strategy, stop rules, and the arithmetic of what volume a
mailbox can carry are in references/sequences.md.
What to report back
When auditing an existing outbound program, structure the finding as:
- Delivery posture — the domain audit table, with the one fix that matters most.
- Compliance gaps — per jurisdiction, what is missing from the message.
- Copy — the score, then the rewrite, then what specifically changed and why.
- What cannot be known — if they are quoting open rates, say why those numbers are unreliable and what to instrument instead.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

