A Claude Code 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 with Claude Code's web tools, 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.
- 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
npx --yes claude-first-customer-finder-skill@latest
This installs the skill into:
~/.claude/skills/first-customer-finder
Pass --project
to install into ./.claude/skills/first-customer-finder
for a single repository instead of your personal skills directory, or --skills-dir <path>
for a custom location.
Restart Claude Code after installation so it picks up the new skill.
Invoke it explicitly with the slash command, or just describe the task — Claude Code will pick up the skill from its description.
Find the first ten potential customers:
/first-customer-finder find ten evidence-backed potential first customers for https://example.com and create the final HTML report.
Find design partners:
/first-customer-finder in design-partners mode for this startup: [URL]. Prioritize people publicly describing the problem and likely to give product feedback.
B2B research:
/first-customer-finder in b2b mode for [URL]. Find public business triggers, qualify the relevant companies, and draft one opener per prospect without sending anything.
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.
The HTML report is saved to the workspace outputs/
directory and returned as a clickable absolute file path. If you want a shareable link instead of a local file, ask Claude to publish it as an Artifact.
quick
: up to five strong prospectsstandard
: up to ten prospects across several source typesdeep
: up to twenty prospects and repeated-pattern analysisdesign-partners
: feedback-oriented early adoptersb2b
: companies and public business triggerscommunity
: explicit requests and public discussion signals
git clone https://github.com/leo-proger/claude-first-customer-finder-skill.git
mkdir -p ~/.claude/skills
cp -R claude-first-customer-finder-skill/first-customer-finder ~/.claude/skills/first-customer-finder
Restart Claude Code after installation.
MIT