← all repositories
Kappaemme-git/codex-first-customer-finder-skill

Turning public signals into a qualified first customer shortlist

It automates the grunt work of early customer discovery by turning public pain signals into an evidence-backed prospect list with draft outreach openers.

codex-first-customer-finder-skill
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does

This Codex skill takes a startup URL or product description and produces a ranked shortlist of potential first customers. It researches recent public signals—explicit complaints, workarounds, switching intent, and timing triggers—then links every prospect back to the original source. The final output is a standalone HTML report with fit scores, signal dates, and draft outreach openers, but it deliberately stops short of sending anything.

The interesting bit

Rather than scraping private contact databases or buying enrichment data, it treats public posts, discussions, and business triggers as primary research. The skill builds an evidence folder for each prospect before you write a single sentence, which is exactly the step most founders skip.

Key highlights

  • Evidence-based scoring: every prospect carries a fit and timing score tied to a public source link and date
  • Multiple research modes: quick (5 prospects), standard (10), deep (20), plus design-partner, B2B, and community-specific searches
  • Built-in guardrails: no automated sending, no private contact enrichment, and no sensitive personal data handling
  • Deliverable is a responsive HTML report with ICP definition, repeated pain patterns, and a 7-day manual outreach plan
  • Designed for the Codex CLI ecosystem; installs as a skill under ~/.codex/skills/

Caveats

  • The README explicitly warns that prospects are “hypotheses based on public signals, not confirmed customers or guaranteed buyers,” so the output is starting material, not a sales guarantee.

Verdict

Best for early-stage founders who need to turn a product idea into a concrete outreach list without hiring a sales researcher. If your pipeline is already full, skip it.

Frequently asked

What is Kappaemme-git/codex-first-customer-finder-skill?
It automates the grunt work of early customer discovery by turning public pain signals into an evidence-backed prospect list with draft outreach openers.
Is codex-first-customer-finder-skill open source?
Yes — Kappaemme-git/codex-first-customer-finder-skill is open source, released under the MIT license.
What language is codex-first-customer-finder-skill written in?
Kappaemme-git/codex-first-customer-finder-skill is primarily written in Python.
How popular is codex-first-customer-finder-skill?
Kappaemme-git/codex-first-customer-finder-skill has 1k stars on GitHub.
Where can I find codex-first-customer-finder-skill?
Kappaemme-git/codex-first-customer-finder-skill is on GitHub at https://github.com/Kappaemme-git/codex-first-customer-finder-skill.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.