contact-hunter ยท diff

git:20251022.14b7f5b to git:20260608.d82d20f

18 added, 277 removed. Audit A to A.

---
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 contact information from multiple sources with detailed attribution.
-
- ## Instructions
-
- When a user needs to find contact information:
-
- 1. **Identify Search Type**:
- - **Person search**: Find specific individual
- - **Company search**: Find people at a company
- - **Role search**: Find people with specific job title
- - **Email verification**: Validate and enrich existing email
- - **Bulk enrichment**: Enrich list of contacts
-
- 2. **Gather Search Parameters**:
- - Person name (first, last)
- - Company name
- - Job title / role
- - Location (city, state, country)
- - Industry
- - LinkedIn URL (if available)
- - Email domain
- - Any other identifying information
-
- 3. **Search Strategy**:
-
- **Sources to Check** (suggest to user):
- - LinkedIn (manual search with user's account)
- - Company website (About, Team, Contact pages)
- - GitHub (for developers)
- - Twitter/X profiles
- - Professional directories
- - Public databases
- - ZoomInfo (if user has access)
- - Apollo.io (if user has access)
- - Hunter.io (if user has access)
- - RocketReach (if user has access)
-
- **โš ๏ธ Important**: This skill GUIDES the search process. It doesn't directly access paid APIs. Instead, it:
- - Provides structured search queries
- - Suggests where to look
- - Helps organize found information
- - Validates and formats results
-
- 4. **Search Instructions Format**:
- ```
- ๐Ÿ” CONTACT SEARCH: [Name/Company]
-
- โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
- ๐Ÿ“‹ SEARCH PARAMETERS
- โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
-
- Target: John Smith
- Company: Acme Corp
- Title: VP of Engineering
- Location: San Francisco, CA
-
- โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
- ๐ŸŽฏ RECOMMENDED SEARCH QUERIES
- โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
-
- LinkedIn:
- 1. Search: "John Smith VP Engineering Acme Corp"
- 2. Use company filter: "Acme Corp"
- 3. Use title filter: "VP of Engineering"
- 4. 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. Check: https://acme.com/about
- 2. Check: https://acme.com/team
- 3. Check: https://acme.com/leadership
- 4. Check: https://acme.com/contact
-
- Email Pattern Guessing:
- Common patterns at acme.com:
- โ€ข john.smith@acme.com
- โ€ข john@acme.com
- โ€ข jsmith@acme.com
- โ€ข j.smith@acme.com
- โ€ข smithj@acme.com
-
- GitHub (for technical roles):
- โ€ข Search: "John Smith Acme"
- โ€ข Look for company in bio
-
- โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
- ๐Ÿ“ DATA COLLECTION TEMPLATE
- โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
-
- Once you find the information, fill this 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]
-
- โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
- โœ… VERIFICATION STEPS
- โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
-
- 1. Cross-reference multiple sources
- 2. Check LinkedIn profile matches company
- 3. Verify email format matches company pattern
- 4. Validate phone number format
- 5. Confirm job title is current
- 6. Check for recent company changes
-
- โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
- โš ๏ธ COMPLIANCE & ETHICS
- โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
-
- โ€ข Only use publicly available information
- โ€ข Respect privacy and GDPR regulations
- โ€ข Don't scrape private databases
- โ€ข Honor do-not-contact preferences
- โ€ข Use for legitimate business purposes only
- โ€ข Keep CAN-SPAM compliance for cold outreach
- ```
-
- 5. **Organize Results**:
-
- **Individual Contact Card**:
- ```
- โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
- โ”‚ JOHN SMITH โ”‚
- โ”‚ VP of Engineering @ Acme Corp โ”‚
- โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
- โ”‚ ๐Ÿ“ง john.smith@acme.com โ”‚
- โ”‚ ๐Ÿ“ฑ (415) 555-0123 โ”‚
- โ”‚ ๐Ÿ’ผ linkedin.com/in/johnsmith โ”‚
- โ”‚ ๐Ÿ“ 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/Excel format):
- ```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
- ```
-
- 6. **Email Pattern Detection**:
-
- When searching company contacts, detect email patterns:
- ```
- ๐Ÿ” 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
+ Find and enrich publicly available contact information from multiple sources with full source attribution.
- Confidence: 95%
+ 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.
- Alternative Patterns (if primary fails):
- โ€ข firstname@acme.com
- โ€ข firstnamelastname@acme.com
- โ€ข f.lastname@acme.com
+ ## 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
- To Verify Unknown Email:
- 1. Use email verification tool
- 2. Check for bounce/invalid
- 3. Look for SMTP response
- 4. Verify on LinkedIn
- ```
+ ## Workflow
- 7. **Data Enrichment**:
+ 1. Identify the search type: person, company, role, email verification, or bulk enrichment.
- For existing contacts, enrich with:
- - Current job title
- - Company changes
- - Updated contact info
- - Social profiles
- - Company information
- - Reporting structure
- - Recent activity/posts
+ 2. Gather search parameters: name, company, job title, location, industry, LinkedIn URL, email domain, and any other identifiers.
- 8. **Export Formats**:
+ 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).
- - **CSV**: For CRM import
- - **JSON**: For API integration
- - **vCard**: For contact managers
- - **Salesforce CSV**: Pre-formatted for SFDC
- - **HubSpot CSV**: Pre-formatted for HubSpot
+ 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.
- ## Search Strategies
+ 5. Detect the company email pattern from confirmed addresses, then derive candidate emails. See the email-pattern report in `references/output-templates.md`.
- **For Company Employees**:
- ```
- site:linkedin.com/in "[Company Name]"
- OR
- site:[company-domain.com] "team" OR "about" OR "leadership"
- ```
+ 6. Collect and verify results. Cross-reference multiple sources and run the verification steps in `references/compliance.md` before recording any field.
- **For Specific Roles**:
- ```
- "[Job Title]" "[Company]" email
- OR
- "[Job Title]" site:linkedin.com "[Company]"
- ```
+ 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.
- **For Email Validation**:
- - Check company website for email format
- - Use email verification services
- - Look for pattern in existing emails
- - Test with email finder tools
+ 8. For enrichment of existing contacts, refresh: current job title, company changes, updated contact info, social profiles, company information, reporting structure, and recent activity.
- **For Phone Numbers**:
- - Company website contact page
- - LinkedIn profile (sometimes public)
- - Professional directories
- - Industry associations
+ ## Quality bar
- ## Example Triggers
+ 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"
-
- ## Compliance Guidelines
-
- **What's Allowed**:
- - Publicly available information
- - Business contact information
- - LinkedIn public profiles
- - Company websites
- - Professional directories
- - Published contact lists
-
- **What's NOT Allowed**:
- - Scraping private databases
- - Purchasing questionable contact lists
- - Bypassing email verification
- - Ignoring opt-out requests
- - Violating GDPR/CCPA
- - Harassing contacts
-
- **Best Practices**:
- - Always cite data sources
- - Respect privacy preferences
- - Use for legitimate business purposes
- - Keep data up to date
- - Provide opt-out mechanisms
- - Follow CAN-SPAM for outreach
- - Comply with data protection laws
-
- ## Output Quality
-
- Ensure contact information:
- - Includes all available fields
- - Cites data sources
- - Has confidence/verification level
- - Follows data privacy laws
- - Is formatted consistently
- - Includes contact preferences
- - Notes data freshness
- - Provides context (tenure, role, team)
- - Flags any uncertainties
- - Suggests verification steps
-
- Provide structured, ethically-sourced contact information with full transparency.