@opendirectory.dev/skills 0.1.33 → 0.1.35

package/skills/vc-finder/evals/evals.json

@@ -0,0 +1,125 @@
+[
+  {
+    "id": "eval_001",
+    "name": "B2B SaaS product URL: full two-track output with correct stage detection",
+    "description": "A B2B SaaS developer tool with a demo CTA. Validates the full 10-step workflow, stage detection from page signals, two-track VC research, and complete output.",
+    "input": {
+      "prompt": "Find VCs for my startup: https://linear.app",
+      "env": {
+        "GEMINI_API_KEY": "set",
+        "TAVILY_API_KEY": "set",
+        "FIRECRAWL_API_KEY": "set"
+      }
+    },
+    "expected_behavior": [
+      "Fetches URL via Firecrawl",
+      "Step 4 detects 'free trial or demo CTA' signal from page content",
+      "Stage outputs 'seed' or 'series-a' with medium or high confidence",
+      "Industry taxonomy: software > developer tools > issue tracking or project management",
+      "Generates 5 comparable companies (e.g. Jira, Shortcut, Height, Plane, Asana)",
+      "Runs 5 Track A Tavily searches using quoted company names",
+      "Runs 3 Track B Tavily searches using L2 and L3 taxonomy terms",
+      "Every Track A VC in the output has evidence_company field populated",
+      "Every Track B VC in the output has thesis_source_title field populated",
+      "Self-QA step removes any VCs missing required evidence fields",
+      "Output includes exactly 5 deep dives and exactly 3 outreach hooks",
+      "Output saved to docs/vc-intel/linear-[date].md"
+    ],
+    "expected_output": "Full two-track VC list with sourced Track A evidence and Track B thesis citations, 5 deep dives with product-specific outreach hooks, saved to docs/vc-intel/"
+  },
+  {
+    "id": "eval_002",
+    "name": "Consumer app: different stage signals, consumer-focused VCs not B2B enterprise funds",
+    "description": "A consumer mobile app. Validates that the skill detects consumer-specific signals and returns consumer-focused investors, not enterprise SaaS funds.",
+    "input": {
+      "prompt": "Find investors for this consumer app: https://www.bereal.com",
+      "env": {
+        "GEMINI_API_KEY": "set",
+        "TAVILY_API_KEY": "set",
+        "FIRECRAWL_API_KEY": "set"
+      }
+    },
+    "expected_behavior": [
+      "Fetches URL successfully",
+      "Industry taxonomy maps to consumer or social media, not B2B SaaS",
+      "Comparable companies are consumer social apps, not enterprise tools",
+      "Track A searches target consumer social investors (who backed TikTok, Snapchat, Instagram at early stage)",
+      "Track B searches use consumer social or UGC thesis terms",
+      "VCs in output are consumer-focused funds, not B2B SaaS investors",
+      "Outreach hooks are specific to consumer social or photo product type",
+      "No B2B enterprise-only investors appear in the output"
+    ],
+    "expected_output": "VC list with consumer-focused investors, stage-appropriate alignment, no B2B enterprise fund entries"
+  },
+  {
+    "id": "eval_003",
+    "name": "Description-only input: skips fetch, goes direct to Gemini analysis",
+    "description": "User pastes a product description with no URL. Validates that Steps 3 and 4 are skipped and the skill proceeds directly to Gemini analysis.",
+    "input": {
+      "prompt": "Find VCs for my startup. Here's what we do: We build an AI-powered legal contract review tool for in-house legal teams at mid-market companies. Our tool flags risky clauses and suggests standard language. We're pre-seed, 3 months post-launch, no pricing page yet. US-focused.",
+      "env": {
+        "GEMINI_API_KEY": "set",
+        "TAVILY_API_KEY": "set",
+        "FIRECRAWL_API_KEY": "not set"
+      }
+    },
+    "expected_behavior": [
+      "Detects no URL in the input",
+      "Skips Step 3: no fetch attempt is made",
+      "Skips Step 4: no regex stage detection from page",
+      "Passes the pasted description directly to Gemini in Step 5",
+      "Stage set to 'pre-seed' with high confidence (user stated it explicitly)",
+      "Industry taxonomy: software > legaltech > contract review automation",
+      "Generates 5 comparable legaltech companies",
+      "Runs full Track A and Track B searches using description-derived comparables and taxonomy",
+      "Output note: 'Stage: pre-seed (stated by user)'",
+      "data_quality_flags includes note about stage coming from user description not page signals"
+    ],
+    "expected_output": "Full VC list using description-derived analysis, legaltech-specific investors, stage labeled as user-stated"
+  },
+  {
+    "id": "eval_004",
+    "name": "GEMINI_API_KEY missing: immediate stop at Step 1",
+    "description": "Validates that the skill stops at Step 1 with exact setup instructions when Gemini key is absent.",
+    "input": {
+      "prompt": "Find VCs for https://stripe.com",
+      "env": {
+        "GEMINI_API_KEY": "not set",
+        "TAVILY_API_KEY": "set",
+        "FIRECRAWL_API_KEY": "set"
+      }
+    },
+    "expected_behavior": [
+      "Step 1 detects GEMINI_API_KEY is missing",
+      "Stops immediately at Step 1",
+      "Tells the user: 'GEMINI_API_KEY is required for product analysis and VC synthesis. Get it at aistudio.google.com. Add it to your .env file.'",
+      "Does NOT fetch the URL",
+      "Does NOT run any Tavily searches",
+      "Does NOT attempt any analysis"
+    ],
+    "expected_output": "Immediate stop at Step 1 with exact error message including the URL to get the key. No partial output generated."
+  },
+  {
+    "id": "eval_005",
+    "name": "TAVILY_API_KEY missing: immediate stop at Step 1, no fallback",
+    "description": "Validates that the skill stops at Step 1 when Tavily key is absent, with no fallback path suggested.",
+    "input": {
+      "prompt": "Who invests in CI/CD automation startups? https://buildkite.com",
+      "env": {
+        "GEMINI_API_KEY": "set",
+        "TAVILY_API_KEY": "not set",
+        "FIRECRAWL_API_KEY": "set"
+      }
+    },
+    "expected_behavior": [
+      "Step 1 detects GEMINI_API_KEY is set",
+      "Step 1 detects TAVILY_API_KEY is missing",
+      "Stops immediately at Step 1",
+      "Tells the user: 'TAVILY_API_KEY is required to research VC investments and theses. There is no fallback for this. Get it at app.tavily.com. Free tier: 1000 credits/month (about 125 full runs). Add it to your .env file.'",
+      "Does NOT fetch the URL",
+      "Does NOT run any Gemini analysis",
+      "Does NOT suggest any workaround"
+    ],
+    "expected_output": "Immediate stop at Step 1 with exact error message. Does not proceed past setup check."
+  }
+]

