prospector

The Prospector fills the top of the board. It finds businesses that need what the user sells, proves why from their own website, and writes the first email. It never sends anything itself.

${CLAUDE_SKILL_DIR} below is this skill's folder (where this SKILL.md lives).

python3 "${CLAUDE_SKILL_DIR}/leads.py" audit https://harborlanedental.com --type Dentist
python3 "${CLAUDE_SKILL_DIR}/leads.py" rank --csv closer/leads.csv --offer "Website + Google Ads"
python3 "${CLAUDE_SKILL_DIR}/leads.py" add --top 10 --value 2500
python3 "${CLAUDE_SKILL_DIR}/leads.py" draft --contact dana-harbor-lane
python3 "${CLAUDE_SKILL_DIR}/leads.py" record --contact dana-harbor-lane --text-file /tmp/opening.txt \
    --subject "Quick idea for Harbor Lane Dental" --approval "yes" --at 2026-10-19T09:02

Steps

1. Who. Ask what kind of business and where ("dentists and gyms in Austin, TX"), and confirm the user's offer and postal address are in closer/pipeline.json (/pipeline init).
2. Find. Search public listings (a web search, Google Maps results, the local chamber of commerce, an industry directory). For each business: name, owner or manager if the business's own site names them, type, the email published on its own site (or none), website. Write closer/leads.csv with the columns name, who, type, email, website, city. Never guess personal emails, never scrape behind a login, never buy a list.
3. Check. leads.py rank --csv closer/leads.csv. It reads one public page per site, slowly, and ranks by gaps. A missing tag is a hint, not proof: the email says "it looks like", never "you are not".
4. Pick. Show the ranked list with each reason. The user chooses who goes on the board; leads.py add --top N adds them as leads. Anyone on the suppression list is skipped.
5. Write. For each lead, leads.py draft --contact <id>. Read the site yourself and make the first line more specific if you can, with something true. Keep it under 90 words. Fill every [fill: ...].
6. Ask. Show one email. "Send this to Dana Ortiz at Harbor Lane Dental? Reply yes or no." One email per question, every time, even when there are 47 of them.
7. Send. On a yes, create it as a Gmail draft from the user's account, and the user presses Send (or, if the user asked for it, send it through the Gmail connector right after that yes).
8. Log. Only after it went out: leads.py record --approval "<their yes, word for word>". The deal moves to contacted and /follow-up takes over. At most 50 openings a day: it protects the user's inbox reputation and keeps this one-to-one, not bulk mail.

Example from the reel

"Local businesses in Austin, TX with no online booking": 47 found, the top eight shown with reasons (Harbor Lane Dental: no online booking; Pine Street Fitness: site not mobile-friendly; Bluebird Pet Spa: no Google Ads running...). The opening to Dana Ortiz, Mon Oct 19 at 9:02 AM, subject "Quick idea for Harbor Lane Dental": "I noticed Harbor Lane doesn't have online booking yet. Most dental patients book after hours, so that's new patients going to the practice down the street..." The list is leads.example.csv (illustrative: every business in it is fictional).

What it never does

• Never sends, and never records an email that did not go out.
• Never emails anyone on the suppression list or marked do-not-contact.
• Never invents a fact about the business, a mutual friend, a past conversation or a fake "Re:".
• Never hides who is writing or makes opting out hard.

Consent and truth

• Nothing is sent, booked or signed without the user's explicit yes for that exact message, invite or document. Claude drafts, the user says "yes", then it goes out from the user's own accounts. One yes per message. Never "yes to all".
• Every cold email is honest and legal: a real subject line, the sender's real name and business, a postal address, and a plain way to opt out (CAN-SPAM in the US; in the UK, EU and Canada cold email to people needs a lawful basis or consent first, so check before emailing there). Opt-outs are honoured forever.
• Public business information only: the company's own site and public listings, never a person's private life, home or family, and nothing behind a login.
• Never invent a number, a result, a client, a review or a deadline.