#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
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
Individual skills in this repository
- first-customer-finder
first-customer-finder
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 tokensAlways available to the agent
SKILL.md
1,810 tokensWhen the skill is activated
Reference documents
3,803 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Workflow
- Modes
- Quality bar
Scripts executed separately
scripts/generate_report.pyscripts/prospect_data.pyscripts/prospect_history.pyscripts/report_exports.py
Files
SKILL.mdcore9,310 bytesSKILL.mdcore9,310 bytesSKILL.mdcore9,310 bytesSKILL.mdcore9,310 bytesagents/openai.yamlasset295 bytesreferences/feedback-and-history.mddoc4,884 bytesreferences/report-artifact.mddoc7,308 bytesreferences/research-framework.mddoc5,754 bytesscripts/generate_report.pyruns20,992 bytesscripts/prospect_data.pyruns14,409 bytesscripts/prospect_history.pyruns2,779 bytesscripts/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 GitHubSkills 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
- #786 on Oct 31
- #787 from Nov 1 to Nov 2
- #792 on Nov 3
- #777 on Nov 4
- #770 on Nov 5
- #766 since Nov 6
69 earlier periods
- #551 on Aug 2
- #578 on Aug 6
- #548 on Aug 8
- #552 on Aug 9
- #574 on Aug 10
- #575 on Aug 11
- #567 on Aug 12
- #569 on Aug 13
- #567 on Aug 14
- #566 on Aug 16
- #571 on Aug 17
- #577 on Aug 19
- #576 on Aug 20
- #583 on Aug 21
- #563 on Aug 22
- #589 from Aug 23 to Aug 24
- #605 on Aug 25
- #590 on Aug 26
- #597 on Aug 27
- #613 on Aug 28
- #573 on Aug 29
- #571 on Aug 30
- #595 on Aug 31
- #609 on Sep 1
- #606 on Sep 3
- #586 on Sep 5
- #597 on Sep 6
- #604 on Sep 7
- #622 on Sep 8
- #610 on Sep 9
- #616 on Sep 10
- #606 on Sep 12
- #607 on Sep 13
- #632 on Sep 14
- #626 on Sep 15
- #634 on Sep 16
- #631 on Sep 17
- #613 on Sep 19
- #625 on Sep 20
- #635 on Sep 21
- #646 on Sep 22
- #620 on Sep 24
- #616 on Sep 25
- #664 on Sep 30
- #632 on Oct 1
- #653 on Oct 5
- #658 on Oct 6
- #664 on Oct 7
- #700 on Oct 8
- #679 on Oct 9
- #664 on Oct 10
- #660 on Oct 11
- #679 on Oct 12
- #676 on Oct 13
- #690 on Oct 14
- #682 on Oct 15
- #695 on Oct 16
- #672 on Oct 17
- #663 on Oct 18
- #699 on Oct 19
- #707 on Oct 20
- #714 on Oct 21
- #696 on Oct 22
- #695 on Oct 23
- #670 on Oct 24
- #778 on Oct 25
- #777 on Oct 28
- #780 on Oct 29
- #781 on Oct 30
Before you install
Local scriptsAutomated 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:1Analysis incomplete: Referenced executable target unavailable; not analyzedfirst-customer-finder/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedfirst-customer-finder/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- No broad tool permissions
- No dangerous shell commands
- 16 network referencesin 1 file: first-customer-finder/references/report-artifact.md:34
- No hidden or obfuscated text
- No instruction overrides
- 4 executable scriptsin 4 files: first-customer-finder/scripts/generate_report.py:1 first-customer-finder/scripts/prospect_data.py:1 first-customer-finder/scripts/prospect_history.py:1 and 1 more
- No access to secrets
- No requests to vote in Hot
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 | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Compatible | Standard SKILL.md first-customer-finder/SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md first-customer-finder/SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md first-customer-finder/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md first-customer-finder/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md first-customer-finder/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard 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.
[](https://hotskills.dev/skill/kappaemme-git-codex-first-customer-finder-skill/)