references/output-templates.md
# Output Templates
Fill these once contact data is found. Cite every source and note verification date.
## Data collection template
```
Full Name: [First Last]
Job Title: [Exact title]
Company: [Company name]
Email: [email@domain.com]
Phone: [(xxx) xxx-xxxx]
LinkedIn: [linkedin.com/in/username]
Location: [City, State/Country]
Department: [Engineering, Sales, etc.]
Additional Info:
- Reports to: [Manager name]
- Team size: [Number]
- Start date: [When they joined]
- Previous companies: [List]
- Education: [Degree, School]
Data Sources:
- [LinkedIn profile URL]
- [Company website URL]
- [Other sources]
```
## Individual contact card
```
+-------------------------------------------+
| JOHN SMITH |
| VP of Engineering @ Acme Corp |
+-------------------------------------------+
| Email: john.smith@acme.com |
| Phone: (415) 555-0123 |
| LinkedIn: linkedin.com/in/johnsmith |
| Location: San Francisco, CA |
+-------------------------------------------+
| Department: Engineering |
| Reports to: Sarah Chen (CTO) |
| Team size: ~45 engineers |
| Tenure: 2+ years at Acme |
+-------------------------------------------+
| Sources: |
| - LinkedIn (verified) |
| - Company website |
| - Verified: 2024-01-15 |
+-------------------------------------------+
```
## Bulk results (CSV)
```csv
Name,Title,Company,Email,Phone,LinkedIn,Location,Source,Verified
John Smith,VP Engineering,Acme Corp,john.smith@acme.com,(415) 555-0123,linkedin.com/in/johnsmith,San Francisco,LinkedIn,2024-01-15
Jane Doe,Director Marketing,Acme Corp,jane.doe@acme.com,(415) 555-0124,linkedin.com/in/janedoe,San Francisco,Company Website,2024-01-15
```
## Email pattern report
```
DETECTED EMAIL PATTERN: Acme Corp
Confirmed emails found:
- john.smith@acme.com
- sarah.chen@acme.com
- michael.jones@acme.com
Detected pattern: firstname.lastname@acme.com
Confidence: 95%
Alternative patterns (if primary fails):
- firstname@acme.com
- firstnamelastname@acme.com
- f.lastname@acme.com
To verify an unknown email:
1. Use an email verification tool
2. Check for bounce/invalid response
3. Inspect SMTP response
4. Cross-check on LinkedIn
```
## Export formats
- CSV: for generic CRM import
- JSON: for API integration
- vCard: for contact managers
- Salesforce CSV: pre-formatted for SFDC
- HubSpot CSV: pre-formatted for HubSpot
references/search-queries.md
# Search Query Templates
Use these query patterns once search parameters (name, company, title, location, domain) are gathered. Replace bracketed values.
## Per-target search brief
Format the search plan as follows for a single target (example: John Smith, VP of Engineering, Acme Corp, San Francisco):
### Search parameters
- Target: John Smith
- Company: Acme Corp
- Title: VP of Engineering
- Location: San Francisco, CA
### Recommended queries
LinkedIn:
1. Search: "John Smith VP Engineering Acme Corp"
2. Apply company filter: "Acme Corp"
3. Apply title filter: "VP of Engineering"
4. Apply location: "San Francisco Bay Area"
Google:
1. "John Smith" "VP of Engineering" "Acme Corp"
2. "John Smith" "Acme Corp" email
3. site:linkedin.com/in "John Smith" "Acme"
4. site:acme.com "John Smith"
Company website:
1. https://acme.com/about
2. https://acme.com/team
3. https://acme.com/leadership
4. https://acme.com/contact
Email pattern candidates at acme.com:
- john.smith@acme.com
- john@acme.com
- jsmith@acme.com
- j.smith@acme.com
- smithj@acme.com
GitHub (technical roles):
- Search: "John Smith Acme"
- Inspect bio for company affiliation
## Reusable query patterns
For company employees:
```
site:linkedin.com/in "[Company Name]"
OR
site:[company-domain.com] "team" OR "about" OR "leadership"
```
For specific roles:
```
"[Job Title]" "[Company]" email
OR
"[Job Title]" site:linkedin.com "[Company]"
```
For email validation:
- Check company website for email format
- Use an email verification service
- Look for the pattern in existing confirmed emails
- Test with email finder tools
For phone numbers:
- Company website contact page
- LinkedIn profile (when public)
- Professional directories
- Industry associations
SKILL.md
---
name: contact-hunter
description: Search and extract contact information for people or companies including names, phone numbers, emails, job titles, and LinkedIn profiles. Aggregates data from multiple sources and provides enriched contact details. Use when users need to find contact information, build prospect lists, or enrich existing contact data.
---
# Contact Hunter
Find and enrich publicly available contact information from multiple sources with full source attribution.
This skill guides the search process and organizes results. It does not directly access paid APIs; it produces structured queries, suggests where to look, then validates and formats what is found.
## Contents
- `references/search-queries.md` — per-target search briefs and reusable query patterns
- `references/output-templates.md` — data collection template, contact card, bulk CSV, email-pattern report, export formats
- `references/compliance.md` — allowed/not-allowed rules, best practices, verification steps
## Workflow
1. Identify the search type: person, company, role, email verification, or bulk enrichment.
2. Gather search parameters: name, company, job title, location, industry, LinkedIn URL, email domain, and any other identifiers.
3. Select sources to check: LinkedIn, company website (About/Team/Contact/Leadership), GitHub (developers), Twitter/X, professional directories, public databases, and any paid tools the user has access to (ZoomInfo, Apollo.io, Hunter.io, RocketReach).
4. Build the search plan using the query patterns in `references/search-queries.md`. Produce a per-target brief with LinkedIn, Google, company-website, email-pattern, and GitHub queries.
5. Detect the company email pattern from confirmed addresses, then derive candidate emails. See the email-pattern report in `references/output-templates.md`.
6. Collect and verify results. Cross-reference multiple sources and run the verification steps in `references/compliance.md` before recording any field.
7. Format output using the templates in `references/output-templates.md`: data collection template, individual contact card, or bulk CSV. Export as CSV, JSON, vCard, or CRM-specific CSV (Salesforce, HubSpot) as requested.
8. For enrichment of existing contacts, refresh: current job title, company changes, updated contact info, social profiles, company information, reporting structure, and recent activity.
## Quality bar
Ensure every contact record includes all available fields, cites its sources, carries a confidence/verification level and freshness date, follows data-privacy law, is formatted consistently, notes contact preferences, provides role context (tenure, team), flags uncertainties, and suggests verification steps. Operate only within the rules in `references/compliance.md`.
## Example triggers
- "Find the VP of Sales at Acme Corp"
- "Get contact info for John Smith at Microsoft"
- "Find engineering managers at Stripe"
- "Enrich this list of contacts with emails"
- "What's the email pattern at Google?"
- "Find the marketing team at HubSpot"