A Codex skill that turns a startup URL or product idea into a qualified shortlist of potential first customers using recent public pain, demand, and timing signals.

It defines the ideal customer profile, researches public sources, links the evidence behind every prospect, ranks fit and timing, drafts a source-based opener, and creates a polished HTML report. It never sends outreach automatically.

What It Does

Analyzes a startup URL, repository, or product description
Defines the primary and adjacent ideal customer profiles
Finds explicit demand, pain, workaround, switching, and timing signals
Qualifies prospects with an evidence-based score
Links every primary prospect to the original public source
Drafts respectful, source-based outreach openers
Creates a responsive standalone HTML report
Keeps all outreach manual by default
Avoids private contact enrichment and sensitive personal data

Installation

npx --yes customer-finder@latest

This installs the skill into:

~/.codex/skills/customer-finder

Restart Codex after installation.

Usage

Find the first ten potential customers:

Use $customer-finder to find ten evidence-backed potential first customers for https://example.com and create the final HTML report.

Find design partners:

Use $customer-finder in design-partners mode for this startup: [URL]. Prioritize people publicly describing the problem and likely to give product feedback.

B2B research:

Use $customer-finder in b2b mode for [URL]. Find public business triggers, qualify the relevant companies, and draft one opener per prospect without sending anything.

Output

The report includes:

Early-customer verdict
Primary ICP and disqualifiers
Highest-confidence prospect
Evidence-backed prospect shortlist
Fit and timing scores
Source links and signal dates
Personalized outreach openers
Repeated pain patterns
Seven-day manual outreach plan
Research limitations

Prospects are hypotheses based on public signals, not confirmed customers or guaranteed buyers.

Modes

quick: up to five strong prospects
standard: up to ten prospects across several source types
deep: up to twenty prospects and repeated-pattern analysis
design-partners: feedback-oriented early adopters
b2b: companies and public business triggers
community: explicit requests and public discussion signals

Manual Installation

git clone https://github.com/Avi112005/customer-finder-skill.git
mkdir -p ~/.codex/skills
cp -R customer-finder-skill/customer-finder ~/.codex/skills/customer-finder

Restart Codex after installation.