theus-cli-linux-arm64 0.2.84

package/vendor/theus-arsenal/skills/integracion-jira/SKILL.md

@@ -0,0 +1,307 @@
+---
+name: integracion-jira
+description: Úsala al recuperar tickets de Jira, analizar requisitos, actualizar el estado de un ticket, añadir comentarios o transicionar issues. Proporciona patrones de la API de Jira vía MCP o llamadas REST directas.
+---
+
+# Integración con Jira
+
+Recupera, analiza y actualiza tickets de Jira directamente desde tu flujo de trabajo con el agente. Soporta dos enfoques: **basado en MCP** (recomendado) y **API REST directa**.
+
+## Cuándo usarla
+
+- Al obtener un ticket de Jira para entender los requisitos.
+- Al extraer criterios de aceptación testeables de un ticket.
+- Al añadir comentarios de progreso a un issue de Jira.
+- Al transicionar el estado de un ticket (Por hacer → En progreso → Hecho).
+- Al vincular merge requests o ramas a un issue de Jira.
+- Al buscar issues mediante consultas JQL.
+
+## Requisitos previos
+
+### Opción A: servidor MCP (recomendada)
+
+Instala el servidor MCP `mcp-atlassian`. Esto expone las herramientas de Jira directamente al agente.
+
+**Requisitos:**
+- Python 3.10+
+- `uvx` (de `uv`), instalado vía tu gestor de paquetes o la documentación oficial de instalación de `uv`
+
+**Añádelo a tu configuración MCP** (p. ej., `~/.theus.json` → `mcpServers`):
+
+```json
+{
+  "jira": {
+    "command": "uvx",
+    "args": ["mcp-atlassian==0.21.0"],
+    "env": {
+      "JIRA_URL": "https://TU_ORG.atlassian.net",
+      "JIRA_EMAIL": "tu.correo@ejemplo.com",
+      "JIRA_API_TOKEN": "tu-api-token"
+    },
+    "description": "Seguimiento de issues en Jira — buscar, crear, actualizar, comentar, transicionar"
+  }
+}
+```
+
+> **Seguridad:** nunca escribas secretos en el código. Prefiere definir `JIRA_URL`, `JIRA_EMAIL` y `JIRA_API_TOKEN` en el entorno del sistema (o en un gestor de secretos). Usa el bloque `env` del MCP solo para archivos de configuración locales no versionados.
+
+**Para obtener un API token de Jira:**
+1. Ve a <https://id.atlassian.com/manage-profile/security/api-tokens>
+2. Haz clic en **Create API token**
+3. Copia el token — guárdalo en tu entorno, nunca en el código fuente
+
+### Opción B: API REST directa
+
+Si MCP no está disponible, usa la API REST v3 de Jira directamente vía `curl` o un script auxiliar.
+
+**Variables de entorno requeridas:**
+
+| Variable | Descripción |
+|----------|-------------|
+| `JIRA_URL` | URL de tu instancia de Jira (p. ej., `https://tuorg.atlassian.net`) |
+| `JIRA_EMAIL` | Correo de tu cuenta de Atlassian |
+| `JIRA_API_TOKEN` | API token de id.atlassian.com |
+
+Guárdalas en el entorno del shell, en un gestor de secretos o en un archivo de entorno local no versionado. No las subas al repositorio.
+
+Para los ejemplos directos con `curl`, mantén las credenciales fuera de los argumentos de línea de comandos pasando la configuración de usuario de Jira por stdin:
+
+```bash
+jira_curl() {
+  printf 'user = "%s:%s"\n' "$JIRA_EMAIL" "$JIRA_API_TOKEN" |
+    curl -s -K - "$@"
+}
+```
+
+## Referencia de herramientas MCP
+
+Cuando el servidor MCP `mcp-atlassian` está configurado, estas herramientas quedan disponibles:
+
+| Herramienta | Propósito | Ejemplo |
+|------|---------|---------|
+| `jira_search` | Consultas JQL | `project = PROJ AND status = "In Progress"` |
+| `jira_get_issue` | Obtener el detalle completo de un issue por clave | `PROJ-1234` |
+| `jira_create_issue` | Crear issues (Task, Bug, Story, Epic) | Nuevo reporte de bug |
+| `jira_update_issue` | Actualizar campos (resumen, descripción, asignado) | Cambiar el asignado |
+| `jira_transition_issue` | Cambiar el estado | Mover a "In Review" |
+| `jira_add_comment` | Añadir comentarios | Actualización de progreso |
+| `jira_get_sprint_issues` | Listar los issues de un sprint | Revisión del sprint activo |
+| `jira_create_issue_link` | Vincular issues (Blocks, Relates to) | Seguimiento de dependencias |
+| `jira_get_issue_development_info` | Ver PRs, ramas y commits vinculados | Contexto de desarrollo |
+
+> **Consejo:** llama siempre a `jira_get_transitions` antes de transicionar — los IDs de transición varían según el workflow de cada proyecto.
+
+## Referencia de la API REST directa
+
+### Obtener un ticket
+
+```bash
+jira_curl \
+  -H "Content-Type: application/json" \
+  "$JIRA_URL/rest/api/3/issue/PROJ-1234" | jq '{
+    key: .key,
+    summary: .fields.summary,
+    status: .fields.status.name,
+    priority: .fields.priority.name,
+    type: .fields.issuetype.name,
+    assignee: .fields.assignee.displayName,
+    labels: .fields.labels,
+    description: .fields.description
+  }'
+```
+
+### Obtener comentarios
+
+```bash
+jira_curl \
+  -H "Content-Type: application/json" \
+  "$JIRA_URL/rest/api/3/issue/PROJ-1234?fields=comment" | jq '.fields.comment.comments[] | {
+    author: .author.displayName,
+    created: .created[:10],
+    body: .body
+  }'
+```
+
+### Añadir un comentario
+
+```bash
+jira_curl -X POST \
+  -H "Content-Type: application/json" \
+  -d '{
+    "body": {
+      "version": 1,
+      "type": "doc",
+      "content": [{
+        "type": "paragraph",
+        "content": [{"type": "text", "text": "Tu comentario aquí"}]
+      }]
+    }
+  }' \
+  "$JIRA_URL/rest/api/3/issue/PROJ-1234/comment"
+```
+
+### Transicionar un ticket
+
+```bash
+# 1. Obtener las transiciones disponibles
+jira_curl \
+  "$JIRA_URL/rest/api/3/issue/PROJ-1234/transitions" | jq '.transitions[] | {id, name: .name}'
+
+# 2. Ejecutar la transición (reemplaza TRANSITION_ID)
+jira_curl -X POST \
+  -H "Content-Type: application/json" \
+  -d '{"transition": {"id": "TRANSITION_ID"}}' \
+  "$JIRA_URL/rest/api/3/issue/PROJ-1234/transitions"
+```
+
+### Buscar con JQL
+
+```bash
+jira_curl -G \
+  --data-urlencode "jql=project = PROJ AND status = 'In Progress'" \
+  "$JIRA_URL/rest/api/3/search"
+```
+
+## Analizar un ticket
+
+Al recuperar un ticket para desarrollo o automatización de pruebas, extrae:
+
+### 1. Requisitos testeables
+- **Requisitos funcionales** — qué hace la funcionalidad
+- **Criterios de aceptación** — condiciones que deben cumplirse
+- **Comportamientos testeables** — acciones específicas y resultados esperados
+- **Roles de usuario** — quién usa esta funcionalidad y sus permisos
+- **Requisitos de datos** — qué datos se necesitan
+- **Puntos de integración** — APIs, servicios o sistemas involucrados
+
+### 2. Tipos de test necesarios
+- **Tests unitarios** — funciones y utilidades individuales
+- **Tests de integración** — endpoints de API e interacciones entre servicios
+- **Tests E2E** — flujos de UI de cara al usuario
+- **Tests de API** — contratos de endpoints y manejo de errores
+
+### 3. Casos límite y escenarios de error
+- Entradas inválidas (vacías, demasiado largas, caracteres especiales)
+- Accesos no autorizados
+- Fallos de red o timeouts
+- Usuarios concurrentes o condiciones de carrera
+- Condiciones de borde
+- Datos faltantes o nulos
+- Transiciones de estado (navegación hacia atrás, refresco, etc.)
+
+### 4. Salida de análisis estructurada
+
+```
+Ticket: PROJ-1234
+Resumen: [título del ticket]
+Estado: [estado actual]
+Prioridad: [Alta/Media/Baja]
+Tipos de test: unitarios, integración, E2E
+
+Requisitos:
+1. [requisito 1]
+2. [requisito 2]
+
+Criterios de aceptación:
+- [ ] [criterio 1]
+- [ ] [criterio 2]
+
+Escenarios de prueba:
+- Camino feliz: [descripción]
+- Caso de error: [descripción]
+- Caso límite: [descripción]
+
+Datos de prueba necesarios:
+- [dato 1]
+- [dato 2]
+
+Dependencias:
+- [dependencia 1]
+- [dependencia 2]
+```
+
+## Actualizar tickets
+
+### Cuándo actualizar
+
+| Paso del flujo | Actualización en Jira |
+|---|---|
+| Empezar el trabajo | Transicionar a "In Progress" |
+| Tests escritos | Comentario con resumen de cobertura |
+| Rama creada | Comentario con el nombre de la rama |
+| PR/MR creado | Comentario con el enlace, vincular el issue |
+| Tests en verde | Comentario con resumen de resultados |
+| PR/MR fusionado | Transicionar a "Done" o "In Review" |
+
+### Plantillas de comentarios
+
+**Inicio del trabajo:**
+```
+Empezando la implementación de este ticket.
+Rama: feat/PROJ-1234-nombre-funcionalidad
+```
+
+**Tests implementados:**
+```
+Tests automatizados implementados:
+
+Tests unitarios:
+- [archivo de test 1] — [qué cubre]
+- [archivo de test 2] — [qué cubre]
+
+Tests de integración:
+- [archivo de test] — [endpoints/flujos cubiertos]
+
+Todos los tests pasan en local. Cobertura: XX%
+```
+
+**PR creado:**
+```
+Pull request creado:
+[Título del PR](https://github.com/org/repo/pull/XXX)
+
+Listo para revisión.
+```
+
+**Trabajo completado:**
+```
+Implementación completa.
+
+PR fusionado: [enlace]
+Resultados de tests: todos en verde (X/Y)
+Cobertura: XX%
+```
+
+## Directrices de seguridad
+
+- **Nunca escribas** tokens de API de Jira en el código fuente ni en archivos de skills.
+- **Usa siempre** variables de entorno o un gestor de secretos.
+- **Añade `.env`** al `.gitignore` de cada proyecto.
+- **Rota los tokens** de inmediato si quedan expuestos en el historial de git.
+- **Usa tokens de mínimo privilegio**, acotados a los proyectos necesarios.
+- **Valida** que las credenciales estén definidas antes de llamar a la API — falla rápido con un mensaje claro.
+
+## Solución de problemas
+
+| Error | Causa | Solución |
+|---|---|---|
+| `401 Unauthorized` | Token de API inválido o expirado | Regenerar en id.atlassian.com |
+| `403 Forbidden` | El token no tiene permisos sobre el proyecto | Revisar los scopes del token y el acceso al proyecto |
+| `404 Not Found` | Clave de ticket o URL base incorrectas | Verificar `JIRA_URL` y la clave del ticket |
+| `spawn uvx ENOENT` | El entorno no encuentra `uvx` en el PATH | Usar la ruta completa (p. ej., `~/.local/bin/uvx`) o definir el PATH en `~/.zprofile` |
+| Timeout de conexión | Problema de red/VPN | Revisar la conexión VPN y las reglas del firewall |
+
+## Buenas prácticas
+
+- Actualiza Jira sobre la marcha, no todo de golpe al final.
+- Mantén los comentarios concisos pero informativos.
+- Enlaza en lugar de copiar — apunta a PRs, reportes de tests y dashboards.
+- Usa @menciones si necesitas la opinión de otras personas.
+- Revisa los issues vinculados para entender el alcance completo antes de empezar.
+- Si los criterios de aceptación son vagos, pide aclaraciones antes de escribir código.
+
+## Skills relacionadas
+
+- `flujo-tdd`
+- `operaciones-github`
+- `flujo-git`

