deal-sourcing-agent — Claude Code skill: startup discovery pipeline
deal-sourcing-agent guides discovery of consumer startups across public data sources, filters by investment thesis, and exports to Notion.
MIT 1 installs updated 2026-10-16
npx skills add nikhillinit/SweetSwwetHarmony --skill deal-sourcing-agent -a claude-codeWhat deal-sourcing-agent does
This skill translates Discovery Engine scripts into a guided terminal workflow. It steps through six distinct phases: configuring sources, collecting data, scoring against an investment thesis, inspecting leads, pushing entries to Notion, and inspecting system health.
The engine executes run_pipeline.py using system tools. It offers predefined collector presets: the fast scan parses GitHub, SEC EDGAR, and UK Companies House in roughly 2 minutes, while the full run checks 16 collectors in about 10 minutes. Screened prospects receive confidence scores between 0.0 and 1.0.
Without a valid GITHUB_TOKEN set inside your .env file, the GitHub collector fails immediately on authentication checks.
What it helps with
- gather early company signals from SEC filings, GitHub activity, and registry records
- filter incoming leads using consumer sector criteria and thesis rules
- sync scored venture prospects directly into a Notion CRM database
Example prompts for the agent
- Help me find new deals in health tech
- Run the discovery pipeline using the fast preset
- Check for new SEC filings and push qualified prospects to Notion
How to install deal-sourcing-agent
1Skills CLI (Vercel)
npx skills add nikhillinit/SweetSwwetHarmony --skill deal-sourcing-agent -a claude-code2Manually: put the files in place
~/.claude/skills/deal-sourcing-agent/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/deal-sourcing-agent/
1Skills CLI (Vercel)
npx skills add nikhillinit/SweetSwwetHarmony --skill deal-sourcing-agent -a codex2Manually: put the files in place
.agents/skills/deal-sourcing-agent/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add nikhillinit/SweetSwwetHarmony --skill deal-sourcing-agent -a cursor2Manually: put the files in place
.cursor/skills/deal-sourcing-agent/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install nikhillinit/SweetSwwetHarmony .claude/skills/deal-sourcing-agent2Manually: put the files in place
.github/skills/deal-sourcing-agent/SKILL.md1Skills CLI (Vercel)
npx skills add nikhillinit/SweetSwwetHarmony --skill deal-sourcing-agent -a gemini-cli2Platform CLI
gemini skills install https://github.com/nikhillinit/SweetSwwetHarmony --path .claude/skills/deal-sourcing-agentManually: put the files in place
.devin/skills/deal-sourcing-agent/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add nikhillinit/SweetSwwetHarmony --skill deal-sourcing-agent -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about deal-sourcing-agent
How to install deal-sourcing-agent in Claude Code?
Run npx skills add nikhillinit/SweetSwwetHarmony --skill deal-sourcing-agent -a claude-code in your terminal.
What does deal-sourcing-agent do?
It coordinates a multi-stage startup sourcing workflow: gathering signals from public registries, screening companies, and syncing qualified prospects to Notion.
What credentials are required to run the pipeline?
You need API keys for specific collectors, such as GITHUB_TOKEN in your .env file for repository activity tracking.
Source text
SKILL.md · MIT
--- name: deal-sourcing-agent description: Run the Discovery Engine pipeline to find new consumer companies. Use when the user asks to "find deals", "source companies", "run the pipeline", "discover startups", or "search for prospects" in CPG, health tech, travel, or marketplaces. allowed-tools: - Bash - Read license: MIT metadata: version: 1.0.0 category: workflow-automation author: Press On Ventures --- # Deal Sourcing Agent Transform CLI-based discovery into a guided, conversational workflow for sourcing consumer companies. ## When to Use This Skill This skill activates when you want to: - Find new investment prospects - Run the discovery pipeline - Source companies in specific sectors (CPG, health tech, travel, marketplaces) - Review and push qualified signals to Notion CRM **Trigger phrases:** - "Help me find new deals" - "Run the discovery pipeline" - "Source companies in [sector]" - "What new prospects do we have*" - "Check for new SEC filings" ## Quick Start **Simplest invocation:** ``` User: "Find me some new deals" ``` The skill will guide you through 6 steps: Configuration → Collection → Processing → Review → Push → Health Check. ## Workflow ### Step 1: Configuration Ask which collectors to run and which sectors to focus on. **Collector Presets:** | Preset | Collectors | Duration | Best For | |--------|-----------|----------|----------| | Fast | github, sec_edgar, companies_house | ~2 min | Quick daily scan | | All | 16 collectors | ~10 min | Comprehensive weekly search | | Custom | User selects | Varies | Specific signal types | **Validation Gate:** User confirms configuration before proceeding. ### Step 2: Collection Execute collectors and report results. ```bash python run_pipeline.py collect --collectors <preset> ``` **Output:** Signals collected, duplicates found, collector status (✓/✗) **Decision Point:** - A) Proceed to processing - B) Adjust collectors - C) Cancel ### Step 3: Processing Run verification gate and thesis filter on collected signals. ```bash python run_pipeline.py process ``` **Output:** - Qualified signals (ready for push) - Held signals (need review) - Rejected signals (excluded by thesis) **Decision Point:** - A) Review qualified signals - B) Push all qualified to Notion - C) Review held signals - D) Show metrics ### Step 4: Review (Optional) Display top qualified signals with confidence scores. ```bash python run_pipeline.py pipeline qualified --limit 20 ``` **Output:** Table with company name, canonical key, confidence, signal types, why now. **Decision Point:** - A) Push all to Notion - B) Filter further - C) Exclude specific companies ### Step 5: Push to Notion Sync qualified signals to Notion CRM. ```bash # Dry run preview python run_pipeline.py pipeline push --dry-run # Actual push (after confirmation) python run_pipeline.py pipeline push --confirm ``` **Output:** - Prospects created (Status: "Source" or "Tracking") - Prospects updated - Prospects skipped (duplicates) - Notion URLs ### Step 6: Health Check Run post-execution diagnostics and recommend next steps. ```bash python run_pipeline.py health --json ``` **Output:** - Component health (Database, APIs, cache) - Anomaly detection results - Rate limit status - Recommendations (review held signals, schedule next run) ## Collector Guide See [references/collector-guide.md](references/collector-guide.md) for complete list of 16 collectors, API requirements, and signal strengths. **Fast Preset Collectors:** - **github** - Trending repos, spike detection (0.5-0.7 confidence) - **sec_edgar** - SEC Form D filings (0.6-0.8 confidence) - **companies_house** - UK incorporations (0.6-0.8 confidence) ## Error Handling ### Missing API Keys If a collector fails due to missing credentials: ``` ⚠ Missing API Key: GITHUB_TOKEN Setup: 1. Generate token at: https://github.com/settings/tokens 2. Add to .env file: GITHUB_TOKEN=ghp_xxx 3. Restart skill Alternative: Run other collectors without GitHub ``` ### Rate Limits If rate limited: ``` ⚠ GitHub Rate Limit Exceeded Resets at: 2026-01-31 14:30 UTC (in 42 minutes) Options: A) Wait 42 minutes, then retry B) Run other collectors C) Use authenticated token (increases limit) ``` ### Zero Qualified Signals If no signals pass verification: ``` ℹ No Qualified Signals Results: 0 qualified, 12 held, 3 rejected Next Steps: A) Review held signals B) Adjust thesis filters C) Run different collectors ``` For complete troubleshooting guide, see [references/troubleshooting.md](references/troubleshooting.md). ## Notion Schema The pipeline pushes to Notion with these fields: - **Status:** "Source" (multi-source, high confidence) or "Tracking" (single source) - **Discovery ID:** Unique identifier for tracking - **Canonical Key:** Deduplication key (domain:example.com) - **Confidence Score:** 0.0-1.0 routing score - **Signal Types:** Multi-select (github, sec_edgar, etc.) - **Why Now:** Narrative explaining timing See [references/notion-schema.md](references/notion-schema.md) for complete schema and routing logic. ## Examples ### Basic Usage [See examples/basic-usage.md](examples/basic-usage.md) User: "Find me some new deals" → Guided through Fast preset (2 min) → 12 qualified signals pushed to Notion ### Sector-Specific [See examples/sector-specific.md](examples/sector-specific.md) User: "Source consumer CPG companies" → Collectors filtered by CPG keywords → Thesis filter emphasizes food/beverage/beauty ### Advanced Options [See examples/advanced-options.md](examples/advanced-options.md) - Run single collector - Dry-run mode for testing - View detailed metrics - Import from CSV ## Common Scenarios | Scenario | Command Flow | |----------|--------------| | Daily quick scan | Fast preset → Process → Push | | Weekly deep dive | All preset → Review held → Push selected | | Sector focus | Custom collectors → Filter by keywords | | Debug low signals | Metrics → Health → Adjust collectors | ## Related Skills - **thesis_matching.md** - Investment thesis evaluation criteria - **founder_evaluation.md** - Founder intelligence assessment - **signal_quality.md** - Quality tiers and freshness scoring ## Technical Details For pipeline architecture, stage-by-stage flow, and `PipelineStats` schema, see [references/pipeline-architecture.md](references/pipeline-architecture.md). ## Success Criteria **You'll know this skill is working when:** - Time to first qualified signal < 3 minutes - You complete workflow without errors - Qualified signals appear in Notion CRM - You understand what was found and why **Metrics:** - Typical batch: 5-20 qualified signals - Collector success rate: >85% - False positive rate: <15%
© Press On Ventures · MIT · nikhillinit/SweetSwwetHarmony