Agent skill

Find Email By Name

by gooseworks-ai in gooseworks-ai/goose-skills

Find someone's email address given their name and company. An agent skill from gooseworks-ai/goose-skills.

MITAuto-check passedMarketing & SEO

Install Find Email By Name

skills CLI
$ npx skills add gooseworks-ai/goose-skills --skill find-email-by-name -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gooseworks-ai/goose-skills find-email-by-name --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gooseworks-ai/goose-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/lead-generation/capabilities/find-email-by-name .claude/skills/find-email-by-name && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
find-email-by-name
GitHub stars
1.2k
Used in
1 other repo
Token cost
~1.2k tokens
SKILL.md length
398 words
Files
2
Skills in repo
273
Repo updated
First seen
Licence
MIT

At a glance

Find someone's email address given their name and company. An agent skill from gooseworks-ai/goose-skills.

  • Marketing & SEO work in your project
  • SKILL.md covers Setup, When to Use, How It Works and Usage, plus 5 more sections
  • Calls curl, python3 and npx; reaches api.gooseworks.ai and linkedin.com; needs GOOSEWORKS_API_KEY

What it does

Find Email By Name is an agent skill from gooseworks-ai/goose-skills. Find someone's email address given their name and company

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill.meta.json`).

It sits in Marketing & SEO. The repository describes itself as: Library of Growth & GTM skills + data APIs for Claude Code, Codex, Cursor to run ads, social, content, lead gen, seo and data scraping. The licence is MIT.

When your agent uses it

  • Marketing & SEO work in your project

Example prompts

  • “/find-email-by-name”

Requirements

  • Python 3
  • Node.js
  • A credential in GOOSEWORKS_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit c650c6d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • python3
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.gooseworks.ai
    • linkedin.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GOOSEWORKS_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Find Email By Name loads about 1.2k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 398 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~19
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from gooseworks-ai/goose-skills at commit c650c6d, republished under its MIT licence (© gooseworks-ai). 398 words, ~1,243 tokens.

Download SKILL.mdSave it as .claude/skills/find-email-by-name/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
find-email-by-name
description
Find someone's email address given their name and company
source
orthogonal

Find Email by Name

Setup

Read your credentials from ~/.gooseworks/credentials.json:

bash
export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login

All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"

Find a person's email address when you know their name and company/domain. Essential for sales outreach, recruiting, and professional networking.

When to Use

  • User needs to contact someone at a company
  • User asks "what's [person]'s email at [company]?"
  • User wants to reach out to a specific person
  • Sales prospecting or lead generation
  • Recruiting outreach

How It Works

Uses Hunter or Tomba APIs to find the most likely email address for a person based on their name and company domain.

Usage

Find Email with Hunter
bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/email-finder","query":{"domain":"stripe.com","first_name":"Patrick","last_name":"Collison"}}'
Find Email with Tomba
bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/email-finder","query":{"domain":"intercom.com","company":"Intercom","first_name":"Eoghan","last_name":"McCabe"}}'
Find from LinkedIn Profile
bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/linkedin","query":{"url":"https://linkedin.com/in/johndoe"}}'

Parameters

Hunter
  • domain (required) - Company domain (e.g., stripe.com)
  • first_name (required) - Person's first name
  • last_name (required) - Person's last name
  • company (optional) - Company name (alternative to domain)
Tomba
  • domain (required) - Company domain
  • company (required) - Company name (3-75 chars)
  • first_name / last_name or full_name - Person's name
  • enrich_mobile (optional) - Set to true to include phone number

Response

Hunter Response

Returns data object:

  • email (string) - The found email address
  • score (integer) - Confidence 0-100 (higher = more likely correct)
  • domain (string) - Company domain searched
  • accept_all (boolean) - Whether server accepts any address
  • company (string) - Company name
  • position (string|null) - Job title if known
  • twitter (string|null) - Twitter handle if known
  • linkedin_url (string|null) - LinkedIn profile URL if known
  • phone_number (string|null) - Phone if known
  • sources (array) - Web pages where this email appeared
  • verification (object) - date and status (valid/invalid/unknown)
Show full SKILL.md (149 more words)Show less
Tomba Response

Returns data.email object with email address and confidence data. Also includes web sources where the email was found.

Examples

User: "Find the email for Sarah Chen at Notion"

bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"hunter","path":"/v2/email-finder","query":{"domain":"notion.so","first_name":"Sarah","last_name":"Chen"}}'

User: "I need to contact John Smith who works at Google"

bash
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"tomba","path":"/v1/email-finder","query":{"domain":"google.com","company":"Google","first_name":"John","last_name":"Smith"}}'

Error Handling

  • 400 - Missing required parameters (Hunter needs domain + first_name + last_name)
  • 422 - Tomba validation error — ensure both domain and company are provided
  • 429 - Rate limit exceeded — wait and retry
  • Score of 0 means no match found — try alternate name spellings or a different API
  • If Hunter returns accept_all: true, the email format may be correct but the specific mailbox can't be confirmed

Tips

  • Use the company's main domain (not subdomains)
  • Try both Hunter and Tomba if one doesn't find results
  • Check confidence scores - high confidence means the email is likely correct
  • Always verify important emails before sending cold outreach
  • For LinkedIn profiles, Tomba's LinkedIn finder is very effective

© gooseworks-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/lead-generation/capabilities/find-email-by-name of gooseworks-ai/goose-skills.

  • SKILL.md
  • skill.meta.json

Open the folder on GitHubat commit c650c6d

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in gooseworks-ai/goose-skills, which our catalogue first saw on October 9, 2026.

Compare with similar skills

Find Email By Name next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Find Email By Name compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Find Email By Name this skillgooseworks-ai/goose-skills1.2k1 repos~1.2kAutomated safety check: PassMIT
Consulting Analysisbytedance/deer-flow84k4 repos~8.4kAutomated safety check: PassMIT
Mvp Scopeemotixco/claude-skills-founder540—~803Automated safety check: PassMIT
Startup Validatorailabs-393/ai-labs-claude-skills4551 repos~2.8kAutomated safety check: PassMIT
Gingiris OpensourceGingiris/gingiris-opensource257—~1.4kAutomated safety check: PassMIT
Gingiris Ugc MatrixGingiris-1031/Competitor-analysis-tool110—~790Automated safety check: PassNone

Similar skills

  • Consulting Analysis

    bytedance/deer-flow

    A skill your agent uses when the user requests to generate, create, or write professional research reports including but not limited to market analysis, consumer insights, brand analysis, financial…

    84k GitHub starsUsed in 4 repos~8.4k tokens
    Marketing & SEOAuto-check passed
  • Mvp Scope

    emotixco/claude-skills-founder

    Cut a feature wishlist down to the smallest MVP that delivers value.

    540 GitHub stars~803 tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed
  • Startup Validator

    ailabs-393/ai-labs-claude-skills

    Comprehensive startup idea validation and market analysis tool.

    455 GitHub starsUsed in 1 repo~2.8k tokens
    Marketing & SEOAuto-check passed
  • Gingiris Opensource

    Gingiris/gingiris-opensource

    🇺🇸 Open Source Marketing Playbook — How to get 10k+ GitHub stars.

    257 GitHub stars~1.4k tokensUpdated 5 mo ago
    Marketing & SEOAuto-check passed
  • Gingiris Ugc Matrix

    Gingiris-1031/Competitor-analysis-tool

    🇺🇸 UGC Matrix Growth Playbook — Scale user-generated content with AI + real creators.

    110 GitHub stars~790 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Competitive Analysis Brief

    NateBJones-Projects/OB1

    Turns a competitor set into a decision-ready brief: profiles, pricing and packaging comparisons, a positioning map, a SWOT and recommended moves for operators and founders.

    4.7k GitHub stars~1.1k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed

More from gooseworks-ai/goose-skills

All 273 skills in this repo
  • Reddit Post Finder

    gooseworks-ai/goose-skills

    Scrape and search Reddit posts using Apify. An agent skill from gooseworks-ai/goose-skills.

    1.2k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Create Image Fal

    gooseworks-ai/goose-skills

    Generate or edit an image via any FAL image model (nano-banana edit, gpt-image, flux, ...), ROUTED THROUGH THE fal-proxy so it bills the Ads agent.

    1.2k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Render Hook Replacement

    gooseworks-ai/goose-skills

    Replace an existing video's opening with a supplied clip or free kinetic text hook while retaining and verifying every original body frame, audio, captions and ending.

    1.2k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Blog Feed Monitor

    gooseworks-ai/goose-skills

    Scrape blog posts via RSS feeds (free, no API key) with Apify fallback for JS-heavy sites.

    1.2k GitHub starsUsed in 1 repo~578 tokens
    Auto-check passed
  • Competitor Post Engagers

    gooseworks-ai/goose-skills

    Find leads by scraping engagers from a competitor's top LinkedIn posts.

    1.2k GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check: notes
  • Render Chatgpt Chat

    gooseworks-ai/goose-skills

    Assemble a ChatGPT chat-reveal video ad from a thread + timeline JSON — one continuous Playwright recording of a ChatGPT mobile chat (user types with the iOS keyboard up → taps send → keyboard…

    1.2k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Questions about Find Email By Name

What does Find Email By Name do?

Find someone's email address given their name and company. An agent skill from gooseworks-ai/goose-skills. Find Email By Name is an agent skill from gooseworks-ai/goose-skills.

When should I use Find Email By Name?

Find Email By Name fits situations like: marketing & SEO work in your project.

How do I install Find Email By Name in Claude Code?

Run `npx skills add gooseworks-ai/goose-skills --skill find-email-by-name -a claude-code`. Or copy the skill folder (skills/lead-generation/capabilities/find-email-by-name in gooseworks-ai/goose-skills) into .claude/skills/find-email-by-name in your project. Claude Code loads it when a task matches its description.

How do I install Find Email By Name in Codex?

Run `npx skills add gooseworks-ai/goose-skills --skill find-email-by-name -a codex`. Or copy the skill folder (skills/lead-generation/capabilities/find-email-by-name in gooseworks-ai/goose-skills) into .agents/skills/find-email-by-name in your project. Codex loads it when a task matches its description.

Can I use Find Email By Name in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gooseworks-ai/goose-skills --skill find-email-by-name -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/find-email-by-name, .gemini/skills/find-email-by-name, .github/skills/find-email-by-name and .opencode/skills/find-email-by-name in your project.

What does Find Email By Name need to run?

Going by SKILL.md and its folder, Find Email By Name needs the command-line tools its instructions call (curl, python3 and npx) and credentials named GOOSEWORKS_API_KEY. Our summary lists: Python 3; Node.js; A credential in GOOSEWORKS_API_KEY.

Does Find Email By Name access the network?

SKILL.md names 2 domains. In commands or code: api.gooseworks.ai and linkedin.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Find Email By Name safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Find Email By Name use?

Find Email By Name is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Find Email By Name use?

About 1.2k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Find Email By Name?

Skills that share tags, products or a category with Find Email By Name: Consulting Analysis (bytedance/deer-flow, 84k stars), Mvp Scope (emotixco/claude-skills-founder, 540 stars), Startup Validator (ailabs-393/ai-labs-claude-skills, 455 stars) and Gingiris Opensource (Gingiris/gingiris-opensource, 257 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Find Email By Name?

gooseworks-ai (a GitHub organization) maintains it in gooseworks-ai/goose-skills, which has 1,240 GitHub stars. The repository holds 273 skills in this directory. The repository was last updated on October 8, 2026.

Source: gooseworks-ai/goose-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.