package/vendor/theus-arsenal/skills/inteligencia-leads/SKILL.md

@@ -0,0 +1,312 @@
+---
+name: inteligencia-leads
+description: Pipeline agéntico de inteligencia de leads y outreach. Sustituye Apollo, Clay y ZoomInfo con puntuación de señales impulsada por agentes, ranking de contactos mutuos, descubrimiento de rutas cálidas, modelado de voz derivado de fuentes reales y outreach específico por canal en correo, LinkedIn y X. Úsala cuando el usuario quiera encontrar, calificar y contactar contactos de alto valor.
+---
+
+# Inteligencia de leads
+
+Pipeline de inteligencia de leads impulsado por agentes que encuentra, puntúa y contacta contactos de alto valor mediante análisis del grafo social y descubrimiento de rutas cálidas.
+
+## Cuándo activarla
+
+- El usuario quiere encontrar leads o prospectos en una industria concreta
+- Construir una lista de outreach para alianzas, ventas o levantamiento de capital
+- Investigar a quién contactar y la mejor ruta para llegar a esa persona
+- El usuario dice "encuéntrame leads", "lista de outreach", "¿a quién debería contactar?", "intros cálidas"
+- Necesita puntuar o rankear una lista de contactos por relevancia
+- Quiere mapear conexiones mutuas para encontrar rutas de presentación cálida
+
+## Requisitos de herramientas
+
+### Requeridas
+- **MCP de Exa** — Búsqueda web profunda de personas, empresas y señales (`web_search_exa`)
+- **API de X** — Grafo de seguidores/seguidos, análisis de mutuos, actividad reciente (`X_BEARER_TOKEN`, más credenciales de contexto de escritura como `X_CONSUMER_KEY`, `X_CONSUMER_SECRET`, `X_ACCESS_TOKEN`, `X_ACCESS_TOKEN_SECRET`)
+
+### Opcionales (mejoran los resultados)
+- **LinkedIn** — API directa si está disponible; en su defecto, control de navegador para búsqueda, inspección de perfiles y redacción
+- **API de Apollo/Clay** — Para cruce de enriquecimiento si el usuario tiene acceso
+- **MCP de GitHub** — Para calificar leads con perfil de desarrollador
+- **Apple Mail / Mail.app** — Redactar correos fríos o cálidos sin enviarlos automáticamente
+- **Control de navegador** — Para LinkedIn y X cuando la cobertura de API falta o está limitada
+
+## Vista general del pipeline
+
+```
+┌──────────────┐     ┌──────────────┐     ┌──────────────────┐     ┌───────────────┐     ┌────────────────┐
+│ 1. Puntuación│────>│ 2. Ranking   │────>│ 3. Descubrimiento│────>│ 4. Enriquecer │────>│ 5. Borrador de │
+│    de señales│     │    de mutuos │     │    de rutas      │     │               │     │    outreach    │
+└──────────────┘     └──────────────┘     └──────────────────┘     └───────────────┘     └────────────────┘
+```
+
+## Voz antes del outreach
+
+No redactes mensajes salientes desde copy comercial genérico.
+
+Ejecuta primero `voz-de-marca` siempre que la voz del usuario importe. Reutiliza su `PERFIL DE VOZ` en lugar de re-derivar el estilo ad hoc dentro de esta skill.
+
+Si hay acceso en vivo a X, extrae publicaciones originales recientes antes de redactar. Si no, usa ejemplos aportados por el usuario o el mejor material disponible del repo/sitio.
+
+## Etapa 1: puntuación de señales
+
+Busca personas de alta señal en los verticales objetivo. Asigna un peso a cada una según:
+
+| Señal | Peso | Fuente |
+|-------|------|--------|
+| Alineación de rol/cargo | 30 % | Exa, LinkedIn |
+| Coincidencia de industria | 25 % | Búsqueda de empresas en Exa |
+| Actividad reciente sobre el tema | 20 % | Búsqueda de la API de X, Exa |
+| Número de seguidores / influencia | 10 % | API de X |
+| Proximidad geográfica | 10 % | Exa, LinkedIn |
+| Interacción con tu contenido | 5 % | Interacciones vía API de X |
+
+### Enfoque de búsqueda de señales
+
+```python
+# Paso 1: definir los parámetros objetivo
+target_verticals = ["mercados de predicción", "herramientas de IA", "herramientas para desarrolladores"]
+target_roles = ["founder", "CEO", "CTO", "VP Engineering", "inversionista", "partner"]
+target_locations = ["San Francisco", "Nueva York", "Londres", "remoto"]
+
+# Paso 2: búsqueda profunda de personas con Exa
+for vertical in target_verticals:
+    results = web_search_exa(
+        query=f"{vertical} {role} founder CEO",
+        category="company",
+        numResults=20
+    )
+    # Puntuar cada resultado
+
+# Paso 3: búsqueda en la API de X de voces activas
+x_search = search_recent_tweets(
+    query="prediction markets OR AI tooling OR developer tools",
+    max_results=100
+)
+# Extraer y puntuar los autores únicos
+```
+
+## Etapa 2: ranking de mutuos
+
+Para cada objetivo puntuado, analiza el grafo social del usuario para encontrar la ruta más cálida.
+
+### Modelo de ranking
+
+1. Extrae la lista de seguidos en X del usuario y sus conexiones de LinkedIn
+2. Para cada objetivo de alta señal, comprueba si hay conexiones compartidas
+3. Aplica el modelo ponderado de puentes (abajo) para puntuar el valor de cada puente
+4. Rankea los mutuos por:
+
+| Factor | Peso |
+|--------|------|
+| Número de conexiones a objetivos | 40 % — el peso más alto; más conexiones = mayor ranking |
+| Rol/empresa actual del mutuo | 20 % — decisor vs. contribuidor individual |
+| Ubicación del mutuo | 15 % — misma ciudad = intro más fácil |
+| Alineación de industria | 15 % — mismo vertical = intro natural |
+| Handle de X / LinkedIn del mutuo | 10 % — identificabilidad para el outreach |
+
+Dentro de esta skill, usa este modelo ponderado de puentes:
+
+```text
+B(m) = Σ_{t ∈ T} w(t) · λ^(d(m,t) - 1)
+R(m) = B_ext(m) · (1 + β · engagement(m))
+```
+
+Interpretación:
+- Nivel 1: `R(m)` alto y rutas de puente directas -> pedir intros cálidas
+- Nivel 2: `R(m)` medio y rutas de puente de un salto -> pedir intros condicionales
+- Nivel 3: sin puente viable -> outreach frío directo usando el mismo registro del lead
+
+Si el usuario quiere el motor de ranking desglosado, la matemática visualizada o la red puntuada fuera del flujo completo de leads, ejecuta el modelo de puentes como una pasada independiente primero y reinyecta el resultado en este pipeline.
+
+### Formato de salida
+
+```
+INFORME DE RANKING DE MUTUOS
+============================
+
+#1  @handle_mutuo (Puntuación: 92)
+    Nombre: Jane Smith
+    Rol: Partner @ Acme Ventures
+    Ubicación: San Francisco
+    Conexiones a objetivos: 7
+    Conectada con: @objetivo1, @objetivo2, @objetivo3, @objetivo4, @objetivo5, @objetivo6, @objetivo7
+    Mejor ruta de intro: Jane invirtió en la empresa del Objetivo1
+
+#2  @handle_mutuo2 (Puntuación: 85)
+    ...
+```
+
+## Etapa 3: descubrimiento de rutas cálidas
+
+Para cada objetivo, encuentra la cadena de presentación más corta:
+
+```
+Tú ──[sigues a]──> Mutuo A ──[invirtió en]──> Empresa objetivo
+Tú ──[sigues a]──> Mutuo B ──[cofundó con]──> Persona objetivo
+Tú ──[conociste en]──> Evento ──[también asistió]──> Persona objetivo
+```
+
+### Tipos de ruta (ordenados por calidez)
+1. **Mutuo directo** — Ambos siguen/conocen a la misma persona
+2. **Conexión de portafolio** — El mutuo invirtió en o asesora a la empresa del objetivo
+3. **Colega/alumni** — El mutuo trabajó en la misma empresa o estudió en la misma institución
+4. **Coincidencia en eventos** — Ambos asistieron a la misma conferencia/programa
+5. **Interacción de contenido** — El objetivo interactuó con contenido del mutuo o viceversa
+
+## Etapa 4: enriquecimiento
+
+Para cada lead calificado, extrae:
+
+- Nombre completo, cargo actual, empresa
+- Tamaño de la empresa, etapa de financiación, noticias recientes
+- Publicaciones recientes en X (últimos 30 días) — temas, tono, intereses
+- Intereses mutuos con el usuario (seguidos compartidos, contenido similar)
+- Eventos recientes de la empresa (lanzamiento de producto, ronda de financiación, contrataciones)
+
+### Fuentes de enriquecimiento
+- Exa: datos de empresa, noticias, entradas de blog
+- API de X: publicaciones recientes, bio, seguidores
+- GitHub: contribuciones open source (para leads con perfil de desarrollador)
+- LinkedIn (vía control de navegador): perfil completo, experiencia, formación
+
+## Etapa 5: borrador de outreach
+
+Genera outreach personalizado para cada lead. El borrador debe ajustarse al perfil de voz derivado de fuentes reales y al canal objetivo.
+
+### Reglas por canal
+
+#### Correo electrónico
+
+- Úsalo para el outreach frío de mayor valor, intros cálidas, contacto con inversionistas y propuestas de alianza
+- Por defecto, redacta en Apple Mail / Mail.app cuando haya control de escritorio local disponible
+- Crea borradores primero; no envíes automáticamente salvo petición explícita del usuario
+- El asunto debe ser simple y específico, no ingenioso
+
+#### LinkedIn
+
+- Úsalo cuando el objetivo está activo ahí, cuando el contexto del grafo de mutuos es más fuerte en LinkedIn o cuando la confianza en el correo es baja
+- Prefiere el acceso por API si está disponible
+- En su defecto, usa control de navegador para inspeccionar perfiles, actividad reciente y redactar el mensaje
+- Hazlo más corto que un correo y evita la falsa calidez profesional
+
+#### X
+
+- Úsalo para outreach de alto contexto con operadores, builders o inversionistas donde el comportamiento público de publicación importa
+- Prefiere el acceso por API para búsqueda, timeline y análisis de interacción
+- Recurre al control de navegador cuando haga falta
+- Los DMs y las respuestas públicas deben ser mucho más concisos que un correo y referenciar algo real del timeline del objetivo
+
+#### Heurística de selección de canal
+
+Elige un canal principal en este orden:
+
+1. intro cálida por correo
+2. correo directo
+3. DM de LinkedIn
+4. DM o respuesta en X
+
+Usa multicanal solo cuando exista una razón fuerte y la cadencia no se sienta spam.
+
+### Solicitud de intro cálida (al mutuo)
+
+Objetivo:
+
+- una petición clara
+- una razón concreta de por qué la intro tiene sentido
+- un blurb fácil de reenviar si hace falta
+
+Evita:
+
+- sobreexplicar tu empresa
+- apilar prueba social
+- sonar a plantilla de recaudación
+
+### Outreach frío directo (al objetivo)
+
+Objetivo:
+
+- abrir con algo específico y reciente
+- explicar por qué el encaje es real
+- hacer una única petición de baja fricción
+
+Evita:
+
+- admiración genérica
+- volcar funcionalidades
+- peticiones amplias como "me encantaría conectar"
+- preguntas retóricas forzadas
+
+### Patrón de ejecución
+
+Para cada objetivo, produce:
+
+1. el canal recomendado
+2. la razón por la que ese canal es el mejor
+3. el borrador del mensaje
+4. borrador de seguimiento opcional
+5. si el canal elegido es el correo y Apple Mail está disponible, crea un borrador en la app en lugar de devolver solo texto
+
+Si hay control de navegador disponible:
+
+- LinkedIn: inspecciona el perfil del objetivo, su actividad reciente y el contexto de mutuos, luego redacta o prepara el mensaje
+- X: inspecciona publicaciones o respuestas recientes, luego redacta el DM o el lenguaje de la respuesta pública
+
+Si hay automatización de escritorio disponible:
+
+- Apple Mail: crea un borrador de correo con asunto, cuerpo y destinatario
+
+No envíes mensajes automáticamente sin aprobación explícita del usuario.
+
+### Antipatrones
+
+- plantillas genéricas sin personalización
+- párrafos largos explicando toda tu empresa
+- varias peticiones en un mismo mensaje
+- falsa familiaridad sin datos concretos
+- mensajes enviados en masa con campos de combinación visibles
+- copy idéntico reutilizado para correo, LinkedIn y X
+- relleno con forma de plataforma en lugar de la voz real del autor
+
+## Configuración
+
+El usuario debe definir estas variables de entorno:
+
+```bash
+# Requeridas
+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="..."
+
+# Opcionales
+export LINKEDIN_COOKIE="..." # Para acceso a LinkedIn vía navegador
+export APOLLO_API_KEY="..."  # Para enriquecimiento con Apollo
+```
+
+## Agentes
+
+Esta skill incluye agentes especializados en el subdirectorio `agents/`:
+
+- **puntuador-senales** — Busca y rankea prospectos por señales de relevancia
+- **mapeador-mutuos** — Mapea las conexiones del grafo social y encuentra rutas cálidas
+- **agente-enriquecimiento** — Extrae datos detallados de perfil y empresa
+- **redactor-outreach** — Genera mensajes personalizados
+
+## Ejemplo de uso
+
+```
+Usuario: encuéntrame las 20 personas top de mercados de predicción a las que debería contactar
+
+Flujo del agente:
+1. puntuador-senales busca en Exa y X líderes de mercados de predicción
+2. mapeador-mutuos revisa el grafo de X del usuario en busca de conexiones compartidas
+3. agente-enriquecimiento extrae datos de empresa y actividad reciente
+4. redactor-outreach genera mensajes personalizados para los leads mejor rankeados
+
+Salida: lista rankeada con rutas cálidas, resumen del perfil de voz y borradores de outreach por canal o borradores en la app
+```
+
+## Skills relacionadas
+
+- `voz-de-marca` para la captura canónica de la voz