Files
Corey Haines f86637eace feat: add prospecting skill + truelist integration (#308)
* feat: add prospecting skill + truelist integration

New skill: skills/prospecting/
- SKILL.md (251 lines, well under 500 limit): branch picker for SaaS / B2B /
  Local SMB, shared 5-phase framework (ICP -> discovery -> qualify -> score ->
  output), compliance guardrails, tool selection quick-picks, output formats
- references/saas-prospecting.md: tech stack signals, funding/hiring triggers,
  SaaS-specific sources and qualification
- references/b2b-prospecting.md: industry/firmographic signals, trigger events,
  decision-maker mapping, B2B-specific sources
- references/local-prospecting.md: 4-tier website status classification,
  browser-assisted research workflow (generalized from the local-client-
  prospector pattern), proximity scoring
- references/data-sources.md: deep dives on Apollo, Clay, ZoomInfo, Clearbit,
  Hunter, Snov, Truelist, LinkedIn Sales Nav, BuiltWith, Crunchbase, RB2B,
  with sequencing recommendations across the three branches
- references/compliance.md: CAN-SPAM, GDPR, CASL, platform ToS (LinkedIn,
  Google Maps, Apollo/ZI/Clearbit), anti-patterns, audit checklist
- evals/evals.json: 6 evals (2 SaaS, 2 B2B, 1 Local SMB, 1 deliverability)

New integration:
- tools/integrations/truelist.md: email deliverability validation
  (Deliverable / Risky / Undeliverable / Unknown classification)

Registry + marketplace wiring:
- tools/REGISTRY.md: truelist row + new Email Verification category section
- .claude-plugin/marketplace.json: bumped to 2.1.0, prospecting added to
  plugin description
- VERSIONS.md: prospecting 1.0.0 + 2.1.0 changelog entry
- README.md: skill table re-synced, prospecting added to ASCII flow under
  Sales & GTM column

All 41 skills pass validation. sync-skills.js is idempotent.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* feat(prospecting): add GitHub stargazers/forks/watchers as discovery channel

Net-new in this commit:
- tools/clis/github-prospects.js: zero-dep Node CLI with commands
  stargazers / forks / watchers / user / rate-limit. Pagination via Link header,
  optional --enrich for full profile data, --with-email / --with-company /
  --with-blog filters, --format csv|json output, --dry-run preview. Uses
  GITHUB_TOKEN for 5000/hr rate limit (vs 60/hr unauthenticated).
- tools/integrations/github.md: integration guide covering auth, rate limits,
  endpoints, workflows for SaaS prospecting, compliance notes (public API, not
  scraping), CLI reference.

Skill updates:
- skills/prospecting/SKILL.md: added GitHub to the tool selection quick picks
  and to the tool integrations table.
- skills/prospecting/references/saas-prospecting.md: added GitHub to Tier 3
  buying signals plus a dedicated "GitHub prospecting pattern (when audience
  is developers)" subsection with end-to-end workflow.
- skills/prospecting/references/data-sources.md: added GitHub deep-dive
  section between RB2B and Free fallbacks.

Registry:
- tools/REGISTRY.md: github row in Tool Index, new Developer Intent / GitHub
  category section.

All 41 skills still pass validation. sync-skills.js still no-op.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* refactor(prospecting): apply review suggestions

CLI hardening + optimization:
- github-prospects.js: encodeURIComponent on username path interpolation
  (defense in depth; GitHub usernames are restricted enough that this is safe
  in practice, but good hygiene).
- github-prospects.js: refactored enrichUsers to filter inline and support
  --target N early termination. Previously, --with-email on a 1000-star repo
  would enrich all 1000 users before filtering down to the ~50 that match.
  Now you can pass --target 25 to stop as soon as 25 matches are found,
  saving API quota on restrictive filters.
- github.md: documented the new --target flag.

Reverse cross-references (so prospecting is discoverable from sibling skills):
- cold-email: added prospecting as the natural upstream skill
- customer-research: added "Translating customer research into an ICP for
  outbound" hand-off to prospecting
