# Lead Generator

> AI voice lead generation agent that qualifies prospects and schedules appointments with closers

- Skill: `sentientsprite/lead-generator` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add sentientsprite/lead-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sentientsprite/lead-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: sentientsprite (https://skillmd.com/u/sentientsprite)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/sentientsprite/lead-generator

---


# Lead Generator Skill

## Overview

Autonomous lead generation agent using AI voice calls to qualify prospects and book appointments with your sales closer.

## Architecture

```
┌─────────────────────────────────────────────────────────────┐
│                    LEAD GENERATOR                           │
├─────────────────────────────────────────────────────────────┤
│  Input Layer          │  Processing Layer   │  Output Layer │
│  ───────────          │  ───────────────    │  ───────────  │
│  • CSV Upload         │  • Qualification    │  • Voice Call │
│  • API (Apollo/etc)   │  • Script Engine    │  • Calendar   │
│  • Web Forms          │  • Lead Scoring     │  • CRM Sync   │
└─────────────────────────────────────────────────────────────┘
                              │
                    ┌─────────▼──────────┐
                    │  Voice Platform    │
                    │  (Bland AI)        │
                    └────────────────────┘
```

## Configuration

### Required Environment Variables

```bash
# Voice Platform (Bland AI Recommended)
BLAND_API_KEY=your_bland_api_key
BLAND_PHONE_NUMBER=your_bland_number

# Calendar Integration
CALENDLY_API_KEY=your_calendly_key
CALENDLY_EVENT_URL=https://calendly.com/your-closer/30min

# CRM (Optional)
HUBSPOT_API_KEY=your_hubspot_key
# or
AIRTABLE_API_KEY=your_airtable_key

# Data Sources
APOLLO_API_KEY=optional_for_prospect_data
```

### Provider Options

#### Voice Platform (Choose One)

**Option A: Bland AI** (Recommended)
```bash
# Pricing: $0.09/minute
# Best for: High-volume, realistic voices
export VOICE_PROVIDER=bland-ai
export BLAND_API_KEY=sk-...
```

**Option B: Retell AI**
```bash
# Pricing: $0.07/minute  
# Best for: Voice cloning (use your salesguy's voice)
export VOICE_PROVIDER=retell-ai
export RETELL_API_KEY=...
```

**Option C: Synthflow**
```bash
# Pricing: $0.05-0.08/minute
# Best for: No-code setup
export VOICE_PROVIDER=synthflow
export SYNTHFLOW_API_KEY=...
```

#### Calendar (Choose One)

```bash
# Option 1: Calendly
export CALENDAR_PROVIDER=calendly
export CALENDLY_EVENT_URL=https://calendly.com/closer/30min

# Option 2: Cal.com
export CALENDAR_PROVIDER=cal-com
export CALCOM_EVENT_TYPE_ID=123

# Option 3: Google Calendar (via Calendly)
export CALENDAR_PROVIDER=google
export GCAL_CLIENT_ID=...
export GCAL_CLIENT_SECRET=...
```

## Quick Start

### 1. Install Prerequisites

```bash
# Install this skill
npx skills add sentientsprite/nemo-skills@lead-generator

# Or manually clone
git clone https://github.com/sentientsprite/nemo-skills.git
cd nemo-skills/lead-generator
npm install
```

### 2. Set Up Voice Platform

```bash
# Sign up at bland.ai
# Get API key from dashboard
export BLAND_API_KEY=sk-your-key-here

# Purchase phone number (or use provided)
export BLAND_PHONE_NUMBER=+1-555-123-4567
```

### 3. Configure Calendar

```bash
# Connect Calendly
# 1. Go to calendly.com/integrations/api-webhooks
# 2. Copy your API key
export CALENDLY_API_KEY=eyJ...

# 3. Get event type URL
export CALENDLY_EVENT_URL=https://calendly.com/your-closer/sales-call
```

### 4. Create First Campaign

```bash
# Create campaign config
cat > campaign.yaml <<EOF
name: "Agency Launch Campaign"
description: "Outbound to small business owners"

# Target audience
target:
  industry: ["ecommerce", "saas", "local-services"]
  company_size: "10-50 employees"
  title_keywords: ["owner", "founder", "ceo", "marketing director"]

# Voice settings
voice:
  provider: bland-ai
  voice_id: "maya"  # Options: maya, josh, mark, etc.
  language: "en-US"
  speed: 1.0

# Conversation script
script:
  opening: |
    Hi {{first_name}}, this is Maya from {{agency_name}}. 
    We help {{industry}} companies double their qualified leads in 90 days. 
    Do you have 2 minutes?
  
  qualification_questions:
    - "What's your current lead generation process?"
    - "How many qualified leads are you getting per month?"
    - "What's your target cost per lead?"
    - "Are you the decision maker for marketing?"
  
  value_proposition: |
    We've helped similar {{industry}} companies increase leads by 150% 
    while reducing cost per acquisition by 40%.
  
  close: |
    I'd love to have you speak with {{closer_name}}, our lead generation specialist. 
    He has a few openings this week. What works better, Tuesday or Thursday?

# Scheduling
scheduling:
  timezone_aware: true
  business_hours: "9am-5pm"
  retry_attempts: 3
  retry_interval: "24h"

# Disqualification criteria
disqualify:
  - "not interested"
  - "no budget"
  - "wrong person"
  - "do not call"

# Handoff to closer
handoff:
  send_recording: true
  send_transcript: true
  send_notes: true
  notification_method: "email"  # email, slack, webhook
EOF
```

### 5. Run Campaign

```bash
# Upload prospect list
./lead-generator upload-prospects --file prospects.csv --campaign campaign.yaml

# Start calling
./lead-generator start-campaign --campaign campaign.yaml

# Monitor dashboard
./lead-generator dashboard
```

## Commands

### Campaign Management

```bash
# Create new campaign
lead-generator create-campaign --name "Q1 Outreach"

# Upload prospects
lead-generator upload --file leads.csv --campaign my-campaign

# Start calling
lead-generator start --campaign my-campaign

# Pause campaign
lead-generator pause --campaign my-campaign

# Resume campaign
lead-generator resume --campaign my-campaign

# Get campaign stats
lead-generator stats --campaign my-campaign
```

### Testing

```bash
# Test single call
lead-generator test-call --phone +1234567890 --script my-script.yaml

# Test voice quality
lead-generator test-voice --voice maya

# Test calendar booking
lead-generator test-calendar --email test@example.com
```

### Analytics

```bash
# Show dashboard
lead-generator dashboard

# Export results
lead-generator export --campaign my-campaign --format csv

# Get call recordings
lead-generator recordings --campaign my-campaign
```

## Conversation Script Templates

### Template 1: Direct Pitch

```yaml
name: "Direct Pitch - 2min"
target: "Warm leads (downloaded content, attended webinar)"

greeting: |
  Hi {{first_name}}, this is {{ai_name}} from {{agency_name}}.
  You downloaded our {{lead_magnet}} last week. 
  Have you had a chance to look at it?

qualification:
  - "What resonated most with what you saw?"
  - "What's your biggest challenge with {{problem}} right now?"
  - "If we could solve that, what would it mean for your business?"

bridge: |
  Based on what you're saying, it sounds like you're a perfect fit 
  for our {{program}}. {{closer_name}} has helped 50+ companies 
  in {{industry}} solve exactly this.

close: |
  He's got a couple openings this week. 
  Are mornings or afternoons better for you?

voicemail: |
  Hi {{first_name}}, this is {{ai_name}} from {{agency_name}}.
  You downloaded our {{lead_magnet}}. I'd love to chat about 
  what we found works in {{industry}}. Call me back at 
  {{callback_number}} or grab time at {{calendar_link}}.
```

### Template 2: Referral Approach

```yaml
name: "Referral - 3min"
target: "Cold leads from purchased lists"

greeting: |
  Hi {{first_name}}, this is {{ai_name}} from {{agency_name}}.
  We were referred to you by {{mutual_connection}}.
  Do you have a quick minute?

qualification:
  - "How do you currently handle {{problem}}?"
  - "What would solving this be worth to you monthly?"
  - "When are you looking to make a change?"

objection_handling:
  "not interested": |
    Totally understand. Can I ask - is it the timing, 
    or are you happy with your current solution?
  
  "send me an email": |
    I'd love to, but honestly, our best results come from 
    a 10-minute conversation. What time works tomorrow?
  
  "too expensive": |
    I hear that. Most of our clients say that upfront. 
    But they're seeing 3-5x ROI in the first month. 
    Worth a 15-minute call to see the numbers?

close: |
  {{closer_name}} is our {{specialist}}. He has 15 years 
  in {{industry}} specifically. Can I book you for 
  a quick strategy call?
```

## Integration with Closer

### Handoff Data

When appointment is booked, closer receives:

```json
{
  "prospect": {
    "name": "John Smith",
    "phone": "+1-555-123-4567",
    "email": "john@company.com",
    "company": "Acme Inc",
    "industry": "SaaS"
  },
  "qualification": {
    "budget": "$5k-10k/month",
    "authority": "Decision maker",
    "need": "More qualified leads",
    "timeline": "30 days"
  },
  "call_data": {
    "recording_url": "https://...",
    "transcript": "Hi John...",
    "duration": "4m32s",
    "sentiment": "positive",
    "objections_raised": ["price"]
  },
  "appointment": {
    "datetime": "2026-03-03T14:00:00Z",
    "timezone": "America/Denver",
    "calendar_link": "https://calendly.com/..."
  },
  "lead_score": 85
}
```

### Notification Methods

```bash
# Email notification
export NOTIFICATION_METHOD=email
export CLOSER_EMAIL=sales@youragency.com

# Slack notification
export NOTIFICATION_METHOD=slack
export SLACK_WEBHOOK=https://hooks.slack.com/...

# Webhook (for custom CRM)
export NOTIFICATION_METHOD=webhook
export WEBHOOK_URL=https://your-crm.com/api/new-lead
```

## Advanced Features

### Lead Scoring

Automatic scoring based on:
- Engagement level (questions asked)
- Budget disclosed
- Timeline urgency
- Authority level
- Sentiment analysis

```bash
# High-quality leads (score > 80) → Priority booking
# Medium-quality (50-80) → Standard booking
# Low-quality (<50) → Nurture sequence
```

### A/B Testing

```bash
# Test two scripts
lead-generator test --campaign my-campaign --script-a script-a.yaml --script-b script-b.yaml --sample 50

# Get results
lead-generator test-results --test-id abc123
```

### Follow-up Sequences

```bash
# If no answer, schedule retry
lead-generator schedule-followup --campaign my-campaign --delay 24h

# If voicemail left, send SMS
lead-generator send-sms --template voicemail-followup
```

## Analytics Dashboard

Metrics tracked:
- **Calls Made** — Total attempts
- **Connect Rate** — % who answered
- **Qualification Rate** — % who passed BANT
- **Appointment Rate** — % who booked
- **Cost Per Lead** — Total spend / qualified leads
- **Cost Per Appointment** — Total spend / appointments
- **Pipeline Value** — Est. revenue from booked calls

## Troubleshooting

### Common Issues

**"No answer" rate too high**
- Check calling times (best: Tue-Thu, 10am-4pm)
- Verify phone numbers
- Add local caller ID

**Low qualification rate**
- Refine prospect list (better targeting)
- Adjust opening hook
- Add pre-qualification questions

**Appointments not showing up**
- Add confirmation SMS
- Call reminder 24hr before
- Call reminder 1hr before
- Send prep email with agenda

**High cost per lead**
- A/B test scripts
- Improve targeting
- Add disqualification earlier
- Test different voices

## Cost Optimization

### Budget Scenarios

**Starter ($200/month)**
- ~400 minutes talk time
- ~100 calls
- ~10-15 appointments
- Break-even: 1-2 closed deals

**Growth ($500/month)**
- ~1000 minutes talk time
- ~250 calls
- ~25-40 appointments
- Break-even: 2-4 closed deals

**Scale ($1000/month)**
- ~2000 minutes talk time
- ~500 calls
- ~50-75 appointments
- Break-even: 3-6 closed deals

## Compliance

### TCPA Compliance

- Only call 9am-8pm local time
- Honor DNC (Do Not Call) list
- Provide opt-out mechanism
- Keep call records for 4 years

### GDPR (if calling EU)

- Consent required
- Right to be forgotten
- Data processing disclosure

## Support

### Getting Help

```bash
# Documentation
lead-generator docs

# Check status
lead-generator status

# Debug mode
lead-generator debug --campaign my-campaign

# Contact support
lead-generator support
```

### Community

- Discord: https://discord.gg/nemo
- Issues: https://github.com/sentientsprite/nemo-skills/issues

## Roadmap

### v1.1 (Next)
- [ ] WhatsApp integration
- [ ] Email follow-up sequences
- [ ] Advanced sentiment analysis
- [ ] CRM integrations (Salesforce, HubSpot)

### v1.2
- [ ] Multi-language support
- [ ] Voice cloning for your salesguy
- [ ] AI script optimization
- [ ] Competitor mention detection

## License

MIT — Use freely for your agency