@lztek/sarah-sells 0.1.0

package/skills/sarah-prospects/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: sarah-prospects
+version: 1.0.0
+description: Prospect list management for SarahAI
+metadata:
+  requires:
+    bins: ["sarah"]
+    env: ["SARAH_ACCESS_TOKEN"]
+---
+
+# Prospect List Management
+
+Prospect lists are named, reusable collections of contacts. Prospects become leads once they are assigned to a campaign and engaged.
+
+## Critical Rules
+
+- **Always name lists descriptively.** Use names like "Q1 Texas Roofers" or "East Coast Woundcare Facilities" so lists are identifiable.
+- **CSV files must have headers.** Required columns: `email`. Optional: `first_name`, `last_name`, `company`, `title`.
+- **Duplicate emails within a list are ignored.** The `prospect_list_members` table enforces uniqueness on `(prospect_list_id, lead_id)`.
+- **Assigning a list to a campaign syncs members to `campaign_leads`.** Use `--dry-run` on `sarah prospects assign` to preview before syncing.
+- **Deleting a list removes member links but not the leads themselves.** Leads persist in the `leads` table even after their list is deleted.
+
+## Workflow
+
+```bash
+# Create a list
+sarah prospects create --json '{"name": "Q1 Texas Roofers", "description": "Roofing companies in Texas metro areas"}'
+
+# Import contacts from CSV
+sarah prospects add-leads <listId> --file texas_roofers.csv
+
+# Review the list
+sarah prospects get <listId>
+sarah prospects members <listId>
+
+# Assign to a campaign (dry-run first)
+sarah prospects assign <listId> --campaign <campaignId> --dry-run
+sarah prospects assign <listId> --campaign <campaignId>
+```
+
+## Source Types
+
+- `csv` -- Imported from CSV file
+- `zoominfo` -- Imported from ZoomInfo
+- `manual` -- Manually added
+- `mixed` -- Multiple sources

package/skills/sarah-setup/SKILL.md

@@ -0,0 +1,93 @@
+---
+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

package/skills/sarah-zoominfo/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: sarah-zoominfo
+version: 1.0.0
+description: ZoomInfo lead enrichment and import for SarahAI
+metadata:
+  requires:
+    bins: ["sarah"]
+    env: ["SARAH_ACCESS_TOKEN"]
+---
+
+# ZoomInfo Integration
+
+SarahAI integrates with ZoomInfo for lead discovery and enrichment.
+
+## Critical Rules
+
+- **ZoomInfo requires a valid bearer token.** Ensure ZoomInfo OAuth is configured in the platform settings before using search/import.
+- **Search before importing.** Use `sarah zoominfo search` to preview results, then import the contacts you want.
+- **Imported contacts are deduplicated by email.** Existing leads with the same email are updated, not duplicated.
+- **Assign imported leads to a campaign.** After import, use `sarah zoominfo assign` to link leads to a campaign.
+
+## Workflow
+
+```bash
+# 1. Search for contacts
+sarah zoominfo search --json '{"companyName": "Acme Roofing", "jobTitle": "Owner", "location": "Texas"}'
+
+# 2. Import selected contacts
+sarah zoominfo import --json '[{"firstName": "John", "lastName": "Doe", "email": "john@acme.com", ...}]'
+
+# 3. Assign to campaign
+sarah zoominfo assign --campaign <campaignId> --leads <leadId1>,<leadId2>
+```
+
+## Alternative: Import into Prospect List
+
+For reusable lead collections, import into a prospect list instead:
+
+```bash
+sarah prospects create --json '{"name": "ZoomInfo - Texas Roofers"}'
+sarah prospects add-leads <listId> --json '[...]'
+sarah prospects assign <listId> --campaign <campaignId>
+```