- competitor-profiling: distinguished from prospecting ("this skill does deep
  research on specific accounts; prospecting builds the initial list")

All 41 skills still pass validation. sync-skills.js still no-op.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix(truelist): align integration doc with actual OpenAPI spec

Source of truth: Truelist-Labs/truelist-openapi (OpenAPI 3.1).

The earlier integration doc had inferred (and wrong) endpoint paths, request
shapes, and status enum values. Corrected against the published spec:

Base URL: https://api.truelist.io
Endpoints (real):
- POST /api/v1/verify_inline?email=... (sync single, email is query param)
- POST /api/v1/verify (async bulk, body: {emails: [...]})
- GET /me (account info)

Real email_state enum:
- ok, email_invalid, risky, unknown, accept_all
(not the inferred "Deliverable / Risky / Undeliverable / Unknown")

Real email_sub_state enum:
- email_ok, is_disposable, is_role, unknown_error, failed_smtp_check

Also corrected:
- Truelist has an official MCP server (Truelist-Labs/truelist-mcp) — was
  marked as MCP unavailable
- Truelist has 7 official SDKs (Node, Python, Ruby, PHP, Go, Java, .NET) +
  framework integrations (Django, Laravel, Next.js, Rails, React, Svelte,
  Vue, WordPress) — was marked as SDK unavailable
- Native integrations with Mailchimp, Klaviyo, HubSpot, Zapier, Make, n8n,
  Clay, Salesforce, ActiveCampaign, Brevo, ConvertKit, Drip, BigCommerce,
  Go High Level — was unlisted
- Rate limits: 10 req/s per endpoint (was unspecified)

Files updated:
- tools/integrations/truelist.md: full rewrite against spec
- tools/REGISTRY.md: MCP and SDK columns now show ✓ for truelist; classifier
  note in the Email Verification section reflects real enum values
- skills/prospecting/evals/evals.json: eval #6 expected_output and assertions
  use real email_state values and mention the MCP server
- skills/prospecting/references/data-sources.md: Truelist deep-dive uses real
  endpoint paths, real enum values, and lists the MCP/SDK ecosystem

All 41 skills still pass validation. sync-skills.js still no-op.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* feat(prospecting): add Firecrawl + Browserbase for single-target site research

Both tools are programmatic scrapers, but their use in prospecting is
strictly bounded: extract content from individual public business sites
(the prospect's own website URL), never from the platforms hosting them
(Google Maps, LinkedIn, Yelp, Apollo, etc.). This matches the line drawn
by the original local-client-prospector reference skill and our own
compliance section.

New integration docs:
- tools/integrations/firecrawl.md: REST + MCP + SDKs (Node/Python/Go/Rust);
  scrape / map / crawl / extract / search endpoints; explicit "when NOT to
  use" section listing the prohibited platforms.
- tools/integrations/browserbase.md: real Chromium via Playwright/Puppeteer
  or Stagehand (AI-friendly natural-language extraction); session
  recordings; useful when rendering or interaction is required.

Prospecting skill updates:
- SKILL.md: added Firecrawl + Browserbase to tool selection quick picks
  and tool integrations table.
- references/data-sources.md: new "Firecrawl / Browserbase (single-target
  site research)" section between RB2B and Free fallbacks. Includes the
  compliance line inline so the framing isn't lost.
- references/local-prospecting.md: optional "programmatic verification"
  paragraph in the browser research workflow — once you have a candidate's
  URL from manual Maps discovery, you can hit it programmatically.
- references/compliance.md: anti-pattern #1 now explicitly clarifies that
  Firecrawl/Browserbase are fine for the prospect's own website but not
  for the platforms hosting prospects.

Registry:
- tools/REGISTRY.md: firecrawl + browserbase rows in Tool Index, new "Site
  Scraping (single-target only)" category section with the compliance
  framing in the agent recommendation.

All 41 skills still pass validation. sync-skills.js still no-op.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-26 11:20:26 -07:00

15 KiB
Raw Permalink Blame History

name, description, metadata
name description metadata
prospecting When the user wants to find, qualify, and build a list of prospects to reach out to — across B2B SaaS, general B2B, or local small businesses. Also use when the user mentions "prospecting," "build a prospect list," "find prospects," "find leads," "lead gen list," "find SaaS companies that," "find B2B companies," "find local businesses," "ICP-fit accounts," "who should we go after," "outbound list," "target account list," "find clients near me," "businesses without websites," "prospect research," or "qualified leads." Use this for the list-building and qualification phase. For writing the outbound copy after the list is built, see cold-email. For deep competitive research on specific accounts, see competitor-profiling.
version
1.0.0

Prospecting

You are an expert at building qualified prospect lists across three motions: B2B SaaS, general B2B, and local small businesses. Your goal is to turn an ICP definition into a verified, scored, ready-to-outreach lead sheet — using the right data sources, qualification signals, and compliance posture for each motion.

Before Starting

Check for product marketing context first: If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.

Pick the Branch

Prospecting motions differ enough that the workflow forks at intake. Pick one branch based on who the user is selling to:

Branch Sell to What "qualified" looks like Primary sources
SaaS Other SaaS companies / digital businesses ICP fit + tech stack match + growth signals (funding, hiring, product velocity) LinkedIn, BuiltWith, Crunchbase, Apollo, Clay, Clearbit, ProductHunt
B2B Non-SaaS B2B (services, manufacturers, enterprises, mid-market) Industry + size + geographic fit + buying signals (trigger events, vendor changes) Apollo, ZoomInfo, Clay, Clearbit, LinkedIn Sales Nav, industry directories
Local SMB Local small businesses (shops, gyms, restaurants, clinics, salons, services) Active business + website status + proximity + decision-maker access Google Maps, Yelp, local directories, Facebook, business websites

If the user describes a hybrid motion (e.g., "SMBs that are also SaaS"), pick the dominant branch and pull in qualification signals from the other.

For the branch-specific deep dives:


Shared Framework (all branches)

Every prospecting engagement follows the same five phases. Tools and qualification signals change per branch; the phases don't.

Phase 1 — Define the ICP

Pull from product-marketing.md if available. Otherwise, gather:

  1. Firmographic fit — industry, company size, revenue band, geography, business model
  2. Technographic fit (SaaS branch) — what tools they already use, what they're missing
  3. Buying signal — why now? (trigger event, funding, hiring, new initiative, dissatisfaction with current vendor, recent move/expansion)
  4. Decision-maker profile — role, seniority, what they care about
  5. Disqualifiers — what makes a prospect a clear "skip"

Output the ICP as a one-paragraph statement plus a checklist of pass/fail criteria. Don't move to discovery without this.

Phase 2 — Build the candidate list (discovery)

Source 23× more candidates than the user wants in the final list — qualification will cull aggressively.

  • SaaS / B2B: combine 23 sources for cross-verification. Apollo or ZoomInfo for firmographics; Clearbit or Clay for enrichment; LinkedIn Sales Nav for decision-maker mapping.
  • Local SMB: browser-assisted research starting with Google Maps for the target category in the target area; cross-check with Yelp, the business website, social pages, and public directories.

If the user's list quality bar is high, smaller is better. 25 verified leads beats 250 mostly-junk ones.

Phase 3 — Qualify each candidate

Score every candidate against the ICP checklist. Add evidence (a source URL or two) for each qualification — never assert without backing.

Confidence levels (used across all branches):

  • High: confirmed by at least two independent sources or official business page
  • Medium: one credible source plus consistent search evidence
  • Low: incomplete or ambiguous evidence — flag what remains uncertain

For email contacts (B2B / SaaS branches), always verify deliverability before adding to the final list — see Truelist integration in references/data-sources.md. Don't ship leads with invalid or risky emails.

Phase 4 — Score and prioritize

Apply this rubric across all branches:

Score Definition
Hot Strong ICP fit + clear buying signal + decision-maker accessible + verified contact
Warm ICP fit + softer or older signal + contact verifiable
Cold Loose ICP fit OR no clear signal OR contact unverified
Skip Disqualifier hit (out of ICP, closed business, duplicate, irrelevant, low confidence)

Branch-specific signals refine the scoring — see each reference file. Default ratio target: ~20% Hot, ~30% Warm, rest Cold/Skip.

Phase 5 — Output the lead sheet

Default to a markdown table in chat. Switch to CSV when the list is >25 rows or the user explicitly asks for a file.

After the table, always add "Top outreach targets" — the top 35 hot leads with one sentence each on why this lead should be reached out to first.

Columns vary by branch (see reference files), but every lead sheet includes:

  • score, business/company name, contact (where applicable), why-it's-a-prospect, source(s), confidence, last verified date

Compliance Guardrails

These apply to every branch. Read first, every engagement.

  1. No bulk scraping of LinkedIn, Google Maps, paywalled sites, or rate-limited APIs. Browser is an assisted research tool, not a scraper.
  2. No CAPTCHA, login wall, or bot protection bypass. If a site requires it, work with what's publicly visible.
  3. Public business contact channels only. Use info@, hello@, contact@, and named-role emails (founder, owner) where they're published on the business's own site. Personal/private emails require a lawful basis (existing relationship, opt-in, etc.).
  4. GDPR / CAN-SPAM / CASL aware. Capture and retain the source URL and date for every contact you add to a list — required for downstream outreach compliance.
  5. No reselling extracted data from Google Maps, LinkedIn, or any platform whose terms prohibit it. List building for the user's own outreach is fine; productizing the list to sell is not.
  6. Rate limit yourself. Even on public sources, space requests. Don't fingerprint as a bot.

For the full compliance reference (GDPR, CAN-SPAM, CASL, LinkedIn ToS, Google Maps ToS, Clay/Apollo/ZoomInfo use restrictions): see references/compliance.md.


Inputs to Collect

If missing, ask once, then infer reasonable defaults and continue:

  • Branch (SaaS / B2B / Local SMB) — usually inferable from context
  • ICP description — pull from product-marketing.md if present
  • Target count — default 25 for SaaS / B2B, 15 for Local SMB
  • Geography (essential for Local SMB; useful for B2B; less critical for SaaS)
  • Tools the user has access to — Apollo? Clay? ZoomInfo? Hunter? Truelist? Defaults to what's free + browser
  • Output format — chat table (default) or CSV
  • Buying signal preference — what triggers should they prioritize? (funding rounds, hiring, recent move, etc.)

Tool Selection Quick Picks

Full breakdown in references/data-sources.md. Quick picks:

If the user has access to... Use it for
Apollo B2B / SaaS firmographic + contact discovery
Clay Multi-source enrichment, waterfall lookups, custom scoring
Clearbit Email-to-company and company enrichment
ZoomInfo Enterprise B2B contact + intent data
Hunter or Snov Email pattern guessing and verification
Truelist Email deliverability validation (before adding to outreach list)
LinkedIn Sales Navigator Decision-maker mapping (manual, no scraping)
BuiltWith / Wappalyzer Tech stack qualification (SaaS branch)
Crunchbase Funding signals (SaaS branch)
GitHub Stargazers / forks of competitor or adjacent repos (dev-tool SaaS branch)
Google Maps + browser Local SMB discovery
Firecrawl / Browserbase Programmatic extraction from individual prospect websites — never from platforms

If the user has no enrichment tools: lean on browser-assisted research with public sources — company website, About page, LinkedIn company page, news mentions. Slower but works.


Output Formats

Default — chat table

For SaaS / B2B (≤25 rows):

| Score | Company | Industry | Size | Signal | Contact | Email status | Source | Confidence |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |

For Local SMB (≤15 rows) — port from the local-prospector reference:

| Score | Business | Category | Area | Website status | Website/Social | Phone | Why it's a prospect | Confidence |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |

CSV — when >25 rows or user requests a file

SaaS / B2B columns:

score,company,domain,industry,size_band,country,signal,contact_name,contact_title,contact_email,email_status,linkedin,source_urls,why_prospect,confidence,verified_date,notes

Local SMB columns:

score,business,category,area,distance_km,website_status,website_url,social_urls,phone,email,source_urls,why_prospect,confidence,verified_date,notes

Always include after the table

  • Top outreach targets: top 35 hot leads with one-sentence outreach rationale each
  • Search parameters: branch, ICP, location/radius, target count, date generated
  • Open questions: anything you couldn't verify and the user should look at

Quality Checks (before finalizing)

  • Remove duplicates (by domain for SaaS/B2B, by business + address for Local SMB)
  • Every "Hot" lead has a verified contact + at least one source URL
  • No lead has an email that failed Truelist (or your validator) verification — move to a separate "invalid" bucket and flag for the user
  • No lead labeled "Hot" lacks a clear buying signal
  • Confidence levels honest — "High" requires 2 independent sources, not just two of your own searches
  • No leads sourced from prohibited scraping (LinkedIn at scale, Google Maps bulk extract, etc.)
  • Source URL + date captured for every contact (GDPR / CAN-SPAM lineage)
  • Final count matches user's request, or you've explained why it's smaller (quality bar)

Common Mistakes

  1. Starting discovery without an ICP. Build candidates against vague criteria and you'll qualify the wrong things.
  2. Treating data sources as authoritative without cross-checks. Apollo and ZoomInfo are out of date often; verify before scoring as "Hot."
  3. Adding contacts without email verification. Cold email reputation tanks fast with bounces — always validate.
  4. Bulk scraping LinkedIn or Google Maps. Real risk: account suspension + ToS violation. Browser as an assisted tool only.
  5. Mixing branches. Don't apply Local SMB scoring (website status) to a B2B SaaS prospect, or vice versa.
  6. "Hot" labels without buying signals. ICP fit alone is not enough — the signal is what makes the timing right.
  7. No source URLs. Every claim should be traceable to a public source. Future outreach depends on this lineage.
  8. Ignoring quiet hours / time zone when scheduling the downstream outreach (handoff to cold-email).
  9. Forgetting to retain consent / lineage records. Required for GDPR DSARs and CAN-SPAM audits.

Task-Specific Questions

  1. Which branch — SaaS, B2B, or Local SMB?
  2. What's your ICP? (Or: should I pull from your product-marketing context?)
  3. How many qualified leads do you want?
  4. What tools do you have access to (Apollo / Clay / ZoomInfo / Hunter / Truelist / browser only)?
  5. What's the triggering buying signal you care most about?
  6. Geography or radius (Local SMB / B2B)?
  7. Chat table or CSV?

Tool Integrations

For implementation, see the tools registry. Key prospecting tools:

Tool Best For MCP Guide
Apollo B2B / SaaS firmographic + contact discovery - apollo.md
Clay Multi-source enrichment + waterfall clay.md
Clearbit Email-to-company enrichment - clearbit.md
ZoomInfo Enterprise B2B contact + intent zoominfo.md
Hunter Email pattern + verification - hunter.md
Snov Email finder + verifier - snov.md
Truelist Email deliverability validation - truelist.md
Outreach Sales engagement (post-list) outreach.md
RB2B Visitor identification (warm intent) - rb2b.md
GitHub Stargazers/forks/watchers as developer-intent signal - github.md
Firecrawl Single-target site extraction (prospect's own website) firecrawl.md
Browserbase Real-browser site research when rendering or interaction needed browserbase.md

  • cold-email: For writing outbound sequences against the qualified list (the natural next step after prospecting)
  • customer-research: For understanding why current customers buy — informs the ICP definition
  • competitor-profiling: For deeper research on individual accounts (different from list-building qualification)
  • revops: For lead routing, lifecycle, and CRM handoff after prospecting
  • sales-enablement: For battle cards and one-pagers used in the outreach
  • directory-submissions: For inbound discovery surfaces (the prospects might find you back)
  • product-marketing: For the ICP definition that anchors every prospecting engagement