Preamble (runs on skill start)
# Version check (silent if up to date)
python3 telemetry/version_check.py 2>/dev/null || true
# Telemetry opt-in (first run only, then remembers your choice)
python3 telemetry/telemetry_init.py 2>/dev/null || true
Privacy: This skill logs usage locally to ~/.ai-marketing-skills/analytics/. Remote telemetry is opt-in only. No code, file paths, or repo content is ever collected. See telemetry/README.md.
Cold Outbound Optimizer
Startup: Determine Mode
Ask the user:
- Do you have an existing Instantly account with campaigns to audit, or are you starting from scratch?
- Do you have an Instantly API key? (Required for audit mode.)
If API key provided → run scripts/instantly-audit.py to pull campaigns, account inventory, and warmup scores before proceeding.
Phase 1: Discovery & Audit
1A — Infrastructure Check (if API key available)
Run python3 scripts/instantly-audit.py --api-key <KEY> and report:
- Active campaigns (name, status, reply rate, open rate)
- Sending accounts (count, warmup score, daily limit)
- Domain inventory
- Warmup gaps: any account with score <80 or <14 days warmup → flag as NOT ready
1B — Performance Data
- Pull campaign analytics from Instantly
- Ask: "Do you have a spreadsheet with historical outbound data?" If yes, request link.
1C — ICP Definition
If no ICP defined, collect:
- Titles: Who are you targeting? (e.g., VP Marketing, Head of Growth)
- Industries: Which verticals?
- Company size: Employee count or revenue range?
- Revenue floor: Minimum ARR/revenue to qualify?
- Anti-ICP: Who to explicitly exclude?
Use references/icp-template.md as the collection template.
1D — Business Context
Collect:
- What do you sell? (One sentence, no jargon)
- What's the primary offer? (Free trial, audit, demo, consultation)
- Real URLs to reference (pricing page, case studies, relevant content)
- Any proof points? (Client results, stats, social proof)
1E — Expert Panel Config
Default: 10 experts (see references/expert-panel.md).
Ask: "Any industry-specific experts to add, or panelists to swap?" Confirm roster before scoring.
Phase 2: Expert Panel Recursive Scoring
Target: 90/100. Non-negotiable. Iterate until reached.
Round Structure
Each round produces:
- Score table — all 10 panelists, individual score (0-100), one-line rationale
- Aggregate score — average of all 10
- Top weaknesses — ranked list of what's holding the copy back
- Changes made — specific edits addressing each weakness
- Updated copy — full revised sequence after changes
Scoring Criteria (per panelist's lens — see references/expert-panel.md)
- Subject line curiosity / open rate potential
- First sentence pattern interrupt
- Body clarity and brevity
- CTA softness and specificity
- Sequence flow and follow-up logic
- Deliverability risk signals (spam words, link density)
- Personalization believability
Rules
- Scores must be brutally honest. No padding to 90 without earning it.
- If round score < 90: identify top 3 weaknesses, revise copy, run next round.
- If round score ≥ 90: finalize copy and proceed to deliverables.
- Show every round in the final doc — the iteration trail is part of the value.
Phase 3: Deliverables
Strategy Doc
Create a document (Google Doc, Notion, or markdown) with:
- Pre-Analysis / Brutal Truth — what the existing campaigns are doing wrong (or baseline if starting from scratch)
- ICP Summary — confirmed targeting parameters
- Infrastructure Status — account inventory, warmup readiness, capacity math
- Scoring Rounds — full panel vote tables for every round
- Final Email Copy — all steps for all campaigns, Instantly-ready format
- Implementation Plan — step-by-step setup instructions
- Capacity Math — accounts × daily send rate = pipeline projections
- Weekly Metrics Targets — open rate, reply rate, positive reply rate, meetings booked
- STOP List — what to kill immediately
- START List — what to launch first
Format Rules for Final Copy
Follow all rules in references/instantly-rules.md and references/copy-rules.md.
Human Review Gate
Do NOT push anything to Instantly automatically. The doc is for human review. Get explicit approval before any API writes.
Iteration
After review, collect feedback and re-run scoring on revised copy if needed.
Capacity Math Formula
Accounts ready (score ≥80, ≥14 days warmup) × 30 emails/day = conservative daily volume
Accounts ready × 50 emails/day = aggressive daily volume
Daily volume × 22 working days = monthly send capacity
Monthly sends × expected reply rate = expected replies
Expected replies × qualification rate = pipeline opportunities
Weekly Metrics Targets (Baselines)
| Metric |
Good |
Great |
| Open rate |
40%+ |
60%+ |
| Reply rate |
3%+ |
7%+ |
| Positive reply rate |
1%+ |
3%+ |
| Meeting rate |
0.5%+ |
1.5%+ |
Adjust targets based on niche and offer. Cold traffic to a free audit converts differently than a paid trial.
Add-On Recommendations (mention but don't build)
- LinkedIn automation: HeyReach or similar for multi-channel sequences. Separate workflow.
- Lead enrichment: Clay or Apollo for personalization data before upload.
- Lead pipeline: Use
scripts/lead-pipeline.py for Apollo → LeadMagic → Instantly automation.
Reference Files
| File |
Purpose |
references/instantly-rules.md |
Variable syntax, sequence structure, deliverability rules |
references/expert-panel.md |
Default 10-expert roster with scoring lenses |
references/copy-rules.md |
Email copy rules (first sentence, CTA, stats framing) |
references/icp-template.md |
ICP data collection template |
scripts/instantly-audit.py |
Pulls campaigns, accounts, warmup scores via Instantly v2 API |
scripts/lead-pipeline.py |
End-to-end lead sourcing pipeline |
scripts/competitive-monitor.py |
Competitor tracking and intelligence |
scripts/cross-signal-detector.py |
Multi-source signal detection |
scripts/cold-outbound-sender.py |
Send approved outbound emails |
1---
2name: outbound-engine
3description: Design, analyze, and optimize cold outbound email campaigns for Instantly. Handles end-to-end ICP definition, expert panel scoring (recursive to 90+), sequence copywriting, infrastructure audit, capacity planning, and implementation docs. Use when asked to build cold outbound sequences, optimize cold email, analyze outbound campaigns, build sales sequences, build Instantly sequences, create cold outbound strategies, or design email campaigns. Supports both "start from scratch" and "optimize existing" modes.
4version: 1.0.1
5display_name: "outbound-engine"
6display_name_en: "Outbound Engine"
7description_zh: "自动化外拓邮件引擎,从 ICP 定义到邮件入站全流程"
8description_en: "Automated cold outbound engine from ICP definition to inbox delivery"
9visibility: "public"
10metadata:
11 source: https://skillmd.com/skills/infometa/outbound-engine
12---
13
14
15## Preamble (runs on skill start)
16
17```bash
18# Version check (silent if up to date)
19python3 telemetry/version_check.py 2>/dev/null || true
20
21# Telemetry opt-in (first run only, then remembers your choice)
22python3 telemetry/telemetry_init.py 2>/dev/null || true
23```
24
25> **Privacy:** This skill logs usage locally to `~/.ai-marketing-skills/analytics/`. Remote telemetry is opt-in only. No code, file paths, or repo content is ever collected. See `telemetry/README.md`.
26
27---
28
29# Cold Outbound Optimizer
30
31---
32
33## Startup: Determine Mode
34
35Ask the user:
361. Do you have an **existing Instantly account** with campaigns to audit, or are you **starting from scratch**?
372. Do you have an **Instantly API key**? (Required for audit mode.)
38
39If API key provided → run `scripts/instantly-audit.py` to pull campaigns, account inventory, and warmup scores before proceeding.
40
41---
42
43## Phase 1: Discovery & Audit
44
45### 1A — Infrastructure Check (if API key available)
46Run `python3 scripts/instantly-audit.py --api-key <KEY>` and report:
47- Active campaigns (name, status, reply rate, open rate)
48- Sending accounts (count, warmup score, daily limit)
49- Domain inventory
50- Warmup gaps: any account with score <80 or <14 days warmup → flag as NOT ready
51
52### 1B — Performance Data
53- Pull campaign analytics from Instantly
54- Ask: "Do you have a spreadsheet with historical outbound data?" If yes, request link.
55
56### 1C — ICP Definition
57If no ICP defined, collect:
58- **Titles:** Who are you targeting? (e.g., VP Marketing, Head of Growth)
59- **Industries:** Which verticals?
60- **Company size:** Employee count or revenue range?
61- **Revenue floor:** Minimum ARR/revenue to qualify?
62- **Anti-ICP:** Who to explicitly exclude?
63
64Use `references/icp-template.md` as the collection template.
65
66### 1D — Business Context
67Collect:
68- What do you sell? (One sentence, no jargon)
69- What's the primary offer? (Free trial, audit, demo, consultation)
70- Real URLs to reference (pricing page, case studies, relevant content)
71- Any proof points? (Client results, stats, social proof)
72
73### 1E — Expert Panel Config
74Default: 10 experts (see `references/expert-panel.md`).
75Ask: "Any industry-specific experts to add, or panelists to swap?" Confirm roster before scoring.
76
77---
78
79## Phase 2: Expert Panel Recursive Scoring
80
81**Target: 90/100. Non-negotiable. Iterate until reached.**
82
83### Round Structure
84Each round produces:
851. **Score table** — all 10 panelists, individual score (0-100), one-line rationale
862. **Aggregate score** — average of all 10
873. **Top weaknesses** — ranked list of what's holding the copy back
884. **Changes made** — specific edits addressing each weakness
895. **Updated copy** — full revised sequence after changes
90
91### Scoring Criteria (per panelist's lens — see `references/expert-panel.md`)
92- Subject line curiosity / open rate potential
93- First sentence pattern interrupt
94- Body clarity and brevity
95- CTA softness and specificity
96- Sequence flow and follow-up logic
97- Deliverability risk signals (spam words, link density)
98- Personalization believability
99
100### Rules
101- Scores must be brutally honest. No padding to 90 without earning it.
102- If round score < 90: identify top 3 weaknesses, revise copy, run next round.
103- If round score ≥ 90: finalize copy and proceed to deliverables.
104- Show every round in the final doc — the iteration trail is part of the value.
105
106---
107
108## Phase 3: Deliverables
109
110### Strategy Doc
111Create a document (Google Doc, Notion, or markdown) with:
112
1131. **Pre-Analysis / Brutal Truth** — what the existing campaigns are doing wrong (or baseline if starting from scratch)
1142. **ICP Summary** — confirmed targeting parameters
1153. **Infrastructure Status** — account inventory, warmup readiness, capacity math
1164. **Scoring Rounds** — full panel vote tables for every round
1175. **Final Email Copy** — all steps for all campaigns, Instantly-ready format
1186. **Implementation Plan** — step-by-step setup instructions
1197. **Capacity Math** — accounts × daily send rate = pipeline projections
1208. **Weekly Metrics Targets** — open rate, reply rate, positive reply rate, meetings booked
1219. **STOP List** — what to kill immediately
12210. **START List** — what to launch first
123
124### Format Rules for Final Copy
125Follow all rules in `references/instantly-rules.md` and `references/copy-rules.md`.
126
127### Human Review Gate
128**Do NOT push anything to Instantly automatically.** The doc is for human review. Get explicit approval before any API writes.
129
130### Iteration
131After review, collect feedback and re-run scoring on revised copy if needed.
132
133---
134
135## Capacity Math Formula
136
137```
138Accounts ready (score ≥80, ≥14 days warmup) × 30 emails/day = conservative daily volume
139Accounts ready × 50 emails/day = aggressive daily volume
140Daily volume × 22 working days = monthly send capacity
141Monthly sends × expected reply rate = expected replies
142Expected replies × qualification rate = pipeline opportunities
143```
144
145---
146
147## Weekly Metrics Targets (Baselines)
148
149| Metric | Good | Great |
150|--------|------|-------|
151| Open rate | 40%+ | 60%+ |
152| Reply rate | 3%+ | 7%+ |
153| Positive reply rate | 1%+ | 3%+ |
154| Meeting rate | 0.5%+ | 1.5%+ |
155
156Adjust targets based on niche and offer. Cold traffic to a free audit converts differently than a paid trial.
157
158---
159
160## Add-On Recommendations (mention but don't build)
161
162- **LinkedIn automation:** HeyReach or similar for multi-channel sequences. Separate workflow.
163- **Lead enrichment:** Clay or Apollo for personalization data before upload.
164- **Lead pipeline:** Use `scripts/lead-pipeline.py` for Apollo → LeadMagic → Instantly automation.
165
166---
167
168## Reference Files
169
170| File | Purpose |
171|------|---------|
172| `references/instantly-rules.md` | Variable syntax, sequence structure, deliverability rules |
173| `references/expert-panel.md` | Default 10-expert roster with scoring lenses |
174| `references/copy-rules.md` | Email copy rules (first sentence, CTA, stats framing) |
175| `references/icp-template.md` | ICP data collection template |
176| `scripts/instantly-audit.py` | Pulls campaigns, accounts, warmup scores via Instantly v2 API |
177| `scripts/lead-pipeline.py` | End-to-end lead sourcing pipeline |
178| `scripts/competitive-monitor.py` | Competitor tracking and intelligence |
179| `scripts/cross-signal-detector.py` | Multi-source signal detection |
180| `scripts/cold-outbound-sender.py` | Send approved outbound emails |