GTM Skills by Explorium plugin

---
name: list-builder
description: "Prospecting skill for Claude Code and Codex: build a targeted list of B2B prospects or businesses from a natural-language ICP brief using real-time company and contact data. Use when the user asks to 'build a list', 'find prospects', 'pull a target account list', 'give me contacts at', 'show me companies that', or describes titles, departments, industries, company size, location, tech stack, intent topics, or growth events. The go-to lead generation skill for Claude Code, Codex, Hermes-Agent, and other AI agents."
---

# List Builder

Turn a natural-language audience brief into a clean, exportable prospect or business list.

## Input

`$ARGUMENTS` is a free-text description of the audience. Parse it for:

- Entity type (prospects vs businesses; default prospects if ambiguous).
- Role signals: job titles, seniority, department.
- Firmographics: industry, size bucket, revenue bucket, company age, public vs private.
- Geography: country, US/Canadian state, or city region.
- Technographics, intent topics, growth events with a recency window in days.
- Contactability: reachable / emailable.
- Count (default 25), fields requested (e.g. "include phone") that drive which enrichments layer on top.

Example phrasings: "100 VP Engineering at Series B SaaS in the US that use Snowflake", "heads of demand gen at 200-1000 fintech in NYC", "50 CFOs at public manufacturing that raised funding in the last 90 days", "cybersecurity under 500 employees in the UK with intent on zero trust".

## Workflow

1. **Decide list type.** Prospects if the brief names person attributes (title, seniority, department). Businesses if only company attributes are named. If prospects are scoped by a prior company set, plan to thread that businesses table into the prospect fetch.

2. **Discover canonical values.** For every free-text field (industry, technology, job title, intent topic, city region), resolve the user's phrase to the standardized value the API expects. Skip discovery for ISO country codes, region codes, bucket enums (size, revenue, age), seniority and department enums, and boolean flags.

3. **Tighten loose title filters.** Title filters are not enforced as exact-match: a job-title-only filter for "Vice President of Engineering" can return non-VP rows. Always combine a title with a seniority value (e.g. "vice president") to keep the slice tight.

4. **Size the audience.** Get a total match count for the assembled filters before pulling rows. Use this number to frame the preview honestly and to warn the user early if the audience is unexpectedly small or massive.

5. **Sample-first preview.** Pull a small slice (5 rows) and render it for the user to sanity-check the filter translation before materializing the full list. The interactive preview is hard-capped at 5 rows: treat it as a sanity sample, not as the ranked top-N.

6. **Pull the full list.** Once the preview is approved, materialize the requested count via the paid export path. Restate the audience definition so the user can see what locked in.

7. **Enrich the rows.** For prospects, default to email-only contact enrichment (cheaper); add phone only when the user explicitly asks for it (e.g. dialer flows). Add profile data for LinkedIn URL and bio when requested. Prospect-side LinkedIn post content is NOT available: for recent activity, enrich LinkedIn posts on the employer instead. For businesses, layer in firmographics, technographics, funding, workforce trends, competitive landscape, ratings, or strategic insights based on the fields the user asked for.

8. **Output as a table artifact** with the CSV path called out so the user can download or pipe it onward.

## Output Format

### Search Criteria Applied
Bulleted readout of every filter that landed: entity type, title and seniority, department, industry, size and revenue buckets, geography, tech stack, intent topics, growth events with their recency window, and any boolean flags. Call out any requested filter that had no direct equivalent and how it was approximated.

### Prospect List
Show when entity type is prospects. Columns: name, job title, company, company domain, industry, company size, email (professional preferred), phone if pulled, LinkedIn URL, prospect_id. Drop columns the user did not ask for. Caveat: email and phone only populate after contact enrichment; the discovery preview returns identifiers only.

### Business List