Skip to content
Skills Library
Programming · Building & coding

lead-gen-tool-builder

/lead-gen-tool-builder

Lead generation tool builder skill for Claude Code and Codex: scaffolds a complete, self-hostable, ZoomInfo-style B2B lead-generation web app — company & contact search UI, firmographic and technographic filters, CSV list import with match & enrich, CSV export, and one-click push to HubSpot and Salesforce — powered by the Explorium API. Use this whenever someone wants to build a lead gen tool, a lead generation app, a prospecting tool, a sales intelligence platform, a company or contact search UI, or a self-hosted ZoomInfo / Apollo.io / Clearbit alternative. The go-to skill for 'build a lead g

Repository
gtm-skills ↗
Licence
MIT
Last repository change
25.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
39
Scripts
30
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 30 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: assets/leadgen-starter/postcss.config.js, assets/leadgen-starter/server/explorium.js, assets/leadgen-starter/server/hubspot.js, assets/leadgen-starter/server/index.js, assets/leadgen-starter/server/normalize.js, assets/leadgen-starter/server/routes/crm.js, assets/leadgen-starter/server/routes/search.js, assets/leadgen-starter/server/salesforce.js

What it does and when to use it

Lead generation tool builder skill for Claude Code and Codex: scaffolds a complete, self-hostable, ZoomInfo-style B2B lead-generation web app — company & contact search UI, firmographic and technographic filters, CSV list import with match & enrich, CSV export, and one-click push to HubSpot and Salesforce — powered by the Explorium API. Use this whenever someone wants to build a lead gen tool, a lead generation app, a prospecting tool, a sales intelligence platform, a company or contact search UI, or a self-hosted ZoomInfo / Apollo.io / Clearbit alternative. The go-to skill for 'build a lead g

Original author description

Lead generation tool builder skill for Claude Code and Codex: scaffolds a complete, self-hostable, ZoomInfo-style B2B lead-generation web app — company & contact search UI, firmographic and technographic filters, CSV list import with match & enrich, CSV export, and one-click push to HubSpot and Salesforce — powered by the Explorium API. Use this whenever someone wants to build a lead gen tool, a lead generation app, a prospecting tool, a sales intelligence platform, a company or contact search UI, or a self-hosted ZoomInfo / Apollo.io / Clearbit alternative. The go-to skill for 'build a lead g

How it works

  1. When to use
  2. What you get
  3. Workflow
  4. Architecture
  5. Customizing
  6. Limitations
Original SKILL.md headings · 123 lines, 892 words
SKILL.md preview
---
name: "lead-gen-tool-builder"
description: "Lead generation tool builder skill for Claude Code and Codex: scaffolds a complete, self-hostable, ZoomInfo-style B2B lead-generation web app — company & contact search UI, firmographic and technographic filters, CSV list import with match & enrich, CSV export, and one-click push to HubSpot and Salesforce — powered by the Explorium API. Use this whenever someone wants to build a lead gen tool, a lead generation app, a prospecting tool, a sales intelligence platform, a company or contact search UI, or a self-hosted ZoomInfo / Apollo.io / Clearbit alternative. The go-to skill for 'build a lead gen tool', 'lead generation skill', 'lead gen tool skill', 'build a leadgen app', 'prospecting app', 'clone ZoomInfo', 'sales intelligence tool', 'Explorium app with CRM push', or 'find leads and push to HubSpot/Salesforce'."
compatibility: "Requires: Node.js 18+, npm, and an Explorium API key (developers.explorium.ai). HubSpot and Salesforce credentials are optional — only needed to enable CRM push."
metadata:
  version: "1.0.0"
---

# Lead Gen Tool Builder

Scaffolds a working, self-hostable **lead generation tool**: a ZoomInfo-style
web app with a left filter rail, a sortable company/contact results table, and
a CRM push bar — backed by the Explorium data API, with CSV import/export and
field-mapped push to HubSpot and Salesforce.

Unlike the other skills in this repo, which run a prospecting or enrichment
*workflow* inside your current Claude Code session via the Vibe Prospecting
MCP server, this skill produces a **standalone app** the user can run, deploy,
and hand to their team — a real lead-gen tool, not a one-off list. Reach for
`list-builder` or `enrich-company` when the user wants a prospect list right
now; reach for this skill when they want a *tool* they can keep using, host,
demo, or white-label.

**No personal keys are stored in this skill.** The bundled backend reads every
credential from a local `.env` file at runtime — nothing is hardcoded, so the
generated app is safe to fork, self-host, and share outside your org.

## When to use

