Enrich contact skill

Contact enrichment skill for Claude Code and Codex: look up a B2B prospect's full professional profile including work email, phone number, LinkedIn profile, title, seniority, department, and company firmographics.

by explorium-ai·MIT license·★ 197 Stars on the repo·GitHub ↗

Use now

Inside this skill

SKILL.md · the author's own words
# Enrich Contact

Resolve one person and return their full enriched profile in a single pass.

## Input

The user will supply one of:
- An email address (e.g. `[email protected]`)
- A full name plus a company name or domain (e.g. `Jane Smith at Acme Corp`)
- A LinkedIn profile URL
- A known Explorium `prospect_id`

Optional: a request for company context (firmographics on the matched employer).

## Workflow

Word-for-word excerpt, not a result. Read the full SKILL.md ↓

Files of Enrich contact

explorium-ai/main1 file shown
SKILL.md
Show the full text71 lines
enrich-contact-2/SKILL.md71 lines · 4.0 KB

Enrich Contact

Resolve one person and return their full enriched profile in a single pass.

Input

The user will supply one of:

  • An email address (e.g. [email protected])
  • A full name plus a company name or domain (e.g. Jane Smith at Acme Corp)
  • A LinkedIn profile URL
  • A known Explorium prospect_id

Optional: a request for company context (firmographics on the matched employer).

Workflow

  1. Classify the identifier. Pick exactly one resolution path: do not fan out match strategies in parallel. Use the strongest signal first and fall back only if it returns no match.

    • Email present and well-formed: path A.
    • LinkedIn URL: path B.
    • Bare prospect_id: path D, skip resolution.
    • Full name plus a company token: path C.
    • Phone-only: stop and tell the user phone-only is not a supported match key.
  2. Resolve the prospect.

    • Path A: match the prospect by email.
    • Path B: match the prospect by LinkedIn URL.
    • Path C: if the user gave a company name, first resolve the business to get its canonical domain and business_id, then match the prospect by full name plus that company domain or id.
    • Path D: use the supplied id directly.
  3. Handle ambiguity. If matching returns zero rows:

    • For path A, retry by splitting the email local-part into a name guess plus the company domain.
    • For path C, retry with first/last name and the resolved business_id from a company match.
    • If multiple plausible rows return, surface a candidates table and ask the user to pick. Never silently take the first row.
  4. Enrich the prospect. Pull contacts and profile on the resolved person. Default to email-only contacts (cheaper); upgrade to email plus phone only when the user explicitly needs phone numbers (e.g. SDR dialer flows).

    • Recent LinkedIn post content for an individual is not available. If the user asks for post content, surface this gap and offer the employer's LinkedIn posts via business enrichment instead.
  5. Optional company context. If the user asked for company context (or path C resolved a business_id), enrich firmographics on the employer and surface headcount, revenue range, country, and industry.

  6. Assemble the output. Render the card below. Omit empty fields. Always surface the prospect_id.

Output Format

[Full Name] at [Company]

Field Value
Job Title
Job Level display canonical (e.g. c-suite, vice president)
Job Department fallback "Unattributed" when null
Professional Email / Personal Email / Phone
LinkedIn URL
Company / Domain / Industry
Company Size / Revenue / Country buckets
prospect_id / business_id

If multiple candidates surfaced during resolution and the user has not yet picked, render a ### Candidates table instead, with one row per candidate (name, title, company, domain, prospect_id) and ask which to enrich.

Limitations

  • High-profile public execs (CEOs, founders, well-known executives) often have suppressed contact data. Professional email may be null or only a personal address. Recommend LinkedIn outreach instead of cold email for this tier.
  • Phone-only lookup is not a supported match key.
  • No per-prospect accuracy or confidence score. Treat the presence of a professional email plus phone as the practical quality signal.
  • No last_updated timestamp per contact field. Level and department are coarse buckets; department is null for many cross-functional senior roles (Chief X Officer, President, Founder), group under "Unattributed".
  • Company size and revenue are bucketed, not exact numbers.
