Analysis updated 2026-05-18
Find potential first customers for a startup based on public evidence of demand.
Identify early design partners likely to give product feedback.
Research companies showing public business triggers for a B2B product.
Generate a shareable HTML report of prospects with sources and draft outreach messages.
| kappaemme-git/codex-first-customer-finder-skill | facebookresearch/sonar | oil-oil/beautify-github-readme | |
|---|---|---|---|
| Stars | 901 | 896 | 917 |
| Language | Python | Python | Python |
| Last pushed | — | 2025-10-10 | — |
| Maintenance | — | Quiet | — |
| Setup difficulty | easy | moderate | easy |
| Complexity | 2/5 | 4/5 | 2/5 |
| Audience | pm founder | researcher | vibe coder |
Figures from each repo's GitHub metadata at analysis time.
Installs with a single npx command into the Codex skills folder, requires Codex already set up.
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.
A Codex skill that researches public signals to build an evidence-backed shortlist of potential first customers for a startup.
Mainly Python. The stack also includes Python, Codex.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly pm founder.
This repo across BitVibe Labs
Verify against the repo before relying on details.