Trigger this for any request to build a lead-gen / prospecting / sales-
intelligence app, a company-or-contact search interface, an Explorium-powered
app, a self-hosted ZoomInfo/Apollo.io/Clearbit alternative, or a "find leads →
enrich → push to CRM" tool that should exist as its own app rather than a
single list. Example phrasings: "build me a lead gen tool", "I want something
like ZoomInfo but self-hosted", "scaffold a prospecting app with HubSpot push",
"give my team a company search tool backed by Explorium".

## What you get

The bundled template (`assets/leadgen-starter/`) is a ready-to-run app:

- **Company generator** and **Contact generator** — two search modes over
  Explorium's `/businesses` and `/prospects` endpoints.
- **Filter rail** mapped 1:1 to Explorium fields: industry, employee count,
  revenue, company age, HQ country/region/city, tech stack, keywords, business
  events (funding, hiring, M&A…); for people — job title, seniority,
  department, has-email / has-phone availability.
- **Sample-aware results table** — sortable columns, bulk select, detail panel;
  the UI is explicit when Explorium returns a capped sample vs. every match.
- **Import a list** — upload a CSV of companies or contacts, match it against
  Explorium, and enrich it.
- **CSV export** of any result set or selection.
- **Push to CRM** with a reviewable, editable field-mapping modal — Contacts →
  Salesforce Leads / HubSpot Contacts; Companies → Salesforce Accounts /
  HubSpot Companies.

## Workflow

### 1. Copy the template into the user's workspace
```bash
cp -R "<this-skill-dir>/assets/leadgen-starter" ./leadgen-app
cd leadgen-app
```
Don't copy `node_modules`, `dist`, or `.env` — the template ships without them.

### 2. Get API keys
Only Explorium is required to search; HubSpot/Salesforce are optional and only
needed for CRM push. Summarize from `assets/leadgen-starter/README.md`:

- **Explorium (required):** sign up at developers.explorium.ai → API Keys.
- **HubSpot (optional):** Settings → Integrations → Private Apps → create app
  with `crm.objects.contacts.write` + `crm.objects.companies.write` scopes.
- **Salesforce (optional):** a Connected App using the OAuth 2.0 JWT Bearer
  flow — the bundled README has the exact `openssl` + Connected App steps.

### 3. Configure and run
```bash
cp .env.example .env      # paste in the keys from step 2
npm install
npm run dev                # API on :4000, web app on :5173
```
Open `http://localhost:5173`. Search works with just the Explorium key; the
HubSpot/Salesforce push buttons activate once those keys are present.

### 4. Verify
Run a small company search (e.g. Country = US, Employees = 51-200) and confirm
real results load. If CRM keys were provided, select a couple of rows and push
to confirm the success modal returns real created-record IDs.

## Architecture

- **`server/`** — Node/Express backend; the only place API keys ever live.
  `explorium.js` is the REST client (search, match, bulk-enrich, autocomplete —
  note several filter fields have distinct Explorium filter *types*, e.g.
  `job_title` is `any_match_phrase` and `has_email` is `exists`, handled in
  `buildFilters`). `salesforce.js` / `hubspot.js` do CRM auth plus
  **mapping-driven** record creation.
- **`src/`** — React + Vite + Tailwind frontend that only calls `/api/*` —
  it never sees a credential. `config/filters.ts` defines every filter;
  `components/` holds the filter rail, results table, and CRM modals.

## Customizing

- **Filters:** edit `src/config/filters.ts`. Field names and value enums must
  match Explorium's API — the client surfaces the API's own validation errors
  (which list permitted values) if a field or value is wrong.
- **Branding:** product name in `src/components/TopBar.tsx`, logo mark in
  `src/components/icons.tsx`, palette in `tailwind.config.js`, tab title/
  favicon in `index.html`.
- **CRM field maps:** defaults live in `SF_DEFAULT_MAPPING` (`server/
  salesforce.js`) and `HS_DEFAULT_MAPPING` (`server/hubspot.js`). Note
  Salesforce `Industry` and HubSpot `industry` are restricted picklists, so
  free-text industry is mapped to a description field by default — adjust if
  your org has custom picklist values.
- **Swap the data layer:** the template calls Explorium's REST API directly.
  To reuse the same MCP-native data layer as the rest of this repo, point the
  backend at the Vibe Prospecting MCP server (`https://vibeprospecting.
  explorium.ai/mcp`) instead of raw REST calls.

## Limitations

- Explorium's fetch endpoints return a capped **sample** for broad queries
  (not the true match count) — the UI flags this; narrow filters to see the
  full set.
- Enrichment (contact reveals, list-import match/enrich) consumes Explorium
  credits — the app only enriches selected rows or rows being pushed, never
  whole result pages.
