#766 by GitHub stars

Kappaemme-git/codex-first-customer-finder-skill

Find evidence-backed potential first customers, beta users, or design partners from public demand signals. Use for product-specific prospect research, qualified shortlists, source-grounded outreach drafts, and follow-up searches refined by the user's feedback and local prospect history. Does not sen

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

first-customer-finder/SKILL.md

Week of Oct 26, 2026 · +0 / −0 lines

Before Local scripts → After Local scripts

d3f6964bd989 → d3f6964bd989

Compare on GitHub

View on GitHubAdd to my skills

Verified commit d3f6964bd989745ac183edbd545c588a68451146

1.2kGitHub stars
67stars in 7 days
1skill in this repository
0commits in 30 days

Heat

7.2
  • Star growth, last 7 daysAhead of 97% of tracked repositories
  • Star growth, last 24 hoursAhead of 95% of tracked repositories
  • Rank movement, last 7 daysAhead of 94% of tracked repositories
  • Commits, last 30 daysAhead of 0% of tracked repositories
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekAhead of 0% of tracked repositories

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Aug 2, 2026Nov 7, 20261,208

Individual skills in this repository

How it works

first-customer-finder

When your agent uses it

Find evidence-backed potential first customers, beta users, or design partners from public demand signals. Use for product-specific prospect research, qualified shortlists, source-grounded outreach drafts, and follow-up searches refined by the user's feedback and local prospect history. Does not send outreach automatically.

What it loads into context

Frontmatter

65 tokens

Always available to the agent

SKILL.md

1,810 tokens

When the skill is activated

Reference documents

3,803 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Workflow
  2. Modes
  3. Quality bar

Scripts executed separately

  • scripts/generate_report.py
  • scripts/prospect_data.py
  • scripts/prospect_history.py
  • scripts/report_exports.py

Files

  • SKILL.mdcore9,310 bytes
  • SKILL.mdcore9,310 bytes
  • SKILL.mdcore9,310 bytes
  • SKILL.mdcore9,310 bytes
  • agents/openai.yamlasset295 bytes
  • references/feedback-and-history.mddoc4,884 bytes
  • references/report-artifact.mddoc7,308 bytes
  • references/research-framework.mddoc5,754 bytes
  • scripts/generate_report.pyruns20,992 bytes
  • scripts/prospect_data.pyruns14,409 bytes
  • scripts/prospect_history.pyruns2,779 bytes
  • scripts/report_exports.pyruns7,554 bytes
Read SKILL.md

# First Customer Finder

Turn a startup URL or product description into a short, evidence-backed list of plausible first customers. Use public signals, preserve privacy, and distinguish a prospect from a confirmed buyer.

Read [references/research-framework.md](references/research-framework.md) before researching or scoring prospects and [references/report-artifact.md](references/report-artifact.md) before creating the final report. For saved history, feedback, or a repeat search, also read [references/feedback-and-history.md](references/feedback-and-history.md).

Use English by default; follow an explicit language request. Keep the chat handoff short and put the useful detail in the report. Research requires available web search/browser tools; the bundled Python helpers only validate, export, and manage local files. If live browsing is unavailable, report that limitation instead of inventing leads.

## Workflow

### 1. Understand the product

- Inspect the supplied URL, repository, landing-page copy, or product description.
- Identify the product, outcome, buyer, user, price or buying motion, geography, and strongest use case.
View the complete source on GitHub

Skills included

  • first-customer-finder

Repository facts

License
MIT
Created
Jul 12, 2026
Last pushed
Sep 19, 2026
Forks
140
Open issues
1
Project activity
Active

Rank over the last 12 weeks

Now #766 · best #563 · down 66 in 30 days

  1. #786 on Oct 31
  2. #787 from Nov 1 to Nov 2
  3. #792 on Nov 3
  4. #777 on Nov 4
  5. #770 on Nov 5
  6. #766 since Nov 6
