theus-cli 0.2.83 → 0.2.85

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

@@ -1,307 +0,0 @@
----
-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

@@ -1,312 +0,0 @@
----
-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