# Auto Research Public

Autonomous cold email campaign launcher.

- Repository: https://github.com/growthenginenowoslawski/coldoutboundskills (797 stars)
- Category: Data and ML
- License: MIT
- Last updated: 2026-10-05
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add growthenginenowoslawski/coldoutboundskills --skill auto-research-public -g -a claude-code -y`
Codex: `npx skills add growthenginenowoslawski/coldoutboundskills --skill auto-research-public -g -a codex -y`
Cursor: `npx skills add growthenginenowoslawski/coldoutboundskills --skill auto-research-public -g -a cursor -y`
Gemini CLI: `npx skills add growthenginenowoslawski/coldoutboundskills --skill auto-research-public -g -a gemini-cli -y`

## Description

Autonomous cold email campaign launcher. Takes one target company domain, scrapes their website, generates an ICP with Claude, pulls matching leads via Prospeo, enriches emails + company descriptions, personalizes each lead with parallel Claude Code Task sub-agents (A/B/C variants), and uploads as a live Smartlead campaign. Uses local JSON files for state (no database required). Use for automated daily campaign launches after you have an initial `client-profile.yaml` from /icp-onboarding. Triggers on "auto-research", "launch an automated campaign", "daily campaign", "run the research loop".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Auto Research (Public)

Automated end-to-end campaign launcher. Feed it one target company domain, get back a live Smartlead campaign with per-lead personalization, in about 20 minutes.

This is the beginner-friendly version of the GEX internal `auto-research-v2`. All state lives in local JSON files; no Supabase, no Trigger.dev.

## What you get

- **Input:** one target company domain + your `client-profile.yaml`
- **Output:** a running Smartlead campaign with:
  - 200-1,000 leads (depending on targeting tightness)
  - Per-lead personalization: 9 custom variables (situation, value, CTA × 3 variants)
  - A/B/C subject + body variants tested in parallel
  - Campaign assigned to your available inboxes
  - Schedule: Mon-Fri 8am-5pm your timezone

## Prerequisites

Before running:
- [ ] `client-profile.yaml` exists (run `/icp-onboarding` if not)
- [ ] `SMARTLEAD_API_KEY` in env
- [ ] `PROSPEO_API_KEY` in env
- [ ] `MILLIONVERIFIER_API_KEY` in env (for email validation)
- [ ] At least 20 Smartlead inboxes tagged "active" (run `/smartlead-inbox-manager` first)
- [ ] At least 1 campaign template in Smartlead (or the script creates a fresh one)

## The orchestration (Claude Code runs this)

Unlike the other skills, this skill orchestrates through the Claude Code conversation itself, Claude does the reasoning (ICP generation, copy writing, personalization), and phase scripts do the heavy API I/O. This is the pattern from the GEX v2 internal.

### Phase 1: Scrape the target company

```bash
npx tsx scripts/phase-scrape.ts --domain=<target.com> --out=/tmp/auto/scrape.json
```

Output: JSON with `domain` + text content from homepage, /about, /product, /pricing, /customers.

Claude reads the output and writes a short analysis to `/tmp/auto/company-analysis.md`:
- What the company does
- Who their likely customers are
- Social proof signals
- Potential angles for outreach

### Phase 2: Claude generates ICP filters

The rest: https://github.com/growthenginenowoslawski/coldoutboundskills/blob/HEAD/skills/auto-research-public/SKILL.md