> ## Documentation Index
> Fetch the complete documentation index at: https://www.opendirectory.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# cold-email-verifier

> Agent Skill that equips your AI agent with the ability to autonomously guess, enrich, and verify cold email addresses directly from a CSV file.

<Info>
  **Category:** Outreach · **Version:** `0.0.1` · **Author:** `opendirectory` · **Compatibility:** All targets (claude, codex, opencode, gemini, anti-gravity, openclaw, hermes)
</Info>

Agent Skill that equips your AI agent with the ability to autonomously guess, enrich, and verify cold email addresses directly from a CSV file.

Instead of running Python scripts manually, this skill teaches your AI how to read your lead lists, discover corporate domains via the Clearbit API, generate standard email permutations, and securely verify them.

<img width="2752" height="1536" alt="cold-email-verifier-cover-image" src="https://github.com/user-attachments/assets/f033ec61-d2c1-4cee-a6d5-71e7cf9632a6" />

## Install

<Tabs>
  <Tab title="npx CLI (Recommended)">
    ```bash theme={null}
    npx "@opendirectory.dev/skills" install cold-email-verifier --target claude
    ```
  </Tab>

  <Tab title="skills.sh">
    ```bash theme={null}
    npx skills add Varnan-Tech/opendirectory --skill cold-email-verifier
    ```
  </Tab>

  <Tab title="Claude Code Native">
    ```bash theme={null}
    /plugin marketplace add Varnan-Tech/opendirectory
    /plugin install opendirectory-gtm-skills@opendirectory-marketplace
    ```
  </Tab>

  <Tab title="Claude Desktop">
    <video controls className="w-full aspect-video rounded-xl mb-4" src="https://github.com/user-attachments/assets/cea8b565-2002-4a87-8857-d902bfcfdc1c" />

    1. Copy `https://github.com/Varnan-Tech/opendirectory/tree/main/skills/cold-email-verifier` into [download-directory.github.io](https://download-directory.github.io/) to download the ZIP.
    2. Open **Claude Desktop** -> **Customize** -> **Skills** -> **+** -> **Upload a skill** and drop the folder containing `SKILL.md`.
  </Tab>

  <Tab title="Manus AI">
    <video controls className="w-full aspect-video rounded-xl mb-4" src="https://github.com/user-attachments/assets/17cbee2a-9e17-4bd4-ac46-68e0e92ffab4" />

    [**Install cold-email-verifier in Manus AI**](https://manus.im/import-skills?githubUrl=https%3A%2F%2Fgithub.com%2FVarnan-Tech%2Fopendirectory%2Ftree%2Fmain%2Fskills%2Fcold-email-verifier\&utm_source=opendirectory)
  </Tab>
</Tabs>

## Verification Engines Supported

The AI is trained to use two different verification backends:

1. **ValidEmail.co API (Highly Recommended)**: The AI will use this SaaS API for enterprise-grade accuracy, bypassing strict catch-all servers. You can get a free tier of verification credits at validemail.co.
2. **Reacher (Self-Hosted)**: The AI can route checks through your own self-hosted Reacher Docker container (e.g., on an AWS EC2 instance with an unblocked Port 25) for 100% free verification.

## Setup

To install this skill into your AI agent's workspace:

1. Clone or download this folder.
2. Copy the entire cold-email-verifier folder into your agent's skills directory (e.g., \~/.agents/skills/ or your project's .agents/skills/ folder).
3. Ensure the dependencies in
   equirements.txt are installed in your environment:
   `ash
   pip install -r requirements.txt
   `
4. Copy the .env.example to .env and add your ValidEmail.co API key:
   `ash
   cp .env.example .env
   `

## How to Prompt the AI

Once the skill is installed, you can simply talk to your AI agent. Here are example prompts:

**Using ValidEmail.co:**

> "Use the cold email verifier skill to process leads.csv. Please use the validemail mode."

**Using a Self-Hosted Reacher Server:**

> "Verify the emails in leads.csv using the cold email verifier. Use reacher-http mode and point it to http\://YOUR\_SERVER\_IP:8080/v0/check\_email."

The AI will automatically parse the CSV, handle the domain lookups, generate the permutations, run the verification engine, and output a clean CSV with the valid emails appended.

## CSV Format Requirements

The AI expects the input CSV to contain at least the following headers:

* First Name
* Last Name
* Company Name
* Domain Name


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.