gitwtfhub

wtf is codex-first-customer-finder-skill?

kappaemme-git/codex-first-customer-finder-skill — explained in plain English

Analysis updated 2026-05-18

901PythonAudience · pm founderComplexity · 2/5LicenseSetup · easy

TL;DR

A Codex skill that researches public signals to build an evidence-backed shortlist of potential first customers for a startup.

Mindmap

mindmap
  root((first-customer-finder))
    What it does
      Finds evidence of demand
      Scores prospect fit
      Drafts outreach openers
    Tech stack
      Python
      Codex skill
    Use cases
      Find early startup customers
      Identify design partners
      Research B2B triggers
    Audience
      Founders
      PMs
      Early-stage startups

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Find potential first customers for a startup based on public evidence of demand.

REASON 2

Identify early design partners likely to give product feedback.

REASON 3

Research companies showing public business triggers for a B2B product.

REASON 4

Generate a shareable HTML report of prospects with sources and draft outreach messages.

What's in the stack?

PythonCodex

How it stacks up

kappaemme-git/codex-first-customer-finder-skillfacebookresearch/sonaroil-oil/beautify-github-readme
Stars901896917
LanguagePythonPythonPython
Last pushed2025-10-10
MaintenanceQuiet
Setup difficultyeasymoderateeasy
Complexity2/54/52/5
Audiencepm founderresearchervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Installs with a single npx command into the Codex skills folder, requires Codex already set up.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

This project is a skill for Codex, an AI coding assistant, that helps a founder find their first potential customers. You give it a startup's website, a code repository, or just a description of the product, and it researches public sources to build a shortlist of people or companies who might be a good fit to buy or try the product. Instead of guessing, it looks for real public evidence such as someone complaining about a problem, describing a workaround, mentioning they are switching tools, or showing other signs of timing and demand. Each prospect it suggests is linked back to the original public source it came from, so you can verify the evidence yourself rather than trusting a black box score. It also drafts a respectful, source-based opening message for each prospect, but importantly it never sends anything automatically. All outreach stays manual and in your control. The tool can run in different modes depending on what you need. A quick mode returns a handful of strong prospects, a standard mode covers up to ten across multiple source types, and a deep mode goes further with up to twenty prospects and looks for repeated patterns in the pain points found. There are also specialized modes for finding early design partners who are likely to give feedback, for business to business research focused on company-level triggers, and for community mode which looks at public discussion signals. The final output is a polished, standalone HTML report that includes an early-customer verdict, a description of your ideal customer profile, the strongest prospects with their evidence and scores, draft outreach messages, and a seven day manual outreach plan. The README is clear that these are hypotheses based on public signals, not confirmed customers. You install it with a single command that places the skill into your Codex skills folder, then restart Codex to use it. It is released under the MIT license.

Yoink these prompts

Prompt 1
Use first-customer-finder to find ten evidence-backed potential first customers for my startup URL and create the HTML report.
Prompt 2
Use first-customer-finder in design-partners mode for my startup and prioritize people describing the problem publicly.
Prompt 3
Use first-customer-finder in b2b mode to find companies with public business triggers relevant to my product.
Prompt 4
Install the first-customer-finder Codex skill and show me an example run.

Frequently asked questions

wtf is codex-first-customer-finder-skill?

A Codex skill that researches public signals to build an evidence-backed shortlist of potential first customers for a startup.

What language is codex-first-customer-finder-skill written in?

Mainly Python. The stack also includes Python, Codex.

What license does codex-first-customer-finder-skill use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is codex-first-customer-finder-skill to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codex-first-customer-finder-skill for?

Mainly pm founder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.