Skip to content
Skills Library
Sales & customer service · Tool integration

lead-lists

/lead-lists

Creates and organizes Hunter leads lists — build a list from contacts or a search, populate it, merge lists, favorite them, and group them into folders. Use when the user wants to build a lead list, save search results to Hunter, organize contacts into lists, or tidy up their lists and folders.

Licence
MIT
Last repository change
24.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
1
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

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

Licence

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

What it does and when to use it

Creates and organizes Hunter leads lists — build a list from contacts or a search, populate it, merge lists, favorite them, and group them into folders. Use when the user wants to build a lead list, save search results to Hunter, organize contacts into lists, or tidy up their lists and folders.

Arguments

/lead-lists Create a list of marketing leads from SaaS companies
Original author description

Creates and organizes Hunter leads lists — build a list from contacts or a search, populate it, merge lists, favorite them, and group them into folders. Use when the user wants to build a lead list, save search results to Hunter, organize contacts into lists, or tidy up their lists and folders.

How it works

  1. Examples
  2. Workflow
  3. Guardrails
  4. Credit Cost
  5. Important Notes
Original SKILL.md headings · 72 lines, 638 words
SKILL.md preview
---
name: lead-lists
description: Creates and organizes Hunter leads lists — build a list from contacts or a search, populate it, merge lists, favorite them, and group them into folders. Use when the user wants to build a lead list, save search results to Hunter, organize contacts into lists, or tidy up their lists and folders.
user-invocable: true
argument-hint: Create a list of marketing leads from SaaS companies
---

# Lead Lists

Create leads lists, populate them with contacts, and organize them into folders.

## Examples

- `/hunter:lead-lists Create a list of marketing leads from SaaS companies`
- `"Save these contacts to a new list called Q2 Outreach"`
- `"Build a list from the domain search results"`
- `"Merge my two fintech lists"`
- `"Favorite my Q2 Outreach list"`

## Workflow

### Step 1: Determine the source

- **From a previous search** — use contacts already found via Domain Search. (Discover returns companies/counts, not contacts with emails, so route Discover results through Domain Search first to get saveable contacts.)
- **From specific emails/contacts** — the user provides addresses directly.
- **From a new search** — run the discover / domain-search skills first, then save results.

### Step 2: Create or pick the list

To reuse an existing list, `List-Leads-Lists` to browse and `Get-Leads-List` to read one. For a new list, call `Create-Leads-List` with a descriptive name. If the user gives none, suggest one from context (e.g., "Fintech CTOs - France - 2026-07-16").

Present the deep-link: "List created: https://hunter.io/leads?leads_list_id={id}"

### Step 3: Add leads

For each contact, call `Create-Lead-If-Missing` with the contact's data and the new `leads_list_id` — it adds new leads but never overwrites an existing lead's fields, so sparse search data can't clobber contacts the user already maintains. Note: for an email that is **already** a lead, `Create-Lead-If-Missing` returns the existing record unchanged and does **not** add it to the new list — report those as already-existing / not added rather than counting them as added. (`Create-Or-Update-Lead` *would* add them to the list but overwrites their fields; use it only when the user explicitly wants that.) `Lead-Exists` checks first if unsure. Include all available fields (`email`, `first_name`, `last_name`, `position`, `company`, `linkedin_url`). Report progress ("Adding lead 5 of 20…").

### Step 4: Organize

- **Merge** two lists → `Merge-Leads-Lists` (destructive — it moves all leads to the destination and permanently deletes the source list; confirm first, see Guardrails). Both lists must be **static** and the source non-empty — dynamic/saved lists are rejected.
- **Favorite / unfavorite** → `Favorite-Leads-List` / `Unfavorite-Leads-List`.
- **Folders** → `List-Leads-List-Folders`, `Create-Leads-List-Folder`, `Update-Leads-List-Folder` (create and rename folders). Note: the API has no way to move an existing list into a folder — that's a Hunter-dashboard action.
- **Rename** a list → `Update-Leads-List` (accepts the list `id` and a new `name` only).

### Step 5: Present summary

```
# List Created: [List Name]

**Leads added:** [count] | **Duplicates skipped:** [count]

View in Hunter: https://hunter.io/leads?leads_list_id={id}

## Next Steps
1. Add more leads to this list
2. Add these leads to a sequence (build-sequences skill)
3. Push the list to your CRM (push-to-crm skill)
4. Search for more contacts (discover / domain-search skills)
```

## Guardrails

Confirm before destructive actions — state what will be affected, then wait for a "yes":

- `Delete-Leads-List` — "This deletes the '[name]' list (the leads themselves stay in your account); if it's a static list that a dynamic/saved list depends on, those dependent lists are deleted too. Confirm?"
- `Merge-Leads-Lists` — moving leads permanently deletes the source list and can't be undone: "This merges '[source]' into '[dest]' and deletes '[source]'. Confirm?"
- `Delete-Leads-List-Folder` — clarify whether lists inside move out or are affected, and confirm.

## Credit Cost

Free — `Create-Leads-List`, `Create-Lead-If-Missing`, merges, and folder operations do not consume credits. Only the initial search (Domain Search, Email Finder) uses credits if leads come from a new search.

## Important Notes

- Use `Create-Lead-If-Missing` when saving search results so you never overwrite an existing lead; reserve `Create-Or-Update-Lead` for when the user intends to update existing leads.
- Lists can be merged later with `Merge-Leads-Lists` — but the merge deletes the source list, so confirm first.
- `List-Leads` returns up to 100 leads per page — use `offset` to paginate through larger lists.

Versions

The database has no other skills named lead-lists.

Database snapshot: 13.11.2026 · package version 911439f0f848 (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

  • 100company-lists
    Saves companies and organizes them into Hunter company lists — save a company, add/remove companies to lists, create and manage lists and folders, and bulk copy/move/delete companies. Use when the user wants to save companies from a search, build a target-account list, or…
  • 100manage-leads
    Manages individual leads in Hunter — create, look up, update, or delete leads, tag them, and set custom attributes. Use when the user wants to add or edit a lead, tag contacts, organize leads with custom fields, or clean up their lead database.
  • 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-generation
    Generate enriched ICP-based lead lists with Exa Agent, including structured scoring and CSV output. Use when generating leads, building prospect lists, finding companies to sell to, outbound research, or ICP-based company discovery. Triggers on leads, lead gen, prospect list,…
  • 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…

Feedback and reports

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