package/skills/vc-finder/references/stage-signals.md

@@ -0,0 +1,98 @@
+# Stage Signals Reference
+
+Used by SKILL.md Step 4 to detect funding stage from product page content before any API call.
+
+---
+
+## Signal Detection Table
+
+| Signal Pattern (regex) | Stage Hint | Example Page Text |
+|---|---|---|
+| `join (the )?waitlist` | pre-seed | "Join the waitlist for early access" |
+| `sign up for beta` | pre-seed | "Sign up for our beta program" |
+| `early access` | pre-seed | "Request early access" |
+| `request (an? )?invite` | pre-seed | "Request an invite" |
+| `get notified` | pre-seed | "Get notified when we launch" |
+| `start (your )?free trial` | seed | "Start your free 14-day trial" |
+| `try (it )?for free` | seed | "Try for free, no credit card required" |
+| `request a? demo` | seed | "Request a demo" |
+| `book a? demo` | seed | "Book a demo with our team" |
+| `schedule a? demo` | seed | "Schedule a 30-minute demo" |
+| `contact sales` | series-a | "Contact sales for enterprise pricing" |
+| `talk to (our )?sales` | series-a | "Talk to our sales team" |
+| `see pricing` / `view pricing` | series-a | "See pricing" |
+| `plans and pricing` | series-a | "Plans and Pricing" |
+| `case stud(y\|ies)` | series-a | "Read our case studies" |
+| `customer stor(y\|ies)` | series-a | "Customer success stories" |
+| `trusted by \d+` | series-a | "Trusted by 2,000+ teams" |
+| `enterprise (plan\|pricing\|tier)` | series-a-or-b | "Enterprise plan available" |
+| `we.?re hiring` | series-a-or-b | "We're hiring -- see open roles" |
+| `join our team` | series-a-or-b | "Join our team of 50+" |
+| `raised \$[\d,.]+[mk]?` | announced | "We raised $8M in Series A" |
+| `series [abc] round` | announced | "Series B round closed" |
+| `seed round` | announced | "Seed round led by X" |
+
+---
+
+## Signal Confidence Rules
+
+| Signals Found | Confidence |
+|---|---|
+| 2 or more matching signals | high |
+| Exactly 1 matching signal | medium |
+| 0 signals (stage estimated from content alone) | low |
+| Funding announcement text found directly | high (overrides other signals) |
+
+---
+
+## Handling Conflicting Signals
+
+Some pages show signals from multiple stages simultaneously (e.g. a pricing page AND a waitlist). Use this resolution order:
+
+1. Funding announcement text wins over all other signals (the stage is known, not inferred)
+2. If both "pricing page" (Series A) and "free trial" (seed) signals appear: call it seed-to-series-a transition, output `series-a` with medium confidence
+3. If both "waitlist" (pre-seed) and "demo request" (seed) signals appear: output `seed` -- the product is likely further along than the waitlist implies
+4. If no signals found at all: output `unknown` with low confidence, pass this to Gemini with a note to infer from product maturity and content
+
+---
+
+## Common Misdetections
+
+**"Request demo" from a mature Series B company:** Some large companies keep demo CTAs even after raising Series B. Override signals if the page also shows: enterprise logo bars, "trusted by Fortune 500", or explicit Series B announcement.
+
+**Open-source projects:** Often show no stage signals (no pricing, no CTA). Output `unknown`. In the Gemini analysis step, note that the product appears open-source and ask Gemini to infer whether there is a commercial entity behind it.
+
+**Startup landing pages with no product live:** A site with only a headline, a value prop paragraph, and an email capture is almost certainly pre-seed. Even without explicit waitlist language, if the page has no product demo and no pricing, output `pre-seed` with medium confidence.
+
+---
+
+## Stage-to-Tavily Query Modifiers
+
+These modifiers are added to Track B search queries based on detected stage:
+
+| Detected Stage | Query Modifier |
+|---|---|
+| pre-seed | "pre-seed micro VC angel" |
+| seed | "seed fund" |
+| series-a | "series A lead investor" |
+| series-b | "growth stage VC" |
+| unknown | "early stage" (default) |
+
+Example Track B query with modifier:
+- L3 = "CI/CD automation", stage = seed
+- Query: `seed fund "CI/CD automation" investment thesis portfolio companies`
+
+---
+
+## Stage-to-VC-Check-Size Reference
+
+Use this to validate stage fit scores in the synthesis step:
+
+| Stage | Typical Check Size |
+|---|---|
+| Pre-seed | $25K-$500K |
+| Seed | $500K-$3M |
+| Series A | $3M-$15M |
+| Series B | $15M-$50M |
+
+A VC whose typical check size is $20M-$50M has a stage fit score of 2 or lower for a pre-seed product, regardless of how well their thesis matches.

