explaingit

raaaaageeeee/claude-first-customer-finder-skill

Analysis updated 2026-05-18

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

TLDR

A Claude Code skill that researches public signals to suggest plausible first customers for a new product, with an HTML report.

Mindmap

mindmap
  root((First Customer Finder))
    What it does
      Finds prospects
      Uses public signals
      Builds HTML report
    Tech stack
      Python
      Claude Code
    Use cases
      Early customer research
      Outreach drafting
      B2B prospecting
    Audience
      Founders
      Indie hackers
      Small teams

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

What do people build with it?

USE CASE 1

Find plausible first customers for a new startup by researching public pain signals.

USE CASE 2

Generate a standalone HTML report of qualified prospects for a product idea.

USE CASE 3

Draft outreach messages to early prospects without sending anything automatically.

USE CASE 4

Run a deep or community-focused research mode to widen the prospect search.

What is it built with?

PythonClaude Code

How does it compare?

raaaaageeeee/claude-first-customer-finder-skill0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencepm founderdeveloperresearcher

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

How do you get it running?

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

This repository is a Claude Code skill that helps a founder or small business owner find plausible first customers for a new product. You give it a startup URL or a short description of what the product does, and it researches public sources such as forums, reviews, and company pages to find people or companies who seem to have the problem the product solves. It then produces a short list of prospects backed by that public evidence, along with a standalone HTML report you can open and read. The skill only drafts outreach messages if asked. It never sends anything automatically on its own, so there is no risk of it contacting anyone without the user's involvement. The repository is explicit that it is a port, not an original creation. The actual research workflow, scoring system, and report generator were built by a different developer, Francesco Mistero, for a similar tool made for OpenAI's Codex. This version only changes a handful of text references so the same skill works inside Claude Code instead, and the author is careful to credit the original creator throughout the README rather than claim the work as their own. To use it, you copy the skill folder into your Claude Code skills directory, and Claude Code picks it up automatically. You can then ask Claude, in plain language, to run the skill against a product URL, choosing from modes like quick, standard, deep, or ones aimed at business customers or community outreach, each returning a different number of prospects. It is released under the MIT license, so it is free to use and modify. This tool suits founders, indie hackers, or small teams already using Claude Code who want a faster, evidence based starting point for early customer outreach instead of guessing who to contact first.

Copy-paste prompts

Prompt 1
Use the skill first-customer-finder in standard mode to find first customers for my product URL.
Prompt 2
Run first-customer-finder in deep mode and explain how it scored each prospect.
Prompt 3
Install this skill into my Claude Code skills directory and confirm it loaded correctly.
Prompt 4
Use the b2b mode of first-customer-finder to find companies that fit my product.

Frequently asked questions

What is claude-first-customer-finder-skill?

A Claude Code skill that researches public signals to suggest plausible first customers for a new product, with an HTML report.

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

Mainly Python. The stack also includes Python, Claude Code.

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

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

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

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

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

Mainly pm founder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.