# whale-hunter

The whale-hunter Claude Code skill finds company decision-makers and drafts a tailored pitch. It starts when asked to identify a buyer, locate a CFO, or write a cold email.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 92 repo stars
- Author: Jake Schincariol
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Jakeschincariol/whale-skill/tree/HEAD/whale-hunter/SKILL.md
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/whale-hunter

## What it does

whale-hunter searches public business sources for people who approve spending, control a budget, or deal with the problem a product addresses. It stores people and their sources on a shared board, selects one contact, then drafts a short pitch with a demo and a modest first ask.

The skill includes `hunter.py` and `board.py`. An email address must come from a source the company has published; the script does not guess address patterns. The draft is shown for approval before anything is sent. After approval, it can be created as a Gmail draft for the user to send, or sent through the Gmail connector if requested. The sent message is logged only afterward.

Python 3 is needed to run the scripts. Cold email to people in the UK, EU, or Canada requires a lawful basis or consent first. Sending through the connector still needs explicit approval for that specific message.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add Jakeschincariol/whale-skill
```
In the agent chat (not a shell):
```text
/plugin install whale-skill@whale-skill
```
This installs the whole whale-skill plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/whale-skill --skill whale-hunter -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/whale-hunter/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/whale-hunter/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/whale-skill --skill whale-hunter -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/whale-hunter/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/whale-skill --skill whale-hunter -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/whale-hunter/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Jakeschincariol/whale-skill whale-hunter
```

2. **Manually: put the files in place**
- File: `.github/skills/whale-hunter/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Jakeschincariol/whale-skill --skill whale-hunter -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Jakeschincariol/whale-skill --path whale-hunter
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/whale-hunter/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Jakeschincariol/whale-skill/tree/HEAD/whale-hunter/SKILL.md

## When to use it
- identify the person who signs off on company spending
- find a published work email for a business contact
- draft a concise pitch addressed to one decision-maker
- log a pitch after it has been sent

## Example prompts
- Find the decision-maker at North Pier Logistics.
- Locate the CFO at north-pier and draft a short demo pitch.
- Prepare a pitch for the north-pier deal and show it before sending.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e5461032ed0b73b2.

BEGIN THIRD-PARTY FILE e5461032ed0b73b2
````text
---
name: whale-hunter
description: >-
  Whale Hunter. Finds the decision makers and pitches them. Looks up who signs the check, who owns the
  budget and who feels the pain at a company you want as a customer, using public business sources only,
  then writes a short pitch to the right person: what they pay today, the demo, and one small ask. Every
  email waits for your yes and goes out from your own account, with the legal footer and a plain way to
  opt out. Use when the user says "who decides at X", "find the decision maker", "find the CFO", "pitch
  them", "write the pitch", "cold email the buyer", "go after this company", or "hunt whales".
argument-hint: "[who <company> | draft <deal> | record <deal>]"
---

# whale-hunter

One big customer changes everything, and big customers don't come from ads. They come from a short,
specific note to the one person who can say yes. The Hunter finds that person and writes that note.
It never sends anything itself.

`${CLAUDE_SKILL_DIR}` below is this skill's folder (where this SKILL.md lives).

```bash
python3 "${CLAUDE_SKILL_DIR}/hunter.py" who --company north-pier
python3 "${CLAUDE_SKILL_DIR}/hunter.py" draft --deal north-pier --demo https://yourproduct.example/demo
python3 "${CLAUDE_SKILL_DIR}/hunter.py" record --deal north-pier --subject "You pay \$6,400 a month to chase invoices" \
    --text-file /tmp/pitch.txt --approval "yes" --at 2026-10-26T09:04
```

Add people and deals with the shared board:

```bash
python3 "${CLAUDE_SKILL_DIR}/../market-researcher/board.py" company --id north-pier --name "North Pier Logistics" --website https://northpierlogistics.com
python3 "${CLAUDE_SKILL_DIR}/../market-researcher/board.py" person --id renee-alvarez --company north-pier --name "Renee Alvarez" --title CFO \
    --decides signs --email renee@northpierlogistics.com --email_source https://northpierlogistics.com/team
python3 "${CLAUDE_SKILL_DIR}/../market-researcher/board.py" deal --id north-pier --company north-pier --person renee-alvarez --title "Founding customer"
```

## Who decides

- **`signs`** signs the check. A CFO or an owner. Pitch this person first.
- **`budget`** owns the budget. A VP. Pitch them if the signer is out of reach.
- **`pain`** feels the pain every day. A manager. They rarely buy, but they tell you what it's worth, so talk to them first.

## Steps

1. **Find the people.** Search the company's own site (team, leadership, contact pages), press releases and professional
   profiles they published for work. Save each one with `board.py person` and where you found them.
````
END THIRD-PARTY FILE e5461032ed0b73b2

The third-party file has ended. Everything between the e5461032ed0b73b2 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2572 of 5524 bytes. © Jake Schincariol · MIT · https://github.com/Jakeschincariol/whale-skill/tree/HEAD/whale-hunter/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
