aiagentwithdhruv/casualize-names

Casualize Names Workflow

Goal

Convert formal names (first names, company names, cities) to casual, friendly versions suitable for cold email copy.

Scripts

• ./scripts/casualize_batch.py - Main script (all 3 fields at once)
• ./scripts/casualize_company_names_batch.py - Company names only
• ./scripts/casualize_first_names_batch.py - First names only
• ./scripts/casualize_city_names_batch.py - City names only

Quick Start

# Process all three fields at once (recommended, 3x faster)
python3 -u ./scripts/casualize_batch.py "GOOGLE_SHEET_URL"

# Re-process existing (overwrite)
python3 -u ./scripts/casualize_batch.py "GOOGLE_SHEET_URL" --overwrite

How It Works

1. Processes records in batches of 50
2. Uses 5 parallel workers
3. Claude converts all three fields in one API call
4. Batch updates Google Sheet with results
5. Only processes rows with emails

Performance: ~35 records/sec (3,000 records ≈ 90 seconds)

Casualization Rules

First Names

• Use common nicknames: "William" → "Will", "Jennifer" → "Jen"
• Keep original if no common nickname exists
• Keep it professional

Company Names

• Remove "The" at beginning
• Remove legal suffixes (LLC, Inc, Corp, Ltd)
• Remove generic words (Realty, Group, Solutions, Services)
• Keep core brand name
• Use "you guys" for overly generic names

Examples:

• "Keller Williams Realty Inc" → "Keller Williams"
• "The Teal Umbrella Family Dental Healthcare" → "Teal Umbrella"

City Names

• Use local nicknames: "San Francisco" → "SF", "Philadelphia" → "Philly"
• Keep original if no common nickname

Output

Creates three new columns:

• casual_first_name
• casual_company_name
• casual_city_name

Environment

ANTHROPIC_API_KEY=your_key

---

Schema

Inputs

| Name | Type | Required | Description | |------|------|----------|-------------| | sheet_url | string | Yes | Google Sheet URL with lead data | | overwrite | boolean | No | Re-process existing casualized names |

Outputs

| Name | Type | Description | |------|------|-------------| | sheet_url | string | Same sheet with casual_first_name, casual_company_name, casual_city_name columns added |

Credentials

| Name | Source | |------|--------| | ANTHROPIC_API_KEY | .env |

Composable With

Skills that chain well with this one: scrape-leads, gmaps-leads, instantly-campaigns

Cost

~35 records/sec, minimal API cost