Skip to content
Back to search

coldoutboundskills

Open-source Claude Code skills for cold email and outbound sales. Grade campaigns, export Prospeo searches, scrape Google Maps — all from Claude Code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/growthenginenowoslawski-coldoutboundskills/badge.svg)](/listings/growthenginenowoslawski-coldoutboundskills)

HTML

<a href="/listings/growthenginenowoslawski-coldoutboundskills"><img src="/api/listings/growthenginenowoslawski-coldoutboundskills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Install Claude Code

This repo is designed for Claude Code. Install from https://claude.com/claude-code.

2. Clone and configure

git clone <this-repo-url> ~/cold-email-ai-skills
cd ~/cold-email-ai-skills
cp .env.example .env
# Edit .env with your API keys (you don't need all of them — only the skills you'll use)

3. Install dependencies

npm install -g tsx
cd skills/cold-email-starter-kit
npm install

4. Verify credentials

npx tsx skills/cold-email-starter-kit/scripts/verify-credentials.ts

5. Start with the kickoff orchestrator

If you've never run cold email before, invoke the kickoff skill from Claude Code:

/cold-email-kickoff

It asks whether you have infrastructure already, then orchestrates ICP + lead magnet + campaign strategy + plan in a single guided flow. Produces a `campaign-plan.md` and hands you off to the right next skill based on your current state.

