@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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@opendirectory.dev/skills",
3
- "version": "0.1.41",
3
+ "version": "0.1.42",
4
4
  "main": "dist/index.js",
5
5
  "types": "dist/index.d.ts",
6
6
  "bin": {
@@ -1,10 +1,6 @@
1
1
  # vc-finder: Environment Variables
2
2
  # ===================================
3
- # Gemini and Tavily are required. Firecrawl is recommended.
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
- - Uses Gemini to map a 3-level industry taxonomy (L1 > L2 > L3) and identify 5 comparable funded companies
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
- - Gemini synthesizes and ranks all found VCs by stage fit and space fit (1-10 scores)
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
- Gemini and Tavily are required. Firecrawl is recommended -- without it, Tavily extract is used as fallback (may miss JS-rendered content).
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 GEMINI_API_KEY and TAVILY_API_KEY (required)
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: 8 searches at ~$0.01 each = ~$0.08
94
- - Gemini: 2 calls at ~$0.015 each = ~$0.03
95
- - Total: ~$0.12 per run
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/