@opendirectory.dev/skills 0.1.41 → 0.1.42
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/skills/vc-finder/.env.example +1 -5
- package/skills/vc-finder/README.md +16 -9
- package/skills/vc-finder/SKILL.md +446 -193
- package/skills/vc-finder/data/vc_funds.json +277 -0
- package/skills/vc-finder/evals/evals.json +43 -25
- package/skills/vc-finder/scripts/match_funds.py +144 -0
package/package.json
CHANGED
|
@@ -1,10 +1,6 @@
|
|
|
1
1
|
# vc-finder: Environment Variables
|
|
2
2
|
# ===================================
|
|
3
|
-
#
|
|
4
|
-
|
|
5
|
-
# Required: Google Gemini API key for product analysis and VC synthesis
|
|
6
|
-
# Get it: aistudio.google.com > Get API key
|
|
7
|
-
GEMINI_API_KEY=your_gemini_api_key_here
|
|
3
|
+
# Tavily is required. Firecrawl is recommended.
|
|
8
4
|
|
|
9
5
|
# Required: Tavily API key for VC investment research (Track A and Track B searches)
|
|
10
6
|
# Get it: app.tavily.com > API Keys
|
|
@@ -30,29 +30,32 @@ https://github.com/user-attachments/assets/ee98a1b5-ebc4-452f-bbfb-c434f2935067
|
|
|
30
30
|
|
|
31
31
|
- Fetches the product URL via Firecrawl (handles JS-rendered SPAs) or Tavily extract as fallback
|
|
32
32
|
- Detects funding stage from CTA signals on the page (waitlist, free trial, pricing, sales CTAs)
|
|
33
|
-
-
|
|
33
|
+
- Maps a 3-level industry taxonomy (L1 > L2 > L3) from the product page
|
|
34
|
+
- **Curated pre-match (Step 5b):** Scores product against a verified dataset of 25 VC funds (sourced from fund websites) -- instant zero-hallucination matches with no Tavily credits consumed
|
|
35
|
+
- **Discovers comparable companies:** Curated portfolio companies from matched funds + Tavily live search for L3-niche specifics
|
|
34
36
|
- Track A: 5 Tavily searches to find who invested in each comparable company
|
|
35
37
|
- Track B: 3 Tavily searches to find VCs who publish investment theses about this specific niche
|
|
36
|
-
-
|
|
38
|
+
- Synthesizes and ranks all found VCs -- curated matches labeled "verified", Tavily matches labeled by track
|
|
37
39
|
- Produces top 5 deep-dives with fund overview, portfolio evidence, how-to-approach, and outreach hook
|
|
38
40
|
- Generates 3 product-specific outreach hooks (not generic advice)
|
|
39
41
|
- Saves output to `docs/vc-intel/[product]-[date].md`
|
|
40
42
|
|
|
43
|
+
**Zero-hallucination guarantee:** Every VC name, fund detail, check size, portfolio company, and thesis source in the output must trace to either (a) the curated `data/vc_funds.json` dataset (sourced from fund websites) or (b) a specific Tavily search result. The AI does not draw from training knowledge for any factual claim.
|
|
44
|
+
|
|
41
45
|
## Requirements
|
|
42
46
|
|
|
43
47
|
| Requirement | Purpose | How to Set Up |
|
|
44
48
|
|---|---|---|
|
|
45
|
-
| Gemini API key | Product analysis and VC synthesis | aistudio.google.com, Get API key |
|
|
46
49
|
| Tavily API key | VC investment research (Track A and Track B) | app.tavily.com, free tier: 1000 credits/month |
|
|
47
|
-
| Firecrawl API key | Fetching JS-rendered product pages | firecrawl.dev, free tier: 500 credits/month |
|
|
50
|
+
| Firecrawl API key | Fetching JS-rendered product pages (optional) | firecrawl.dev, free tier: 500 credits/month |
|
|
48
51
|
|
|
49
|
-
|
|
52
|
+
Tavily is required. Firecrawl is recommended -- without it, Tavily extract is used as fallback (may miss JS-rendered content).
|
|
50
53
|
|
|
51
54
|
## Setup
|
|
52
55
|
|
|
53
56
|
```bash
|
|
54
57
|
cp .env.example .env
|
|
55
|
-
# Add
|
|
58
|
+
# Add TAVILY_API_KEY (required)
|
|
56
59
|
# Add FIRECRAWL_API_KEY (recommended)
|
|
57
60
|
```
|
|
58
61
|
|
|
@@ -90,9 +93,9 @@ Each run produces:
|
|
|
90
93
|
## Cost per Run
|
|
91
94
|
|
|
92
95
|
- Firecrawl: ~$0.001 per fetch
|
|
93
|
-
- Tavily:
|
|
94
|
-
-
|
|
95
|
-
- Total: ~$0.
|
|
96
|
+
- Tavily: 10 searches at ~$0.01 each = ~$0.10 (2 comparable discovery + 5 Track A + 3 Track B)
|
|
97
|
+
- Curated pre-match (Step 5b): $0.00 -- local scoring against `data/vc_funds.json`, no API calls
|
|
98
|
+
- Total: ~$0.10 per run
|
|
96
99
|
|
|
97
100
|
## Project Structure
|
|
98
101
|
|
|
@@ -101,6 +104,10 @@ vc-finder/
|
|
|
101
104
|
├── SKILL.md
|
|
102
105
|
├── README.md
|
|
103
106
|
├── .env.example
|
|
107
|
+
├── data/
|
|
108
|
+
│ └── vc_funds.json (25 verified funds, sourced from fund websites)
|
|
109
|
+
├── scripts/
|
|
110
|
+
│ └── match_funds.py (standalone scoring script for testing)
|
|
104
111
|
├── evals/
|
|
105
112
|
│ └── evals.json
|
|
106
113
|
└── references/
|