69 earlier periods
  1. #551 on Aug 2
  2. #578 on Aug 6
  3. #548 on Aug 8
  4. #552 on Aug 9
  5. #574 on Aug 10
  6. #575 on Aug 11
  7. #567 on Aug 12
  8. #569 on Aug 13
  9. #567 on Aug 14
  10. #566 on Aug 16
  11. #571 on Aug 17
  12. #577 on Aug 19
  13. #576 on Aug 20
  14. #583 on Aug 21
  15. #563 on Aug 22
  16. #589 from Aug 23 to Aug 24
  17. #605 on Aug 25
  18. #590 on Aug 26
  19. #597 on Aug 27
  20. #613 on Aug 28
  21. #573 on Aug 29
  22. #571 on Aug 30
  23. #595 on Aug 31
  24. #609 on Sep 1
  25. #606 on Sep 3
  26. #586 on Sep 5
  27. #597 on Sep 6
  28. #604 on Sep 7
  29. #622 on Sep 8
  30. #610 on Sep 9
  31. #616 on Sep 10
  32. #606 on Sep 12
  33. #607 on Sep 13
  34. #632 on Sep 14
  35. #626 on Sep 15
  36. #634 on Sep 16
  37. #631 on Sep 17
  38. #613 on Sep 19
  39. #625 on Sep 20
  40. #635 on Sep 21
  41. #646 on Sep 22
  42. #620 on Sep 24
  43. #616 on Sep 25
  44. #664 on Sep 30
  45. #632 on Oct 1
  46. #653 on Oct 5
  47. #658 on Oct 6
  48. #664 on Oct 7
  49. #700 on Oct 8
  50. #679 on Oct 9
  51. #664 on Oct 10
  52. #660 on Oct 11
  53. #679 on Oct 12
  54. #676 on Oct 13
  55. #690 on Oct 14
  56. #682 on Oct 15
  57. #695 on Oct 16
  58. #672 on Oct 17
  59. #663 on Oct 18
  60. #699 on Oct 19
  61. #707 on Oct 20
  62. #714 on Oct 21
  63. #696 on Oct 22
  64. #695 on Oct 23
  65. #670 on Oct 24
  66. #778 on Oct 25
  67. #777 on Oct 28
  68. #780 on Oct 29
  69. #781 on Oct 30

Before you install

Local scripts

Automated signals, not a guarantee

Checked Nov 3, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 3 notes
  • first-customer-finder/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • first-customer-finder/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • first-customer-finder/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
Show all 20 signals by file

first-customer-finder/references/report-artifact.md

  • Network accessline 34
    "title": "First Customer Finder · Demo",   "product": "Example membership tool",   "product_url": "https://example.com/product",
  • Network accessline 35
    "product": "Example membership tool",   "product_url": "https://example.com/product",   "target_customer": "Independent gym owners",
  • Network accessline 36
    "product_url": "https://example.com/product",
  • Network accessline 42
    {       "name": "Example Gym (fictional)",       "entity_url": "https://example.com/gym",
  • Network accessline 43
    "name": "Example Gym (fictional)",       "entity_url": "https://example.com/gym",       "type": "Company",
  • Network accessline 44
    "entity_url": "https://example.com/gym",
  • Network accessline 51
    "why_now": "The fictional scenario concerns a recent request.",       "source_title": "Fictional membership workflow discussion",       "source_url": "https://example.com/discussion",
  • Network accessline 52
    "source_title": "Fictional membership workflow discussion",       "source_url": "https://example.com/discussion",       "source_type": "Fictional public forum",
  • Network accessline 53
    "source_url": "https://example.com/discussion",
  • Network accessline 61
    "status": "verified",         "label": "Fictional discussion reply",         "url": "https://example.com/discussion",
  • Network accessline 62
    "label": "Fictional discussion reply",         "url": "https://example.com/discussion",         "source_url": "https://example.com/discussion",
  • Network accessline 63
    "url": "https://example.com/discussion",
  • Network accessline 64
    "source_url": "https://example.com/discussion",
  • Network accessline 101
    - `contact_route.status` is `verified` or `not_found`. A verified route needs its URL, label, supporting public URL, check date, and suitability note. A missing route needs an honest note, no URL, and reachability <= 1/5; retain a concrete 
  • Network accessline 102
    - `next_step`, `cta`, `opener`, and `caution` are required. Include the exact `cta` in `opener`. A draft can be prepared for a missing route but must not imply it is ready to send there. - Optional `additional_sources`: array of `{ "url": "
  • Network accessline 103
    - Optional `additional_sources`: array of `{ "url": "https://...", "note": "What this supports" }`. Include corroboration/counter-evidence when it materially affects qualification.

first-customer-finder/scripts/generate_report.py

  • Executable scriptline 1
    #!/usr/bin/env python3

first-customer-finder/scripts/prospect_data.py

  • Executable scriptline 1
    Executable file

first-customer-finder/scripts/prospect_history.py

  • Executable scriptline 1
    #!/usr/bin/env python3

first-customer-finder/scripts/report_exports.py

  • Executable scriptline 1
    Executable file

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

No combined signals at this commit.

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeCompatibleStandard SKILL.md first-customer-finder/SKILL.md.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md first-customer-finder/SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md first-customer-finder/SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md first-customer-finder/SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md first-customer-finder/SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md first-customer-finder/SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

Explore alternatives and comparisons

Add this badge to your README

It updates every night and links to this page.

Kappaemme-git/codex-first-customer-finder-skill: #766 on hotskills, 1.2k stars

[![Kappaemme-git/codex-first-customer-finder-skill on hotskills](https://hotskills.dev/badge/kappaemme-git-codex-first-customer-finder-skill.svg)](https://hotskills.dev/skill/kappaemme-git-codex-first-customer-finder-skill/)