lead-intelligence
affaan-m/ECC
Identifica, evalúa y llega a contactos de gran valor mediante el análisis de grafos sociales y la detección de rutas de contacto, generando borradores personalizados para enviar mensajes por correo electrónico, LinkedIn y X.
...Expandir todoInteligencia de clientes potenciales
Proceso de gestión de oportunidades impulsado por agentes que identifica, puntúa y se pone en contacto con contactos de alto valor mediante el análisis de redes sociales y la detección de vías de contacto ya establecidas.
Cuándo activarla
- El usuario desea encontrar clientes potenciales o prospectos en un sector específico
- Se está elaborando una lista de contactos para colaboraciones, ventas o recaudación de fondos
- Se está investigando a quién dirigirse y cuál es la mejor vía para llegar a ellos
- El usuario dice «encontrar clientes potenciales», «lista de contactos», «a quién debo dirigirme», «presentaciones directas»
- Necesita puntuar o clasificar una lista de contactos según su relevancia
- Quiere identificar conexiones mutuas para encontrar vías de presentación favorable
Requisitos de la herramienta
Requisitos
- Exa MCP: búsqueda en la deep web de personas, empresas y señales (
web_search_exa) - X API — Gráfico de seguidores/seguidos, análisis de conexiones mutuas, actividad reciente (
X_BEARER_TOKEN, además de credenciales de contexto de escritura comoX_CONSUMER_KEY,X_CONSUMER_SECRET,X_ACCESS_TOKEN,X_ACCESS_TOKEN_SECRET)
Opcional (para mejorar los resultados)
- LinkedIn — API directa si está disponible; de lo contrario, control del navegador para la búsqueda, la inspección de perfiles y la redacción
- API de Apollo/Clay: para el enriquecimiento de referencias cruzadas si el usuario tiene acceso
- GitHub MCP — Para la calificación de clientes potenciales centrada en los desarrolladores
- Apple Mail / Mail.app: redactar correos electrónicos «en frío» o «en caliente» sin enviarlos automáticamente
- Control del navegador — Para LinkedIn y X cuando la cobertura de la API no existe o es limitada
Resumen del proceso de ventas
┌─────────────┐ ┌──────────────┐ ┌─────────────────┐ ┌──────────────┐ ┌─────────────────┐
│ 1. Signal │────>│ 2. Mutual │────>│ 3. Warm Path │────>│ 4. Enrich │────>│ 5. Outreach │
│ Scoring │ │ Ranking │ │ Discovery │ │ │ │ Draft │
└─────────────┘ └──────────────┘ └─────────────────┘ └──────────────┘ └─────────────────┘
Llamada de voz antes del contacto
No redactes mensajes salientes a partir de plantillas de ventas genéricas.
Lánzalo brand-voice primero siempre que la voz del usuario sea importante. Reutiliza su VOICE PROFILE en lugar de volver a crear un estilo ad hoc dentro de esta habilidad.
Si hay acceso a X en tiempo real, recupera las publicaciones originales recientes antes de redactar. Si no es así, utiliza los ejemplos proporcionados o el mejor material disponible en el repositorio o el sitio web.
Fase 1: Puntuación de señales
Busca personas con una señal alta en los sectores objetivo. Asigna una ponderación a cada una en función de:
| Señal | Ponderación | Fuente |
|---|---|---|
| Alineación de función/cargo | 30 % | Exa, LinkedIn |
| Concordancia con el sector | 25 % | Búsqueda de empresas en Exa |
| Actividad reciente sobre el tema | 20 % | Búsqueda en la API de X, Exa |
| Número de seguidores / influencia | 10 % | API X |
| Proximidad geográfica | 10 % | Exa, LinkedIn |
| Interacción con tu contenido | 5 % | Interacciones con la API X |
Enfoque de búsqueda de señales
# Step 1: Define target parameters
target_verticals = ["prediction markets", "AI tooling", "developer tools"]
target_roles = ["founder", "CEO", "CTO", "VP Engineering", "investor", "partner"]
target_locations = ["San Francisco", "New York", "London", "remote"]
# Step 2: Exa deep search for people
for vertical in target_verticals:
results = web_search_exa(
query=f"{vertical} {role} founder CEO",
category="company",
numResults=20
)
# Score each result
# Step 3: X API search for active voices
x_search = search_recent_tweets(
query="prediction markets OR AI tooling OR developer tools",
max_results=100
)
# Extract and score unique authors
Etapa 2: Clasificación mutua
Para cada objetivo puntuado, se analiza el grafo social del usuario para encontrar la ruta más cercana.
Modelo de clasificación
- Recopilar la lista de seguidores X del usuario y sus contactos de LinkedIn
- Para cada objetivo con señal alta, comprueba si hay conexiones compartidas
- Aplica el
social-graph-rankermodelo para puntuar el valor de puente - Clasifica a los contactos mutuos según:
| Factor | Ponderación |
|---|---|
| Número de conexiones con los objetivos | 40 % — mayor ponderación: cuantas más conexiones, mayor clasificación |
| Cargo actual o empresa de la persona con la que se tiene relación | 20 % — responsable de la toma de decisiones frente a colaborador individual |
| Ubicación de la persona con la que se establece contacto | 15 % — misma ciudad = presentación más fácil |
| Alineación sectorial | 15 % — mismo sector = presentación natural |
| Cuenta de X / LinkedIn de la otra persona | 10 % — facilidad para identificar a la persona a la hora de contactar |
Regla canónica:
Use social-graph-ranker when the user wants the graph math itself,
the bridge ranking as a standalone report, or explicit decay-model tuning.
Dentro de esta habilidad, utiliza el mismo modelo de puente ponderado:
B(m) = Σ_{t ∈ T} w(t) · λ^(d(m,t) - 1)
R(m) = B_ext(m) · (1 + β · engagement(m))
Interpretación:
- Nivel 1: alto
R(m)y rutas de puente directas → solicitudes de presentación «cálida» - Nivel 2: rutas de puente medias
R(m)y rutas de puente de un salto -> solicitudes de contacto condicionales - Nivel 3: sin puente viable -> contacto directo en frío utilizando el mismo registro de cliente potencial
Formato de salida
If the user explicitly wants the ranking engine broken out, the math visualized, or the network scored outside the full lead workflow, run `social-graph-ranker` as a standalone pass first and feed the result back into this pipeline.
MUTUAL RANKING REPORT
=====================
#1 @mutual_handle (Score: 92)
Name: Jane Smith
Role: Partner @ Acme Ventures
Location: San Francisco
Connections to targets: 7
Connected to: @target1, @target2, @target3, @target4, @target5, @target6, @target7
Best intro path: Jane invested in Target1's company
#2 @mutual_handle2 (Score: 85)
...
Etapa 3: Descubrimiento de rutas «cálidas»
Para cada objetivo, busca la cadena de presentación más corta:
You ──[follows]──> Mutual A ──[invested in]──> Target Company
You ──[follows]──> Mutual B ──[co-founded with]──> Target Person
You ──[met at]──> Event ──[also attended]──> Target Person
Tipos de rutas (ordenadas por grado de cercanía)
- Mutualidad directa: ambos seguís o conocéis a la misma persona
- Conexión de cartera: ambos han invertido en la empresa del objetivo o asesoran a esta
- Compañero de trabajo/antiguo alumno: ambos han trabajado en la misma empresa o han estudiado en la misma universidad
- Coincidencia en eventos: ambos asistieron a la misma conferencia o programa
- Interacción con el contenido: el objetivo ha interactuado con el contenido del contacto en común o viceversa
Etapa 4: Enriquecimiento
Para cada cliente potencial cualificado, recopila:
- Nombre completo, cargo actual, empresa
- Tamaño de la empresa, fase de financiación, noticias recientes
- Últimas X publicaciones (últimos 30 días): temas, tono, intereses
- Intereses comunes con el usuario (personas a las que ambos siguen, contenido similar)
- Eventos recientes de la empresa (lanzamiento de productos, ronda de financiación, contratación)
Fuentes de enriquecimiento
- Ejemplo: datos de la empresa, noticias, entradas de blog
- API de X: tuits recientes, biografía, seguidores
- GitHub: contribuciones a proyectos de código abierto (para clientes potenciales del ámbito del desarrollo)
- LinkedIn (a través del navegador): perfil completo, experiencia, formación
Etapa 5: Borrador de contacto
Genera un mensaje de contacto personalizado para cada cliente potencial. El borrador debe ajustarse al perfil de voz derivado de la fuente y al canal de destino.
Normas del canal
Correo electrónico
- Utilízalo para los mensajes de contacto en frío de mayor valor, las presentaciones en caliente, el contacto con inversores y las solicitudes de colaboración
- Por defecto, redactar en Apple Mail / Mail.app cuando se disponga de control local en el escritorio
- Crea primero los borradores; no los envíes automáticamente a menos que el usuario lo solicite explícitamente
- El asunto debe ser sencillo y específico, no ingenioso
- Utilízalo cuando el destinatario esté activo en esa plataforma, cuando el contexto de contactos mutuos sea más sólido en LinkedIn o cuando la confianza en el correo electrónico sea baja
- Prefiere el acceso a la API si está disponible
- De lo contrario, utiliza el control del navegador para examinar perfiles, la actividad reciente y redactar el mensaje
- Que sea más breve que un correo electrónico y evita la cordialidad profesional fingida
X
- Úsalo para contactar con operadores, emprendedores o inversores en entornos de alto contexto, donde el comportamiento en las publicaciones públicas es relevante
- Prefiere el acceso a la API para la búsqueda, la cronología y el análisis de interacción
- Recurre al control del navegador cuando sea necesario
- Los mensajes directos y las respuestas públicas deben ser mucho más concisos que los correos electrónicos y deben hacer referencia a algo real de la cronología del destinatario
Heurística de selección de canales
Elige un canal principal siguiendo este orden:
- presentación informal por correo electrónico
- correo electrónico directo
- mensaje directo en LinkedIn
- mensaje directo en X o respuesta
Utiliza el enfoque multicanal solo cuando haya una razón de peso y la frecuencia no dé la sensación de ser spam.
Solicitud de presentación cordial (a un contacto mutuo)
Objetivo:
- una petición clara
- una razón concreta por la que esta presentación tiene sentido
- un texto breve y fácil de reenviar, si es necesario
Evita:
- dar demasiadas explicaciones sobre tu empresa
- acumular pruebas sociales
- que suene como una plantilla para recaudar fondos
Contacto directo en frío (dirigido a un público objetivo)
Objetivo:
- empezar con algo concreto y reciente
- explicar por qué la conexión es real
- Hacer una petición sin complicaciones
Evitar:
- la admiración genérica
- enumerar características
- peticiones generales como «me encantaría conectar contigo»
- preguntas retóricas forzadas
Patrón de ejecución
Para cada destinatario, crea:
- el canal recomendado
- la razón por la que ese canal es el más adecuado
- el borrador del mensaje
- un borrador de seguimiento opcional
- si se elige el correo electrónico como canal y se dispone de Apple Mail, crear un borrador en lugar de limitarse a enviar el texto
Si se dispone de control del navegador:
- LinkedIn: revisa el perfil de destino, la actividad reciente y el contexto mutuo; a continuación, redacta o prepara el mensaje
- X: revisa las publicaciones o respuestas recientes y, a continuación, redacta el mensaje directo o la respuesta pública
Si se dispone de automatización en el escritorio:
- Apple Mail: crea un borrador de correo electrónico con asunto, cuerpo y destinatario.
No envíes mensajes automáticamente sin la aprobación explícita del usuario.
Antipatrones
- plantillas genéricas sin personalización
- Párrafos largos en los que se explique toda la empresa
- varias peticiones en un mismo mensaje
- Falsa familiaridad sin detalles concretos
- Mensajes enviados en masa con campos de fusión visibles
- textos idénticos reutilizados para el correo electrónico, LinkedIn y X
- un texto genérico propio de la plataforma en lugar de la voz real del autor
Configuración
Los usuarios deben configurar estas variables de entorno:
# Required
export X_BEARER_TOKEN="..."
export X_ACCESS_TOKEN="..."
export X_ACCESS_TOKEN_SECRET="..."
export X_CONSUMER_KEY="..."
export X_CONSUMER_SECRET="..."
export EXA_API_KEY="..."
# Optional
export LINKEDIN_COOKIE="..." # For browser-use LinkedIn access
export APOLLO_API_KEY="..." # For Apollo enrichment
Agentes
Esta skill incluye agentes especializados en el agents/ subdirectorio:
- signal-scorer: busca y clasifica a los clientes potenciales según señales de relevancia
- mutual-mapper: traza las conexiones del grafo social y encuentra rutas prometedoras
- enrichment-agent: extrae datos detallados sobre el perfil y la empresa
- outreach-drafter: genera mensajes personalizados
Ejemplo de uso
User: find me the top 20 people in prediction markets I should reach out to
Agent workflow:
1. signal-scorer searches Exa and X for prediction market leaders
2. mutual-mapper checks user's X graph for shared connections
3. enrichment-agent pulls company data and recent activity
4. outreach-drafter generates personalized messages for top ranked leads
Output: Ranked list with warm paths, voice profile summary, and channel-specific outreach drafts or drafts-in-app
Habilidades relacionadas
brand-voicepara la captura de voz canónicaconnections-optimizerpara la poda y expansión de la red, con revisión previa, antes de la captación
---
name: lead-intelligence
description: Finds, scores, and reaches high-value contacts through social graph analysis and warm path discovery, generating personalized outreach drafts for email, LinkedIn, and X.
---
# Lead Intelligence
Agent-powered lead intelligence pipeline that finds, scores, and reaches high-value contacts through social graph analysis and warm path discovery.
## When to Activate
- User wants to find leads or prospects in a specific industry
- Building an outreach list for partnerships, sales, or fundraising
- Researching who to reach out to and the best path to reach them
- User says "find leads", "outreach list", "who should I reach out to", "warm intros"
- Needs to score or rank a list of contacts by relevance
- Wants to map mutual connections to find warm introduction paths
## Tool Requirements
### Required
- **Exa MCP** — Deep web search for people, companies, and signals (`web_search_exa`)
- **X API** — Follower/following graph, mutual analysis, recent activity (`X_BEARER_TOKEN`, plus write-context credentials such as `X_CONSUMER_KEY`, `X_CONSUMER_SECRET`, `X_ACCESS_TOKEN`, `X_ACCESS_TOKEN_SECRET`)
### Optional (enhance results)
- **LinkedIn** — Direct API if available, otherwise browser control for search, profile inspection, and drafting
- **Apollo/Clay API** — For enrichment cross-reference if user has access
- **GitHub MCP** — For developer-centric lead qualification
- **Apple Mail / Mail.app** — Draft cold or warm email without sending automatically
- **Browser control** — For LinkedIn and X when API coverage is missing or constrained
## Pipeline Overview
```
┌─────────────┐ ┌──────────────┐ ┌─────────────────┐ ┌──────────────┐ ┌─────────────────┐
│ 1. Signal │────>│ 2. Mutual │────>│ 3. Warm Path │────>│ 4. Enrich │────>│ 5. Outreach │
│ Scoring │ │ Ranking │ │ Discovery │ │ │ │ Draft │
└─────────────┘ └──────────────┘ └─────────────────┘ └──────────────┘ └─────────────────┘
```
## Voice Before Outreach
Do not draft outbound from generic sales copy.
Run `brand-voice` first whenever the user's voice matters. Reuse its `VOICE PROFILE` instead of re-deriving style ad hoc inside this skill.
If live X access is available, pull recent original posts before drafting. If not, use supplied examples or the best repo/site material available.
## Stage 1: Signal Scoring
Search for high-signal people in target verticals. Assign a weight to each based on:
| Signal | Weight | Source |
|--------|--------|--------|
| Role/title alignment | 30% | Exa, LinkedIn |
| Industry match | 25% | Exa company search |
| Recent activity on topic | 20% | X API search, Exa |
| Follower count / influence | 10% | X API |
| Location proximity | 10% | Exa, LinkedIn |
| Engagement with your content | 5% | X API interactions |
### Signal Search Approach
```python
# Step 1: Define target parameters
target_verticals = ["prediction markets", "AI tooling", "developer tools"]
target_roles = ["founder", "CEO", "CTO", "VP Engineering", "investor", "partner"]
target_locations = ["San Francisco", "New York", "London", "remote"]
# Step 2: Exa deep search for people
for vertical in target_verticals:
results = web_search_exa(
query=f"{vertical} {role} founder CEO",
category="company",
numResults=20
)
# Score each result
# Step 3: X API search for active voices
x_search = search_recent_tweets(
query="prediction markets OR AI tooling OR developer tools",
max_results=100
)
# Extract and score unique authors
```
## Stage 2: Mutual Ranking
For each scored target, analyze the user's social graph to find the warmest path.
### Ranking Model
1. Pull user's X following list and LinkedIn connections
2. For each high-signal target, check for shared connections
3. Apply the `social-graph-ranker` model to score bridge value
4. Rank mutuals by:
| Factor | Weight |
|--------|--------|
| Number of connections to targets | 40% — highest weight, most connections = highest rank |
| Mutual's current role/company | 20% — decision maker vs individual contributor |
| Mutual's location | 15% — same city = easier intro |
| Industry alignment | 15% — same vertical = natural intro |
| Mutual's X handle / LinkedIn | 10% — identifiability for outreach |
Canonical rule:
```text
Use social-graph-ranker when the user wants the graph math itself,
the bridge ranking as a standalone report, or explicit decay-model tuning.
```
Inside this skill, use the same weighted bridge model:
```text
B(m) = Σ_{t ∈ T} w(t) · λ^(d(m,t) - 1)
R(m) = B_ext(m) · (1 + β · engagement(m))
```
Interpretation:
- Tier 1: high `R(m)` and direct bridge paths -> warm intro asks
- Tier 2: medium `R(m)` and one-hop bridge paths -> conditional intro asks
- Tier 3: no viable bridge -> direct cold outreach using the same lead record
### Output Format
```
If the user explicitly wants the ranking engine broken out, the math visualized, or the network scored outside the full lead workflow, run `social-graph-ranker` as a standalone pass first and feed the result back into this pipeline.
MUTUAL RANKING REPORT
=====================
#1 @mutual_handle (Score: 92)
Name: Jane Smith
Role: Partner @ Acme Ventures
Location: San Francisco
Connections to targets: 7
Connected to: @target1, @target2, @target3, @target4, @target5, @target6, @target7
Best intro path: Jane invested in Target1's company
#2 @mutual_handle2 (Score: 85)
...
```
## Stage 3: Warm Path Discovery
For each target, find the shortest introduction chain:
```
You ──[follows]──> Mutual A ──[invested in]──> Target Company
You ──[follows]──> Mutual B ──[co-founded with]──> Target Person
You ──[met at]──> Event ──[also attended]──> Target Person
```
### Path Types (ordered by warmth)
1. **Direct mutual** — You both follow/know the same person
2. **Portfolio connection** — Mutual invested in or advises target's company
3. **Co-worker/alumni** — Mutual worked at same company or attended same school
4. **Event overlap** — Both attended same conference/program
5. **Content engagement** — Target engaged with mutual's content or vice versa
## Stage 4: Enrichment
For each qualified lead, pull:
- Full name, current title, company
- Company size, funding stage, recent news
- Recent X posts (last 30 days) — topics, tone, interests
- Mutual interests with user (shared follows, similar content)
- Recent company events (product launch, funding round, hiring)
### Enrichment Sources
- Exa: company data, news, blog posts
- X API: recent tweets, bio, followers
- GitHub: open source contributions (for developer-centric leads)
- LinkedIn (via browser-use): full profile, experience, education
## Stage 5: Outreach Draft
Generate personalized outreach for each lead. The draft should match the source-derived voice profile and the target channel.
### Channel Rules
#### Email
- Use for the highest-value cold outreach, warm intros, investor outreach, and partnership asks
- Default to drafting in Apple Mail / Mail.app when local desktop control is available
- Create drafts first, do not send automatically unless the user explicitly asks
- Subject line should be plain and specific, not clever
#### LinkedIn
- Use when the target is active there, when mutual graph context is stronger on LinkedIn, or when email confidence is low
- Prefer API access if available
- Otherwise use browser control to inspect profiles, recent activity, and draft the message
- Keep it shorter than email and avoid fake professional warmth
#### X
- Use for high-context operator, builder, or investor outreach where public posting behavior matters
- Prefer API access for search, timeline, and engagement analysis
- Fall back to browser control when needed
- DMs and public replies should be much tighter than email and should reference something real from the target's timeline
#### Channel Selection Heuristic
Pick one primary channel in this order:
1. warm intro by email
2. direct email
3. LinkedIn DM
4. X DM or reply
Use multi-channel only when there is a strong reason and the cadence will not feel spammy.
### Warm Intro Request (to mutual)
Goal:
- one clear ask
- one concrete reason this intro makes sense
- easy-to-forward blurb if needed
Avoid:
- overexplaining your company
- social-proof stacking
- sounding like a fundraiser template
### Direct Cold Outreach (to target)
Goal:
- open from something specific and recent
- explain why the fit is real
- make one low-friction ask
Avoid:
- generic admiration
- feature dumping
- broad asks like "would love to connect"
- forced rhetorical questions
### Execution Pattern
For each target, produce:
1. the recommended channel
2. the reason that channel is best
3. the message draft
4. optional follow-up draft
5. if email is the chosen channel and Apple Mail is available, create a draft instead of only returning text
If browser control is available:
- LinkedIn: inspect target profile, recent activity, and mutual context, then draft or prepare the message
- X: inspect recent posts or replies, then draft DM or public reply language
If desktop automation is available:
- Apple Mail: create draft email with subject, body, and recipient
Do not send messages automatically without explicit user approval.
### Anti-Patterns
- generic templates with no personalization
- long paragraphs explaining your whole company
- multiple asks in one message
- fake familiarity without specifics
- bulk-sent messages with visible merge fields
- identical copy reused for email, LinkedIn, and X
- platform-shaped slop instead of the author's actual voice
## Configuration
Users should set these environment variables:
```bash
# Required
export X_BEARER_TOKEN="..."
export X_ACCESS_TOKEN="..."
export X_ACCESS_TOKEN_SECRET="..."
export X_CONSUMER_KEY="..."
export X_CONSUMER_SECRET="..."
export EXA_API_KEY="..."
# Optional
export LINKEDIN_COOKIE="..." # For browser-use LinkedIn access
export APOLLO_API_KEY="..." # For Apollo enrichment
```
## Agents
This skill includes specialized agents in the `agents/` subdirectory:
- **signal-scorer** — Searches and ranks prospects by relevance signals
- **mutual-mapper** — Maps social graph connections and finds warm paths
- **enrichment-agent** — Pulls detailed profile and company data
- **outreach-drafter** — Generates personalized messages
## Example Usage
```
User: find me the top 20 people in prediction markets I should reach out to
Agent workflow:
1. signal-scorer searches Exa and X for prediction market leaders
2. mutual-mapper checks user's X graph for shared connections
3. enrichment-agent pulls company data and recent activity
4. outreach-drafter generates personalized messages for top ranked leads
Output: Ranked list with warm paths, voice profile summary, and channel-specific outreach drafts or drafts-in-app
```
## Related Skills
- `brand-voice` for canonical voice capture
- `connections-optimizer` for review-first network pruning and expansion before outreach
Todos los archivos
5 archivosInstalar lead-intelligence
Descarga y descomprime los archivos de habilidades en tu directorio .claude/skills/.
Descargar ZIPClona el repositorio y copia los archivos de la habilidad a tu proyecto.
git clone https://github.com/affaan-m/ECC/tree/main/skills/lead-intelligence # Copy SKILL.md to your .claude/skills/ directory
Copiar





Hogar
