First Customer Finder skill
A Codex skill that finds potential first customers from public demand signals, verifies an open contact route and builds a report.
- 1,251 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The skill gathers information about people from open sources, and the report contains names, roles and profile links.
- Reports and history are stored locally, but a report with people's names holds personal data, so handle it with care.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/first-customer-finderDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skill gathers information about people from open sources, and the report contains names, roles and profile links.
- Reports and history are stored locally, but a report with people's names holds personal data, so handle it with care.
This is third-party code. Review the repository files before installing.
What it does
First Customer Finder takes a product URL, repository or short description and looks for people with a public reason to care about it. The skill studies open sources: requests for a tool, manual workarounds, unresolved complaints. Then it scores each candidate on a weighted scale, checks whether the person has an open contact route and warns when there is none. The report opens in Codex: the person's role, an observed or inferred label, a source link, a realistic next step and a concrete call to action. A CSV export and a standalone HTML are available. You mark who fits and who does not, and the next search accounts for your preferences and local history: stable candidate ids, duplicate exclusion and manual contact notes. The skill sends no messages itself and calls the people it finds potential customers rather than confirmed buyers. By learning the author means saved search preferences, not model training. There is a design-partners mode and a mode that finds developers publicly asking for an alternative to a specific tool.
Who it is for. Founders and marketers who need first customers or partners for a product and are ready to reach out by hand.
Good fit when
- A new product is live and you need the first five people publicly looking for such a solution.
- You need design partners: companies with a clear need to test an idea.
- You want to find developers asking for an alternative to a specific tool.
- You need to refresh an existing list and recheck sources.
- You need a candidate table in CSV with sources and next steps.
Not a fit when
- You need automatic bulk outreach, but the skill sends nothing and does not replace a CRM.
- You need a contact database with personal phones and emails, while the skill works only from open signals.
- The environment has no web search or browser, which the search needs.
Example request
Use $first-customer-finder to find five potential customers for my product at the site URL. Save the report as CSV.Limitations
The people found are called potential customers on the basis of public data, they gave no consent to promotion, and route verification only means Codex inspected the page. Before sending messages follow platform rules and local laws on personal data and mailings. History is stored in the chosen workspace and is not uploaded. Node.js is needed for the installer, Python 3.9 and a Codex environment with web access. No third-party service keys are required.
How to disable. Delete the `$CODEX_HOME/skills/first-customer-finder` or `~/.codex/skills/first-customer-finder` folder. History lives in your workspace, so delete it by hand.
FAQ
Does the skill send messages?
No. It only finds candidates and prepares a report, and the next step is yours.
What data does it use?
Open sources only: public requests, reviews and discussions. No third-party data subscription is required.
How does the skill use my feedback on candidates?
You mark who fits, and the next search uses those preferences and a local history with stable ids.
What to do on update?
Rerun the install command and restart Codex. The installer keeps the previous skill folder outside the active directory.
Which report formats exist?
Markdown inside Codex, CSV for spreadsheets and a standalone HTML.
Discussion
No questions or reviews yet.
Related
SkillsA skill that searches 15 channels for creators with their own audience, gathers public contacts and appends them to a Google Sheet
YC skills for Claude Code hiring: pipeline, candidate emails, scheduling, Work at a Startup, Ashby and Gmail
A local-first set of Codex skills and a read-only CLI that turns your own WeChat history into search, digests, follow-ups and opportunity tracking
Ozon selling advisor for Codex
Ozon Expert Skill
A Codex skill with baseline Ozon selling knowledge: automated listing uploads, Ozon-specific keyword optimization and operational diagnostics
OpenOutreach picks B2B prospects from a product description, explains each pick and emails them from your mailbox
141 skills for Amazon, TikTok Shop, Ozon and 1688: product search, keywords, trends, patent screening and GEO checks.
README in short
The README presents version 2 of the skill: concrete next steps, feedback-driven search, local history and stable candidate ids. Installs with one npx command.