list-builder

Builds qualified B2B lead lists via multi-provider discovery, AI scoring, and contact enrichment.

Updated May 28, 2025
One-click install
npx skills add https://github.com/meloShaya/insteltech --skill list-builder-meloshaya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: list-builder
Source: https://github.com/meloShaya/insteltech/tree/main/crm/library/skills/list-builder
Command: npx skills add https://github.com/meloShaya/insteltech --skill list-builder-meloshaya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tsx, gspread, and includes scripts (resource) and references (resource) components.

What problem does it solve? Building a comprehensive, qualified lead list requires juggling multiple data providers, deduplicating results, qualifying companies against an ICP, and finding verified contact emails — a slow, error-prone manual process that usually misses large segments of the market. ## Core Features & Use Cases - End-to-end lane orchestration: Resumable one-command scripts (run-lane, snowball, contacts) drive discovery, AI qualification with GPT-5-nano, live-website verification, and uncapped contact pulls from GetLeads, Blitz, and Prospeo. - Exhaustive-sweep snowballing: Confirmed fits feed back as seeds to sweep every matching industry and keyword until rounds add under 2-3% net-new companies, maximizing recall. - Email readiness: Merges provider contacts into leads-final.csv with verification status, ready for MillionVerifier validation before any campaign upload. - Use Case: A client asks for every US wealth management firm with 10-200 employees. You fill a 7-line intake brief, run the judge builder and lane scripts, and receive a verified company list plus a deduplicated contact file pushed to a Google Sheet or CSV. ## Quick Start Ask the assistant to build a lead list for your target market, providing seed companies, ICP description, employee band, geography, and target titles so it can run the list-builder lane end to end.

Frequently Asked Questions about list-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a qualified B2B lead list with this skill?

Start with the intake brief: seed companies, ICP one-liner, employee band, geography, and target titles. Then run make-judge.ts to generate the scoring prompt, run-lane.ts for the full pipeline, and contacts.ts after the lane reports READY.

What data providers does the lead list builder use?

Discovery uses Prospeo company search, GetLeads, Blitz, Google Maps, and lookalike sources like Exa and Parallel. Contacts come from a GetLeads to Blitz to Prospeo waterfall, and emails are validated with MillionVerifier before sending.

What API keys are required to run the list builder?

PROSPEO_API_KEY and OPENAI_API_KEY are required for company search and GPT-5-nano judging. GetLeads, Blitz, Exa, Parallel, MillionVerifier, and a Postgres registry URL are optional and degrade gracefully when unset.

Can I resume a failed or interrupted lane run?

Yes, every stage is resumable from artifacts. Re-run the exact same run-lane or snowball command after any failure; the summary.md first line shows READY or NOT READY with the next command to execute.

Are provider emails safe to send to directly?

No. Provider verification statuses from GetLeads, Blitz, and Prospeo are hints only. The skill writes leads-final.csv with an email_status column, and you must validate the whole file with MillionVerifier, keeping only ok results.

How does the skill avoid re-judging the same companies?

Each run keeps a write-ahead log of judged domains for per-run dedup. Setting LIST_REGISTRY_DB_URL enables a Postgres registry table that dedupes against every previous lane run for the client.