inbox-miner

Extracts company and product signals from allowlisted Gmail senders into a Supabase market-intelligence graph.

1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/AlexYedi/Empire_State_Events_Pipeline_Take_3 --skill inbox-miner-alexyedi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: inbox-miner
Source: https://github.com/AlexYedi/Empire_State_Events_Pipeline_Take_3/tree/main/.claude/skills/inbox-miner
Command: npx skills add https://github.com/AlexYedi/Empire_State_Events_Pipeline_Take_3 --skill inbox-miner-alexyedi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Valuable market intelligence — product launches, funding rounds, and executive moves — arrives in Gmail but decays unstructured among promotional noise, and reading every email body exposes private content. This Skill separates cheap metadata-only sender discovery from allowlist-only body extraction so only proven signal senders are ever read. ## Core Features & Use Cases - Two-stage scanning: Stage A runs a metadata-only whole-inbox discovery pass that produces sender worksheets (allowlist candidates, unsubscribe candidates, suspected spam); Stage B reads bodies only from the approved allowlist. - Structured signal extraction: A distill subagent converts email text into schema-validated company signals (launch, funding, market, exec_move) with canonical URLs, provenance, and confidence scores, with sponsor-section stripping and stub-newsletter fallback handling. - Human-gated writes: Signals are deduplicated by canonical URL across newsletters, resolved against a company alias map, and written to Supabase and Notion only after explicit per-batch approval. - Use Case: Run a weekly scan to turn newsletters like Techpresso into structured events — e.g., "Mistral raised funding" — deduplicated across four citing newsletters and appended to the company's Notion Recent Developments. ## Quick Start Run the inbox-miner skill in discover mode to scan the last 12 months of Gmail metadata and present sender worksheets for my approval.

Frequently Asked Questions about inbox-miner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract market intelligence signals from Gmail newsletters?

Run the extraction stage, which reads bodies only from allowlisted senders and uses a distill subagent to emit schema-validated signals with company name, kind, canonical URL, and provenance. Each signal is deduplicated by resolved canonical URL and presented at a write gate before anything is stored.

How does the skill avoid reading private email content?

Stage A discovery uses metadata only — sender, subject, labels — and never calls get_thread. Stage B reads bodies exclusively from an approved allowlist, scoped to Gmail's promotions, updates, and forums categories so Primary personal mail is excluded by design.

How are duplicate events across multiple newsletters handled?

Signals are deduplicated by the redirect-resolved canonical URL rather than by company, kind, and date. Within a run, all signals citing the same URL are merged into one event carrying all citing newsletters in metadata.sources, then checked against prior events in Supabase.

Does the skill write to the database automatically?

No. Every write to Supabase or Notion requires explicit approval at a resolved-target write gate showing exactly which company rows will be matched or created. The gate is permanent, and a missing SUPABASE_API_KEY causes a hard fail with nothing written or labeled.

What happens when a newsletter body is just a stub or teaser?

If the plaintext body is under roughly 800 characters or matches stub patterns, the skill falls back to parsing the subject line, then resolving the primary link including base64-encoded click paths, and finally fetching the view-online archive URL. Stub-sourced signals are flagged with lowered confidence.

What are the limitations of email-based signal extraction?

Email lacks strong natural keys, so deduplication is weaker than ATS or calendar-keyed sources and relies on the canonical-URL gate plus human review. The skill also cannot route event, job, or offer classes in v1 — those are only labeled for later phases.