1---
2name: enrich-contact
3description: "Contact enrichment skill for Claude Code and Codex: look up a B2B prospect's full professional profile including work email, phone number, LinkedIn profile, title, seniority, department, and company firmographics. Provide an email, name + company, LinkedIn URL, or prospect_id. Use for contact data enrichment, email lookup, LinkedIn profile lookup, and outbound contact data workflows in Claude Code, Codex, Hermes-Agent, and other AI agents."
4---
5 
6# Enrich Contact
7 
8Resolve one person and return their full enriched profile in a single pass.
9 
10## Input
11 
12The user will supply one of:
13- An email address (e.g. `[email protected]`)
14- A full name plus a company name or domain (e.g. `Jane Smith at Acme Corp`)
15- A LinkedIn profile URL
16- A known Explorium `prospect_id`
17 
18Optional: a request for company context (firmographics on the matched employer).
19 
20## Workflow
21 
221. **Classify the identifier.** Pick exactly one resolution path: do not fan out match strategies in parallel. Use the strongest signal first and fall back only if it returns no match.
23 - Email present and well-formed: path A.
24 - LinkedIn URL: path B.
25 - Bare `prospect_id`: path D, skip resolution.
26 - Full name plus a company token: path C.
27 - Phone-only: stop and tell the user phone-only is not a supported match key.
28 
292. **Resolve the prospect.**
30 - Path A: match the prospect by email.
31 - Path B: match the prospect by LinkedIn URL.
32 - Path C: if the user gave a company name, first resolve the business to get its canonical domain and `business_id`, then match the prospect by full name plus that company domain or id.
33 - Path D: use the supplied id directly.
34 
353. **Handle ambiguity.** If matching returns zero rows:
36 - For path A, retry by splitting the email local-part into a name guess plus the company domain.
37 - For path C, retry with first/last name and the resolved `business_id` from a company match.
38 - If multiple plausible rows return, surface a candidates table and ask the user to pick. Never silently take the first row.
39 
404. **Enrich the prospect.** Pull contacts and profile on the resolved person. Default to email-only contacts (cheaper); upgrade to email plus phone only when the user explicitly needs phone numbers (e.g. SDR dialer flows).
41 - Recent LinkedIn post content for an individual is not available. If the user asks for post content, surface this gap and offer the employer's LinkedIn posts via business enrichment instead.
42 
435. **Optional company context.** If the user asked for company context (or path C resolved a `business_id`), enrich firmographics on the employer and surface headcount, revenue range, country, and industry.
44 
456. **Assemble the output.** Render the card below. Omit empty fields. Always surface the `prospect_id`.
46 
47## Output Format
48 
49**[Full Name]** at [Company]
50 
51| Field | Value |
52|-------|-------|
53| Job Title | |
54| Job Level | display canonical (e.g. `c-suite`, `vice president`) |
55| Job Department | fallback "Unattributed" when null |
56| Professional Email / Personal Email / Phone | |
57| LinkedIn URL | |
58| Company / Domain / Industry | |
59| Company Size / Revenue / Country | buckets |
60| prospect_id / business_id | |
61 
62If multiple candidates surfaced during resolution and the user has not yet picked, render a `### Candidates` table instead, with one row per candidate (name, title, company, domain, prospect_id) and ask which to enrich.
63 
64## Limitations
65 
66- High-profile public execs (CEOs, founders, well-known executives) often have suppressed contact data. Professional email may be null or only a personal address. Recommend LinkedIn outreach instead of cold email for this tier.
67- Phone-only lookup is not a supported match key.
68- No per-prospect accuracy or confidence score. Treat the presence of a professional email plus phone as the practical quality signal.
69- No `last_updated` timestamp per contact field. Level and department are coarse buckets; department is null for many cross-functional senior roles (Chief X Officer, President, Founder), group under "Unattributed".
70- Company size and revenue are bucketed, not exact numbers.
71 

Discussion

Alternatives