package/skills/vc-finder/references/vc-outreach-guide.md

@@ -0,0 +1,142 @@
+# VC Outreach Guide
+
+How to approach the different investor archetypes the skill surfaces. The right approach depends on the VC type, not on the founder's preference.
+
+---
+
+## 5 Investor Archetypes
+
+### Archetype 1: Thesis-First Writers (Track B investors)
+
+These VCs publish blog posts, newsletters, or Twitter threads about why they want to invest in a specific space. They are signaling active deal interest.
+
+**How to approach:**
+1. Read the article or post that surfaced them in Track B before reaching out
+2. Open with a direct reference to their specific thesis language, not a paraphrase: "You wrote in [post title] that you believe [exact phrase from post]. We built exactly that."
+3. Keep the first message under 100 words. The thesis reference does the work -- do not over-explain.
+4. Cold email works here. These VCs publish specifically to attract inbound -- they expect cold emails from founders who read their work.
+
+**What to avoid:** Do not write "I came across your firm" or "I've been following your work." These are signals that you did not actually read the thesis. Quote it or do not mention it.
+
+---
+
+### Archetype 2: Portfolio-Pattern Investors (Track A investors)
+
+These VCs backed a company comparable to yours. They already understand the space, the buyer, and the risk profile.
+
+**How to approach:**
+1. Name the specific portfolio company in your opening: "You backed [Company X] which means you understand [specific pain]."
+2. Do not position yourself as a competitor to their portfolio company. Instead, find the adjacent or complementary angle: "We're solving the [different part of the workflow] problem that [Company X] doesn't address."
+3. Cold email or LinkedIn works. Warm intro from a mutual connection in the portfolio company works best.
+
+**What to avoid:** Do not say "just like [portfolio company] but better." This forces the investor to choose between two bets and they will default to protecting the existing one.
+
+---
+
+### Archetype 3: Operator-Turned-Investor
+
+Former founders or operators who moved into investing. Typically reachable via warm intro from their portfolio company founders.
+
+**How to approach:**
+1. Find a founder in their portfolio via LinkedIn or the fund's website
+2. Get a warm intro from that founder: "I'm building in the same space you were in at [company] -- would you be willing to introduce me to [investor name]?"
+3. Operator-investors respond to founder-to-founder intros at 3-5x the rate of cold outreach
+
+**What to avoid:** Cold email works less well with this archetype. They deal-select heavily from their personal networks. Do not skip the warm path attempt.
+
+---
+
+### Archetype 4: Multi-Stage Generalists with Sector Coverage
+
+Large funds with dedicated sector teams. Partners focus on different verticals. Do not email the wrong person.
+
+**How to approach:**
+1. Identify the specific partner who covers your sector from the fund website or LinkedIn. Look for their recent investments in your space.
+2. Email the sector partner, not the managing partner or the fund's general inbox.
+3. If you cannot identify the right partner, email a principal or associate first and ask who covers your space. They are more responsive and will route you correctly.
+
+**What to avoid:** Do not cold email a managing partner at a large fund with no warm intro. Response rates are near zero. The sector partner path is 10x more effective.
+
+---
+
+### Archetype 5: Scout Program Participants
+
+Many top-tier funds (a16z, First Round, Bessemer, etc.) run scout programs -- operators, founders, and angels who refer deals in exchange for carry. Scouts have much higher response rates than GPs at the same fund.
+
+**How to approach:**
+1. Find scouts on Twitter/X or LinkedIn (search "[fund name] scout")
+2. Scouts are often active founders themselves -- they respond well to peer-to-peer founder outreach
+3. A positive scout referral carries significant weight internally at the fund
+
+**What to avoid:** Do not treat a scout as a gatekeeper to avoid. A scout intro is often more valuable than a cold email to the GP.
+
+---
+
+## Cold Email vs Warm Intro
+
+| Method | Typical Response Rate | When to Use |
+|---|---|---|
+| Cold email (generic) | 1-3% | Only if no warm path exists |
+| Cold email (thesis-referenced) | 8-15% | Track B investors who published their thesis |
+| Cold email (portfolio-referenced) | 5-10% | Track A investors with named portfolio evidence |
+| Warm intro from portfolio founder | 30-50% | Always attempt first for Archetype 3 and 4 |
+| Warm intro from mutual angel/advisor | 20-35% | Use your existing cap table to find bridge connections |
+
+The warm intro advantage is real. Before sending a cold email to a Track A or Track B investor, spend 10 minutes on LinkedIn finding a second-degree connection through their portfolio companies. One warm intro is worth 10 cold emails.
+
+---
+
+## Application-Form Funds
+
+Some funds operate structured intake processes. These require filling out a form, not cold emailing.
+
+| Fund Type | How to Engage |
+|---|---|
+| YC | Apply during batch cycle at ycombinator.com/apply |
+| First Round Capital | Submit via firstround.com/funding |
+| Andreessen Horowitz | Public application at a16z.com -- reference their exact investment criteria from their published content |
+| Sequoia | Warm intro strongly preferred; Arc program for early stage |
+| Techstars | Apply to accelerator program for access to their network |
+
+For application-form funds: use the exact language from their published investment criteria in your application. They score applications against stated criteria. Generic applications score low regardless of product quality.
+
+---
+
+## Outreach Message Structure
+
+For cold email (any archetype):
+
+```
+Subject: [Specific signal reference, under 8 words]
+
+[Sentence about THEM -- their portfolio company, their thesis, their recent investment]
+
+[One sentence about what you build and who it is for]
+
+[One specific data point: metric, customer, or signal]
+
+[One-line ask: 20-minute call, or specific question]
+
+[Name]
+```
+
+Hard limits:
+- Email body: under 100 words
+- Subject line: under 8 words
+- No attachments in first message
+- No pitch deck link in first message (send on request only)
+- No "I hope this finds you well" or "I wanted to reach out"
+
+---
+
+## Red Flags to Check Before Outreach
+
+Before emailing any VC from the output list, check:
+
+1. **Recent fund vintage:** A fund that raised in 2019 and has not announced a new fund is likely deployed and not writing new checks. Check Crunchbase or their website for their most recent fund announcement.
+
+2. **Portfolio company failure in your space:** If a VC backed a direct competitor that failed, they may be reluctant to re-invest in the same category. Frame your differentiation clearly.
+
+3. **Check size mismatch:** If the VC's minimum check is $5M and you are raising a $1M seed, the round economics do not work. Do not waste either side's time.
+
+4. **Geography restriction:** Some funds explicitly invest only in US companies or only in European companies. Check their website before outreach.