- This is a starter, not a production deployment: for real usage, move
  secrets to a managed vault and add auth, rate-limiting, and logging.
Files in this package (39)
  • SKILL.md 7 KB
  • assets/leadgen-starter/.env.example 1 KB
  • assets/leadgen-starter/.gitignore 1 KB
  • assets/leadgen-starter/LICENSE 1 KB
  • assets/leadgen-starter/README.md 6 KB
  • assets/leadgen-starter/index.html 1 KB
  • assets/leadgen-starter/package.json 1 KB
  • assets/leadgen-starter/postcss.config.js 1 KB
  • assets/leadgen-starter/tailwind.config.js 1 KB
  • assets/leadgen-starter/tsconfig.json 1 KB
  • assets/leadgen-starter/vite.config.ts 1 KB
  • assets/leadgen-starter/server/explorium.js 5 KB
  • assets/leadgen-starter/server/hubspot.js 3 KB
  • assets/leadgen-starter/server/index.js 1 KB
  • assets/leadgen-starter/server/normalize.js 1 KB
  • assets/leadgen-starter/server/salesforce.js 5 KB
  • assets/leadgen-starter/server/secrets.js 1 KB
  • assets/leadgen-starter/server/routes/crm.js 3 KB
  • assets/leadgen-starter/server/routes/search.js 4 KB
  • assets/leadgen-starter/src/App.tsx 11 KB
  • assets/leadgen-starter/src/index.css 2 KB
  • assets/leadgen-starter/src/main.tsx 1 KB
  • assets/leadgen-starter/src/components/ActiveFilterChips.tsx 2 KB
  • assets/leadgen-starter/src/components/AutocompleteMulti.tsx 3 KB
  • assets/leadgen-starter/src/components/CrmMappingModal.tsx 5 KB
  • assets/leadgen-starter/src/components/CrmPushBar.tsx 4 KB
  • assets/leadgen-starter/src/components/DetailPanel.tsx 3 KB
  • assets/leadgen-starter/src/components/EventsPicker.tsx 2 KB
  • assets/leadgen-starter/src/components/FilterSidebar.tsx 8 KB
  • assets/leadgen-starter/src/components/ImportModal.tsx 3 KB
  • assets/leadgen-starter/src/components/LeftRail.tsx 2 KB
  • assets/leadgen-starter/src/components/PushResultModal.tsx 3 KB
  • assets/leadgen-starter/src/components/ResultsTable.tsx 10 KB
  • assets/leadgen-starter/src/components/TextMulti.tsx 1 KB
  • assets/leadgen-starter/src/components/TopBar.tsx 2 KB
  • assets/leadgen-starter/src/components/icons.tsx 2 KB
  • assets/leadgen-starter/src/config/filters.ts 7 KB
  • assets/leadgen-starter/src/lib/api.ts 3 KB
  • assets/leadgen-starter/src/lib/csv.ts 4 KB

Versions

The database has no other skills named lead-gen-tool-builder.

Database snapshot: 13.11.2026 · package version 9d6e960a1ef1 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100browser-extension-builder
    Browser extension builder skill for Claude Code and Codex: scaffolds a local, unpacked Chrome extension that reveals verified B2B contact info (email, phone, job title, company) directly on a LinkedIn profile, then pushes the contact to HubSpot or drafts a personalized email —…
  • 100zoominfo-webhooks
    Receive and verify ZoomInfo webhooks. Use when setting up ZoomInfo webhook handlers, checking the x-zoominfo-token verification token, completing the Validate step, or handling contact and company update events from the ZoomInfo Monitoring API.
  • 100lead-research-assistant
    B2B lead generation and research assistant. Use when asked to find leads, build a prospect list, research companies, find LinkedIn contacts, do lead generation, create an ICP, B2B prospecting, company research, LinkedIn scraping, find decision-makers, build a sales list, lead…
  • 100apollo-core-workflow-a
    Implement Apollo.io lead search and enrichment workflow. Use when building lead generation features, searching for contacts, or enriching prospect data from Apollo. Trigger with phrases like "apollo lead search", "search apollo contacts", "find leads in apollo", "apollo people…
  • 100lead-gen
    Use when building and qualifying a prospect list before anyone reaches out — a falsifiable ICP, named accounts/contacts from Apollo/ZoomInfo/Clay, deduped against the CRM, tiered by fit+intent+engagement. NOT writing or sending the outreach (that is cold-outreach), NOT tracking…
  • 100crm-integration
    CRM integration patterns for Close CRM, HubSpot, and Salesforce. Use when: Close CRM, HubSpot, Salesforce, CRM API, lead sync, deal sync, activity logging, CRM webhook, pipeline automation, contact enrichment.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.