---
name: sarah-setup
version: 1.0.0
description: End-to-end platform setup workflow for SarahAI
metadata:
  requires:
    bins: ["sarah"]
    env: ["SARAH_ACCESS_TOKEN"]
---

# End-to-End Platform Setup

This skill guides you through setting up SarahAI from scratch for a new organization.

## Prerequisites

- A SarahAI account with `SARAH_ACCESS_TOKEN` set
- A Mailgun account for mass email sending
- At least one Gmail/Google Workspace account for SDR follow-ups
- (Optional) ZoomInfo credentials for lead enrichment

## Setup Sequence

### 1. Verify Authentication

```bash
sarah auth token
sarah org check
```

### 2. Configure Mailgun Domain

```bash
sarah mailgun domains add --json '{"domain": "mail.yourcompany.com"}'
# Add DNS records at your registrar
sarah mailgun domains verify
sarah mailgun domains dmarc
```

### 3. Verify Email Inboxes

```bash
sarah inboxes list
sarah inboxes test <inboxId>
sarah inboxes diagnostics <inboxId>
```

### 4. Configure AI SDR

```bash
sarah ai models
sarah ai sdr-config set <inboxId> --json '{"provider": "anthropic", "model": "claude-3-5-sonnet"}'
```

### 5. Build a Prospect List

```bash
sarah prospects create --json '{"name": "Launch Prospects"}'
sarah prospects add-leads <listId> --file prospects.csv
sarah prospects members <listId>
```

### 6. Create and Launch a Campaign

```bash
sarah campaigns create --json '{"name": "Launch Campaign", "prospect_list_id": "<listId>"}'
sarah leads list <campaignId>

# Always dry-run first
sarah campaigns execute <campaignId> --phase mailgun_mass --dry-run
sarah campaigns execute <campaignId> --phase mailgun_mass

# Monitor
sarah campaigns metrics <campaignId>
```

### 7. Monitor and Iterate

```bash
sarah campaigns metrics <campaignId>
sarah inboxes daily-sent
sarah leads list <campaignId>
```

## Safety Checklist

Before executing any campaign phase:
- [ ] Mailgun domain DNS verified (`sarah mailgun domains verify`)
- [ ] Inbox connection healthy (`sarah inboxes test <id>`)
- [ ] Daily send limits checked (`sarah inboxes daily-sent`)
- [ ] Campaign has leads assigned (`sarah leads list <campaignId>`)
- [ ] Dry-run completed successfully (`--dry-run`)
- [ ] User has confirmed execution
