GitHub - leo-proger/claude-first-customer-finder-skill: A Claude skill that finds evidence-backed potential first customers from recent public signals.

GitHub

3 min read Original article ↗

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.

What It Does

  • 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

Installation

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.

Usage

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.

Output

The report includes:

  1. Early-customer verdict
  2. Primary ICP and disqualifiers
  3. Highest-confidence prospect
  4. Evidence-backed prospect shortlist
  5. Fit and timing scores
  6. Source links and signal dates
  7. Personalized outreach openers
  8. Repeated pain patterns
  9. Seven-day manual outreach plan
  10. 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.

Modes

  • quick: up to five strong prospects
  • standard: up to ten prospects across several source types
  • deep: up to twenty prospects and repeated-pattern analysis
  • design-partners: feedback-oriented early adopters
  • b2b: companies and public business triggers
  • community: explicit requests and public discussion signals

Manual Installation

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.

License

MIT