Alternative: `/cold-email-starter-kit` — the longer manual 14-step tutorial. Use this if you want to learn each piece deeply rather than move fast.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 228 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Cold Outbound Skills
  2. Open-source [Claude Code skills](https://docs.anthropic.com/en/docs/claude-code/skills) for cold email infrastructure, lead sourcing, copywriting, and operations. Built by [GrowthEngineX](https://growthengine-x.com) from patterns across 1,000+ real B2B campaigns.
  3. 31 skills that work together. Clone the repo, bring your API keys, point Claude Code at it, go from zero to a running campaign.
  4. **New here?** Invoke `/cold-email-kickoff` — it's the guided entry point that orchestrates ICP + lead magnet + strategy + plan in one flow.
  5. ## What's in here
  6. 32 skills organized in 5 tracks, plus 19 signal playbooks in Track 6 — each shipping three ways (a Claude skill, a Clay table build, and a Clay CLI workflow).
  7. **New to cold email? Start with `/cold-email-kickoff`.** It orchestrates ICP → lead magnet → campaign strategy → plan in one guided flow.
  8. ### Track 1 — Strategy (before you send anything)
  9. - **`cold-email-kickoff`** — single "start here" orchestrator (recommended entry point)
  10. - **`icp-onboarding`** — conversational intake that produces a `client-profile.yaml` (scrapes website first)
  11. - **`lead-magnet-brainstorm`** — figure out what to offer for free in your cold emails
  12. - **`campaign-strategy`** — generates 15-25 campaign ideas with AI strategies + value props
  13. - **`campaign-copywriting`** — stepwise copy writer (direction → subject → body → final YAML)
  14. ### Track 2 — Infrastructure
  15. - **`zapmail-domain-setup-public`** — buy `.com`/`.co` domains on Dynadot, provision inboxes on Zapmail
  16. - **`smartlead-inbox-manager`** — warmup settings, signatures (name/title/company/address), active/insurance tagging
  17. - **`email-deliverability-audit`** — diagnostic tool (SPF/DKIM/DMARC, spam placement, the 1% rule)
  18. - **`deliverability-incident-response`** — triage playbook for spam, bounces, blacklists, warmup blocks
  19. - **`inbox-lifecycle-manager`** — the weekly keep/cancel/promote/buy loop: which domains are burned, what replaces them, how many to buy
  20. ### Track 3 — List Building
  21. - **`list-builder`** — the meta skill for any list request: one-command lanes that sweep every source, AI-qualify every company, snowball until the market is dry, then pull uncapped contacts and find emails
  22. - **`perfect-company-list`** — the SCULPT 2026 method: learn the industries your customers actually use, pull all of them, judge every row with a cheap model (Jev), then a Claygent lookalike loop until it runs dry. Includes real coverage numbers against the FDIC, SEC and NJ school registries
  23. - **`list-expander`** — turn ~10 known-good seed companies into a full qualified TAM (fingerprint → lookalikes → mined filters → wide pull → AI qualification → live-site verify)
  24. - **`prospeo-full-export`** — title-first lead search (paginated, 25K+)
  25. - **`prospeo-search-api`** — Prospeo filter reference
  26. - **`blitz-list-builder`** — domain-first contact discovery
  27. - **`google-maps-list-builder`** — scrape Google Maps for local SMB lists
  28. - **`disco-like`** — lookalike company discovery (seed domains or NL ICP text)
  29. - **`competitor-engagers`** — find people engaging with competitor LinkedIn posts
  30. - **`icp-prompt-builder`** — required qualification step invoked by every list-building skill
  31. - **`list-quality-scorecard`** — grade a lead CSV across 8 dimensions before uploading
  32. ### Common Outbound Lists (bundled CSVs)
  33. Ready-to-filter company dumps in [`Common Outbound Lists/`](Common%20Outbound%20Lists/). These are **companies, not people** — feed them to `/list-builder` as `extra_candidates`, then run `/icp-prompt-builder` before contact pull.
  34. | List | Rows | What it is |
  35. |---|---|---|
  36. | [Shopify Stores — 259K Active](Common%20Outbound%20Lists/shopify-stores-259k-active.csv.zip) | 259,293 | Shopify stores with ≥1k estimated monthly visits. Columns: `domain`, `merchant_name`, `description`, `company_linkedin` (65% fill). Notes: [shopify-stores-259k-active.md](Common%20Outbound%20Lists/shopify-stores-259k-active.md) |
  37. | [Google Maps Scrape — 12M US Businesses](Common%20Outbound%20Lists/Google%20Maps%20Scrape%20-%2012M%20US%20Businesses/) | ~12.3M | US local businesses (13 zip parts). Grep `category_titles` first |
  38. | [US Software / SaaS companies](Common%20Outbound%20Lists/us-software-saas-companies-cleaned.zip) | ~173K | Cleaned software/SaaS company list |
  39. | [US zip codes](Common%20Outbound%20Lists/us-zip-codes.csv) | 42,734 | Zip / city / state / lat-lng / population — used by `/google-maps-list-builder` |
  40. ### Track 4 — Copy & Send
  41. - **`cold-email-starter-kit`** — the 14-step end-to-end tutorial (alternative to `/cold-email-kickoff`)
  42. - **`spam-word-checker`** — scan copy for deliverability-killing phrases
  43. - **`smartlead-spintax`** — add spintax variations to emails
  44. - **`smartlead-api`** — Smartlead API reference
  45. - **`smartlead-campaign-upload-public`** — DRAFT-upload leads.csv + variants.yaml to Smartlead (always DRAFT, you hit Start manually)
  46. ### Track 5 — Iterate & Automate
  47. - **`positive-reply-scoring`** — the metric that matters (positive replies / total sent)
  48. - **`experiment-design`** — single-variable experiment framework
  49. - **`auto-research-public`** — autonomous campaign launcher (scrape → ICP → leads → personalize → upload)
  50. - **`personalization-subagent-pattern`** — reusable pattern for per-lead Claude sub-agent personalization
  51. - **`deliverability-test-public`** — compare reply/bounce by inbox type
  52. - **`cold-email-weekly-rhythm`** — Monday/Wednesday/Friday operational playbook — what separates hobbyist from top-1%
  53. ### Track 6 — Signal Playbooks
  54. Nineteen playbooks, each turning **one buying signal into one copy-ready sentence**. They live
  55. together in **[`skills/playbooks/`](skills/playbooks/)** — start at
  56. [`clay-playbooks`](skills/playbooks/clay-playbooks/) for the index and the two build harnesses.
  57. Every playbook ships the same three files:
  58. | File | What it is |
  59. |---|---|
  60. | `SKILL.md` | the playbook: source chain, output contract, locked prompt, edge cases |
  61. | `clay-table.md` | the Clay **table** build — columns, formulas, credit gates (browser-driven) |
  62. | `clay-workflow.md` | the Clay **workflow** build via the `clay` CLI (terminal-driven) |
  63. *Tables are browser-driven and workflows are CLI-driven because of a real constraint: the `clay` CLI
  64. is read-only for tables, but can create, edit and publish workflows.*
  65. - **Person signals** — `new-in-role` · `linkedin-engagement` · `social-posts` · `warm-intros`
  66. - **Company signals** — `fundraising` · `hiring-surge` · `job-posting-language` · `ad-library`
  67. - **Website signals** — `pricing-page` · `case-study-page` · `tech-on-website` · `google-site-search`
  68. - **List shaping** — `company-name-cleaning` · `first-name-cleaning` · `social-link-finding` · `lookalikes` · `name-to-other-prospects`
  69. - **Copy generation** — `ai-specificity` · `creative-ideas`
  70. ⚠️ Each `SKILL.md` carries a verification line saying what was actually run and on how many rows. The
  71. `clay-table.md` and `clay-workflow.md` files are documented recipes that **have not been built and run
  72. in a live Clay workspace** — written against the real Clay action catalog and CLI surface, but treat
  73. them as specifications: build one, run 5 rows, read the output, fix the file.
  74. ## Getting started
  75. ### 1. Install Claude Code
  76. This repo is designed for Claude Code. Install from https://claude.com/claude-code.
  77. ### 2. Clone and configure
  78. ```bash
  79. git clone <this-repo-url> ~/cold-email-ai-skills
  80. cd ~/cold-email-ai-skills
  81. cp .env.example .env
  82. # Edit .env with your API keys (you don't need all of them — only the skills you'll use)
  83. ```
  84. ### 3. Install dependencies
  85. ```bash
  86. npm install -g tsx
  87. cd skills/cold-email-starter-kit
  88. npm install
  89. ```
  90. ### 4. Verify credentials
  91. ```bash
  92. npx tsx skills/cold-email-starter-kit/scripts/verify-credentials.ts
  93. ```
  94. ### 5. Start with the kickoff orchestrator
  95. If you've never run cold email before, invoke the kickoff skill from Claude Code:
  96. ```
  97. /cold-email-kickoff
  98. ```
  99. It asks whether you have infrastructure already, then orchestrates ICP + lead magnet + campaign strategy + plan in a single guided flow. Produces a `campaign-plan.md` and hands you off to the right next skill based on your current state.
  100. Alternative: `/cold-email-starter-kit` — the longer manual 14-step tutorial. Use this if you want to learn each piece deeply rather than move fast.
  101. ## API keys required (bring your own)
  102. | Service | Env var | What it's for | Skills that use it |
  103. |---|---|---|---|
  104. | Smartlead | `SMARTLEAD_API_KEY` | Send emails, manage inboxes | inbox-manager, starter-kit, auto-research, audit, scoring |
  105. | Prospeo | `PROSPEO_API_KEY` | List building (title-first) | prospeo-*, auto-research |
  106. | Dynadot | `DYNADOT_API_KEY` | Buy domains | zapmail-setup |
  107. | Zapmail | `ZAPMAIL_API_KEY` | Create inboxes | zapmail-setup |
  108. | MillionVerifier | `MILLIONVERIFIER_API_KEY` | Validate emails before sending | waterfall, auto-research |
  109. | Blitz | `BLITZ_API_KEY` | Domain-to-contacts lookup | blitz-list-builder |
  110. | RapidAPI | `RAPIDAPI_KEY` | Google Maps scraping, LinkedIn data | google-maps-*, competitor-engagers |
  111. | Instantly | `INSTANTLY_API_KEY` | Alternative sending platform | starter-kit (09) |
  112. | OpenWebNinja | `OPENWEBNINJA_KEY` | Company news enrichment | starter-kit (07) |
  113. | OpenRouter | `OPENROUTER_API_KEY` | AI company analysis enrichment | starter-kit (07), competitor-engagers |
  114. The minimum viable setup for your first campaign is: **Dynadot + Zapmail + Prospeo + Smartlead**. Start there, add more as you need them.
  115. ## Recommended path
  116. **If you've never run cold email:**
  117. 1. `/cold-email-kickoff` — one guided flow: ICP → lead magnet → strategy → plan → next-skill menu
  118. 2. Follow the menu's recommended next skill (infra setup OR list building, depending on your current state)
  119. 3. After campaign launch, wait 21 days, then `/positive-reply-scoring`
  120. 4. Add `/cold-email-weekly-rhythm` to your calendar for ongoing ops
  121. **If you have experience but no automation:**
  122. 1. `/icp-onboarding` — lock down your ICP
  123. 2. `/smartlead-inbox-manager` — configure your existing inboxes properly
  124. 3. `/email-deliverability-audit` — fix any domain/inbox issues before scaling
  125. 4. `/auto-research-public` — daily automated campaign launches
  126. **If you're debugging a broken campaign:**
  127. 1. `/email-deliverability-audit` — find the infrastructure issue
  128. 2. `/positive-reply-scoring` — see if replies are positive or hostile
  129. 3. `/deliverability-test-public` — compare across inbox types
  130. 4. `/spam-word-checker` — scan copy for banned phrases
  131. 5. `/inbox-lifecycle-manager` — if a domain is confirmed burned, cancel and replace it safely
  132. **If your inbox bill is too high, or you're under your send goal:**
  133. 1. `/inbox-lifecycle-manager` — the plan: what's burned, what to promote, what to buy (read-only)
  134. 2. `/email-deliverability-audit` — confirm *why* before cancelling anything
  135. 3. `/smartlead-inbox-manager` — execute the approved tag changes
  136. 4. `/zapmail-domain-setup-public` — buy the replacements (a month before you need the sends)
  137. ## Directory layout
  138. ```
  139. cold-email-ai-skills/
  140. README.md # this file
  141. .env.example # template for your API keys
  142. Common Outbound Lists/ # pre-built company CSVs (Shopify, Maps, SaaS)
  143. skills/
  144. <skill-name>/
  145. SKILL.md # the skill definition (required)
  146. scripts/ # runnable code
  147. references/ # deeper docs
  148. profiles/ # YOUR client profiles + experiment logs (gitignored)
  149. <business-slug>/
  150. client-profile.yaml
  151. experiments/
  152. scores/
  153. ```
  154. ## Cost expectations
  155. First campaign (2,000 leads, 20 domains, 40 inboxes):
  156. - Domains: ~$240 one-time (20 × ~$12 .com). Fall back to .co (~$8-30) if .com is taken.
  157. - Zapmail: ~$60/mo for 40 inboxes
  158. - Prospeo: ~$20 for 2,000-lead export
  159. - Smartlead: ~$39/mo starter plan
  160. - MillionVerifier: ~$5 for 2,000 validations
  161. - **Month 1 total: ~$360. Recurring: ~$130/mo.**
  162. See `skills/cold-email-starter-kit/references/00-getting-started.md` for full breakdown.
  163. ## A note on ethics
  164. Cold email is legal when done right, but it's a privilege. Don't spam. Don't email consumers. Honor unsubscribes instantly. Include a real physical address. Be the kind of sender you'd want to receive email from.
  165. The best cold emails are the ones the recipient is glad they got.
  166. ## Contributing
  167. This repo is a collection of patterns refined over thousands of real campaigns. Improvements welcome — PRs should include:
  168. - Real-world test results (not theoretical changes)
  169. - Generalizable insight (not hyper-specific to one industry)
  170. - Keep beginner-friendliness as the north star
  171. ## License
  172. MIT — use it, fork it, profit from it. Attribution appreciated but not required.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.