@johpaz/hive-sdk 0.1.3 → 0.1.5

package/packages/core/src/skills/bundled-data.generated.ts

@@ -1,5 +1,5 @@
-// AUTO-GENERATED by packages/skills/scripts/generate-bundle.ts
-// Do NOT edit manually — run `bun packages/skills/scripts/generate-bundle.ts` to regenerate
+// AUTO-GENERATED by scripts/generate-skill-bundle.ts
+// Do NOT edit manually — run `bun scripts/generate-skill-bundle.ts` to regenerate
 
 export interface BundledSkillEntry {
   name: string;
@@ -13,1223 +13,1122 @@ export interface BundledSkillEntry {
 
 export const BUNDLED_SKILLS_DATA: BundledSkillEntry[] = [
   {
-    name: "file_read_and_summarize",
-    description: `Read and understand file content with automatic summarization for large files`,
-    category: "filesystem",
-    version: "1.0.0",
-    tools: ["project_read"],
-    triggers: ["leé este archivo","read this file","mostrame el contenido","show content","qué dice este archivo","resumí este archivo","summarize this file","entendé este código","understand this code"],
+    name: "agent_spawner",
+    description: `Create and manage specialized worker agents with optimal tool assignments and lifecycle control`,
+    category: "agents",
+    version: "1.1.0",
+    tools: ["get_available_models","agent_find","agent_create","agent_archive"],
+    triggers: ["creá un agente","create agent","creá un worker","create worker","nuevo agente","new agent","agente especializado","specialized agent","buscá un agente","find agent","archivá agente","archive agent","worker inactivo","inactive worker"],
     body: `
-# File Read and Summarize Skill
+# Agent Spawner Skill
 
 ## Cuándo se Activa
 
-Esta skill se activa cuando el usuario necesita leer y entender el contenido de un archivo, especialmente cuando:
-- El archivo es grande y necesita resumen
-- Se requiere comprensión del contenido (no solo lectura)
-- El usuario pide "qué dice", "resumí", "entendé"
+Para crear nuevos workers especializados o gestionar el ciclo de vida de agents existentes.
+
+> **Antes de crear nada**: la sección COLMENA DE AGENTES del system prompt ya lista workers listos para recibir trabajo (web, browser, archivos, código, Office, A2UI, cron y APIs). Crear un worker es el último recurso, excepto para MCP: si no existe un especialista del servidor, primero se pide autorización al usuario y luego se crea uno persistente.
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`project_read\` | Lee contenido de archivo del workspace | Lectura de cualquier archivo |
+| \`get_available_models\` | Consulta providers y modelos activos de la BD | **ANTES de crear** — seleccionar modelo óptimo |
+| \`agent_find\` | Busca agents existentes | **PRIMERO** — antes de crear |
+| \`agent_create\` | Crea nuevo worker | Si no existe apto |
+| \`agent_archive\` | Archiva worker | Limpieza, inactivos |
 
 ## Workflow
 
-1. **Verificar existencia** → \`project_exists({ path })\`
-2. **Leer contenido** → \`project_read({ path, offset, limit })\`
-3. **Sintetizar** → Resumir si es grande, extraer puntos clave
+### Crear Agent
+1. **Buscar** → \`agent_find({ search })\` — ¿existe?
+2. **Si existe** → Reutilizar
+3. **Si no existe** → \`get_available_models({ capabilities })\` — seleccionar modelo óptimo
+4. **Crear** → \`agent_create({...})\` con providerId y modelId seleccionados
+
+Para MCP, incluí \`mcp_server_id\` y creá un agente por servidor. La tool rechaza duplicados y nunca debe llamarse antes de la confirmación del usuario.
+
+### Create Agent Config
+\`\`\`javascript
+// 1. Consultar modelos disponibles para coding
+get_available_models({ capabilities: "coding" })
+// → [{ providerId: "openai", modelId: "gpt-4o", contextWindow: 128000 }, ...]
+
+// 2. Crear agente con modelo óptimo (providerId y modelId son OBLIGATORIOS)
+agent_create({
+  name: "ai_coder",
+  description: "Experto en código y refactorización",
+  system_prompt: \`
+    Sos desarrollador experto. Tu rol:
+    1. Escribir código limpio y testeable
+    2. Refactorizar código existente
+    3. Revisar PRs y sugerir mejoras
+  \`,
+  tools_json: ["fs_read", "fs_write", "fs_edit", "cli_exec"],
+  providerId: "openai",  // OBLIGATORIO - seleccionado de get_available_models
+  modelId: "gpt-4o",     // OBLIGATORIO - seleccionado de get_available_models
+  tone: "professional",
+  max_iterations: 15
+})
+\`\`\`
 
 ## Mejores Prácticas
 
-- Para archivos >1000 líneas, usar \`offset\` y \`limit\`
-- Identificar tipo de archivo por extensión y adaptar formato de resumen
-- Para código: identificar funciones, clases, exports principales
-- Para config: explicar settings clave en lenguaje simple
-- Para texto: extraer ideas principales
+- **Buscar primero**: Nunca duplicar workers
+- **Consultar modelos**: Usar \`get_available_models\` ANTES de crear para seleccionar provider/model óptimo
+- **System prompt específico**: Enfocado en especialidad
+- **Mínimo privilegio**: Solo tools necesarias
+- **Nombres descriptivos**: Que indiquen propósito
+- **Modelo adecuado**: Seleccionar según capacidad requerida (coding, chat, analysis, vision)
 
 ## Errores a Evitar
 
-- ❌ Leer sin verificar existencia
-- ❌ Retornar archivo completo sin resumir si es muy grande
-- ❌ No identificar tipo de archivo para adaptar resumen
+- ❌ Crear sin buscar primero
+- ❌ Crear sin consultar modelos disponibles (\`get_available_models\`)
+- ❌ Usar modelo inadecuado para la tarea (ej: modelo pequeño para coding complejo)
+- ❌ Tools en exceso ("por las dudas")
+- ❌ System prompt genérico
+- ❌ Nombres vagos ("worker1", "agent1")
 `,
   },
   {
-    name: "file_manager",
-    description: `Explore project structure and locate files using glob patterns and directory listing`,
-    category: "filesystem",
+    name: "memory_manager",
+    description: `Complete management of persistent memory including write, read, search, list, and delete operations`,
+    category: "agents",
     version: "1.0.0",
-    tools: ["project_list","project_glob","project_exists"],
-    triggers: ["lista los archivos","list files","buscá archivos","find files","explorá el proyecto","explore project","qué archivos hay","what files exist","buscá por patrón","search by pattern","existe este archivo","file exists","dónde está","where is"],
+    tools: ["memory_write","memory_read","memory_list","memory_search","memory_delete"],
+    triggers: ["guardá en memoria","save to memory","recordá esto","remember this","leé la memoria","read memory","qué hay en memoria","what's in memory","buscá en memoria","search memory","lista las memorias","list memories","eliminá de memoria","delete from memory","preferencias","preferences","datos persistentes","persistent data"],
     body: `
-# File Manager Skill
+# Memory Manager Skill
 
 ## Cuándo se Activa
 
-Esta skill se activa cuando el usuario necesita:
-- Explorar la estructura del proyecto
-- Buscar archivos por extensión o patrón
-- Verificar si existe un archivo o directorio
-- Encontrar la ubicación de un archivo
+Para guardar, recuperar, buscar, listar o eliminar información persistente entre sesiones.
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`project_list\` | Lista directorios y archivos | Exploración inicial |
-| \`project_glob\` | Busca archivos por patrón wildcard | Búsqueda por extensión/patrón |
-| \`project_exists\` | Verifica existencia | Pre-check antes de operaciones |
+| \`memory_write\` | Almacena con título único | Guardar preferencias, datos |
+| \`memory_read\` | Recupera por título exacto | Cuando conocés el título |
+| \`memory_list\` | Lista todos los títulos | Explorar qué hay guardado |
+| \`memory_search\` | Busca por keywords | Cuando no recordás título exacto |
+| \`memory_delete\` | Elimina entrada | Limpiar datos obsoletos |
 
 ## Workflow
 
-1. **Explorar** → \`project_list({ path })\` para estructura general
-2. **Buscar por patrón** → \`project_glob({ pattern })\` para tipos específicos
-3. **Verificar** → \`project_exists({ path })\` para confirmación
+### Write
+\`\`\`javascript
+memory_write({ 
+  title: "Preferencias de Desarrollo",
+  content: "TypeScript, VS Code, Prettier single quotes"
+})
+\`\`\`
+
+### Read/Search
+\`\`\`javascript
+memory_read({ title: "Preferencias" })  // Título exacto
+memory_search({ query: "preferencias" })  // Fuzzy match
+\`\`\`
 
-## Patrones Glob Comunes
+### List
+\`\`\`javascript
+memory_list({})  // Todos los títulos
+\`\`\`
 
-| Patrón | Encuentra |
-|--------|-----------|
-| \`**/*.ts\` | Todos los TypeScript |
-| \`**/*.test.ts\` | Solo tests |
-| \`**/*.md\` | Documentación |
-| \`**/package.json\` | Todos los package.json |
-| \`src/**/*.tsx\` | React components en src |
+### Delete
+\`\`\`javascript
+memory_delete({ title: "Datos Temporales" })
+\`\`\`
+
+## Mejores Prácticas
+
+- Títulos descriptivos y únicos
+- Agrupar datos relacionados en misma entrada
+- Confirmar antes de sobrescribir
+- No guardar datos sensibles
 
 ## Errores a Evitar
 
-- ❌ No verificar existencia antes de leer/editar
-- ❌ Usar project_list cuando se conoce el patrón (usar glob)
-- ❌ Patrones muy amplios sin filtrado
+- ❌ Datos sensibles (passwords, API keys)
+- ❌ Títulos genéricos ("Config", "Datos")
+- ❌ Sobrescribir sin confirmar
+- ❌ Entradas gigantes (split por tema)
 `,
   },
   {
-    name: "file_writer",
-    description: `Create, modify, and delete files with safe edit operations and confirmation for large changes`,
-    category: "filesystem",
+    name: "research_and_remember",
+    description: `Research information from web sources and save findings to persistent memory`,
+    category: "agents",
     version: "1.0.0",
-    tools: ["project_read","project_write","project_edit","project_exists"],
-    triggers: ["creá un archivo","create a file","escribí en","write to","editá este archivo","edit this file","modificá","modify","eliminá el archivo","delete file","guardá esto","save this","actualizá el archivo","update file"],
+    tools: ["web_search","web_fetch","memory_write"],
+    triggers: ["investigá y guardá","research and save","buscá y recordá","find and remember","aprendé sobre","learn about","estudiá esto","study this","documentate y guardá","research and store"],
     body: `
-# File Writer Skill
+# Research and Remember Skill
 
 ## Cuándo se Activa
 
-Esta skill se activa cuando el usuario necesita:
-- Crear nuevos archivos
-- Modificar contenido existente
-- Eliminar archivos
-- Guardar cambios
+Para investigar temas en la web y guardar el conocimiento sintetizado en memoria persistente.
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`project_read\` | Lee archivo existente | Antes de editar para entender estructura |
-| \`project_write\` | Crea o sobreescribe archivo | Archivos nuevos o reescritura completa |
-| \`project_edit\` | Edita secciones específicas | Cambios puntuales (find/replace) |
-| \`project_exists\` | Verifica existencia | Para decidir crear vs editar |
+| \`web_search\` | Busca en internet | Encontrar fuentes |
+| \`web_fetch\` | Descarga contenido | Obtener detalles |
+| \`memory_write\` | Guarda conocimiento | Almacenar para futuro |
 
 ## Workflow
 
-### Crear Archivo Nuevo
-1. \`project_exists({ path })\` → verificar no existe
-2. \`project_write({ path, content })\` → crear
+1. **Buscar** → \`web_search({ query, numResults: 8 })\`
+2. **Fetch** → \`web_fetch({ urls: top 2-3 })\`
+3. **Sintetizar** → Compilar hallazgos con estructura clara
+4. **Guardar** → \`memory_write({ title, content })\`
 
-### Editar Archivo Existente
-1. \`project_exists({ path })\` → verificar existe
-2. \`project_read({ path })\` → entender estructura
-3. \`project_edit({ path, old_string, new_string })\` → modificar
-4. \`canvas_confirm()\` si cambios >50 líneas
+## Estructura de Conocimiento
 
-### Eliminar Archivo
-1. \`project_exists({ path })\` → verificar existe
-2. \`canvas_confirm({ message: '¿Eliminar archivo?' })\` → confirmar
-3. Operación de delete
+\`\`\`markdown
+# {Topic}
+
+## Summary
+2-3 oración resumen
+
+## Key Findings
+- Punto clave 1
+- Punto clave 2
+- ...
+
+## Sources
+- [Source 1](url)
+- [Source 2](url)
+\`\`\`
 
 ## Mejores Prácticas
 
-- **Leer antes de editar**: Nunca modificar sin entender estructura
-- **Edit vs Write**: Usar edit para cambios pequeños, write para nuevos archivos
-- **Confirmar cambios grandes**: >50 líneas requiere confirmación explícita
-- **Paths seguros**: Trabajar dentro del workspace por defecto
+- Mínimo 2 searches para cobertura completa
+- Cruzar información entre fuentes múltiples
+- Incluir URLs para verificación
+- Estructura clara con headings
+- Flaggear información incierta
 
 ## Errores a Evitar
 
-- ❌ Editar sin leer primero
-- ❌ Sobreescribir sin confirmar si es cambio grande
-- ❌ Eliminar sin confirmación explícita
-- ❌ Usar write cuando edit es suficiente
+- ❌ Una sola búsqueda (insuficiente)
+- ❌ Sin fuentes (no verificable)
+- ❌ Títulos vagos para memoria
+- ❌ No flaggear información conflictiva
 `,
   },
   {
-    name: "web_research",
-    description: `Search and synthesize information from multiple web sources into structured reports`,
-    category: "web",
-    version: "1.0.0",
-    tools: ["web_search","web_fetch"],
-    triggers: ["investigá sobre","research","buscá información de","find information about","qué es","what is","explicame","explain","últimos avances","latest advances","tendencias de","trends in","información actualizada","current information"],
-    body: `
-# Web Research Skill
+    name: "task_orchestrator",
+    description: `Orchestrate tasks across multiple workers with delegation, status tracking, and bus communication`,
+    category: "agents",
+    version: "1.2.0",
+    tools: ["get_available_models","task_delegate","task_list","task_status","agent_find","agent_create","bus_publish","bus_read"],
+    triggers: ["delegá esta tarea","delegate task","orquestá los workers","orchestrate workers","coordiná el equipo","coordinate team","estado de las tareas","task status","comunicá los workers","communicate workers","mensaje al bus","bus message","tarea en paralelo","parallel tasks"],
+    body: `# Task Orchestrator — referencia operativa
 
-## Cuándo se Activa
+La doctrina de orquestación (descomponer → delegar en paralelo → terminar el turno → sintetizar en el fan-in) está en tu system prompt. Esta skill es la referencia de las herramientas.
 
-Esta skill se activa cuando el usuario necesita información actualizada de internet, verificar datos, o investigar temas específicos.
+## Herramientas
 
-## Herramientas Disponibles
+| Tool | Qué hace | Cuándo |
+|------|----------|--------|
+| \`task_delegate\` | Persiste y asigna una tarea a un worker | Delegar. Preferí \`mode="async"\` |
+| \`agent_find\` | Descubre workers del catálogo y propios | Antes de delegar. Nunca para comprobar ejecución |
+| \`task_list\` | Lista ejecuciones reales persistidas | El usuario pregunta y no conocés IDs |
+| \`task_status\` | Estado de tareas por ID | El usuario pide estado antes del fan-in |
+| \`get_available_models\` | Providers y modelos activos | Antes de crear un worker |
+| \`agent_create\` | Crea un worker nuevo | Último recurso: nada del catálogo sirve |
+| \`bus_publish\` / \`bus_read\` | Mensajes entre workers | Dependencias entre workers en vuelo |
 
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`web_search\` | Busca en internet, devuelve títulos, URLs, snippets | Búsqueda inicial, encontrar fuentes |
-| \`web_fetch\` | Descarga contenido completo de URL (HTML→Markdown) | Profundizar en resultados específicos |
+## Fan-out
 
-## Workflow
+\`\`\`javascript
+// Tres partes independientes → tres llamadas en la MISMA respuesta
+task_delegate({ worker_id: "web_researcher",            task_description: "...", mode: "async" })
+task_delegate({ worker_id: "office_document_agent",     task_description: "...", mode: "async" })
+task_delegate({ worker_id: "schedule_automation_agent", task_description: "...", mode: "async" })
+\`\`\`
 
-1. **Búsqueda inicial** → \`web_search({ query, numResults: 8 })\`
-2. **Fetch contenido** → \`web_fetch({ urls: top 2-3 })\`
-3. **Búsqueda complementaria** → Segundo search si hay gaps
-4. **Síntesis** → summary + key points + sources
+Cada llamada devuelve \`task_id\`, \`job_id\` y \`run_id\`: prueba de que la tarea quedó persistida.
 
-## Mejores Prácticas
+## Fan-in
 
-- Queries específicos (máx 6 palabras)
-- Mínimo 2-3 fuentes independientes
-- Priorizar contenido reciente (<1 año)
-- Citas con URLs completas
+Hive te reinvoca con:
 
-## Errores a Evitar
+\`\`\`
+[Sistema] Todas las tareas delegadas de este turno alcanzaron estado terminal.
+[{ task_id, worker_id, task, ok, result, error }, ...]
+\`\`\`
 
-- ❌ Inventar datos no encontrados
-- ❌ Concluir con una sola búsqueda
-- ❌ No verificar fecha de fuentes
-- ❌ Copiar contenido literal (usar paráfrasis)
+Sintetizá una sola respuesta. Las entradas con \`ok: false\` se reportan con su motivo real.
+
+## Crear un worker (último recurso)
+
+\`\`\`javascript
+get_available_models({ capabilities: "analysis" })
+// → [{ providerId: "anthropic", modelId: "claude-sonnet-4-6", ... }]
+
+agent_create({
+  name: "data_analyst",
+  description: "Experto en análisis de datos",
+  system_prompt: "Sos analista de datos experto...",
+  tools_json: ["web_search", "web_fetch", "save_note"],
+  providerId: "anthropic",   // OBLIGATORIO
+  modelId: "claude-sonnet-4-6", // OBLIGATORIO
+})
+\`\`\`
+
+Para una integración MCP sin especialista, pedí autorización primero. Si el usuario acepta, creá un worker con \`mcp_server_id\`; si participan varios servidores, creá o reutilizá uno por servidor. Nunca pases servidores MCP dinámicos a \`task_delegate\`.
+
+## Errores a evitar
+
+- ❌ Serializar tareas independientes en vez de fan-out paralelo
+- ❌ Polling con \`task_status\` esperando el resultado — el fan-in llega solo
+- ❌ Declarar éxito antes de recibir el \`[Sistema]\`, o presentar \`ok=false\` como éxito
+- ❌ Reportar éxito sin revisar \`acceptance\`/\`checks\` de la entrega, o ignorar un \`checks.status="failed"\`
+- ❌ Corregir a mano lo que \`task_revise\` puede reencolar en el mismo worker
+- ❌ Crear un worker que el catálogo ya cubre
+- ❌ Delegar saludos, preguntas simples o la conversación
+- ❌ Usar \`delegate_task\`, \`find_agent\`, \`create_agent\`, \`get_task_status\`, \`publish_to_bus\`, \`get_bus_messages\` — **no existen**
 `,
   },
   {
-    name: "web_monitor",
-    description: `Monitor changes in web sources and track updates over time with persistent memory`,
-    category: "web",
+    name: "cli_pipeline",
+    description: `Execute shell commands and pipe output to files for logging and further processing`,
+    category: "cli",
     version: "1.0.0",
-    tools: ["web_search","web_fetch","memory_write","memory_read"],
-    triggers: ["monitoreá","monitor","seguí los cambios","track changes","avisame si cambia","notify if changes","actualización de","update on","novedades de","news about","cambios en","changes in"],
+    tools: ["cli_exec","fs_write"],
+    triggers: ["guardá el output","save output","pipeline","pipe to file","redireccioná el output","redirect output","log del comando","command log","ejecutá y guardá","run and save","resultado en archivo","result to file"],
     body: `
-# Web Monitor Skill
+# CLI Pipeline Skill
 
 ## Cuándo se Activa
 
-Esta skill se activa cuando el usuario necesita:
-- Monitorear cambios en una URL específica
-- Recibir notificaciones de actualizaciones
-- Seguir novedades sobre un tema
-- Trackear evolución de contenido
+Para ejecutar comandos y guardar el output en archivos para logging o procesamiento posterior.
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`web_fetch\` | Descarga contenido de URL | Obtener contenido actual |
-| \`web_search\` | Busca novedades | Monitoreo por tema (no URL fija) |
-| \`memory_write\` | Guarda baseline | Almacenar contenido para comparación |
-| \`memory_read\` | Recupera baseline anterior | Comparar con contenido actual |
+| \`cli_exec\` | Ejecuta un comando con timeout y captura su salida | Comandos autorizados |
+| \`fs_write\` | Escribe un archivo dentro del workspace | Guardar output |
 
 ## Workflow
 
-1. **Primera ejecución**: \`web_fetch\` → \`memory_write\` (baseline)
-2. **Chequeos siguientes**: \`memory_read\` → \`web_fetch\` → comparar → \`notify\` si cambia
-3. **Actualizar baseline**: \`memory_write\` con nuevo contenido
+1. **Validar comando** → Seguro para ejecución
+2. **Ejecutar** → Capturar stdout + stderr
+3. **Formatear** → Agregar timestamp, comando, metadata
+4. **Escribir** → \`fs_write({ path, content })\`
+
+## Formato de Log
+
+\`\`\`markdown
+# Command Log
+
+**Command**: npm install
+**Timestamp**: 2025-03-09 14:30:00
+**Exit Code**: 0
+**Execution Time**: 45.2s
+
+---
+
+## Output
+
+[stdout content...]
+[stderr if any...]
+\`\`\`
 
 ## Mejores Prácticas
 
-- Ignorar cambios menores (timestamps, ads, contenido dinámico irrelevante)
-- Notificar solo cambios significativos
-- Para monitoreo periódico, combinar con \`cron.create\`
+- Filenames con timestamp para tracking
+- Incluir metadata completa (exitCode, tiempo)
+- Capturar stdout y stderr
+- Para outputs grandes, escribir incrementalmente
 
 ## Errores a Evitar
 
-- ❌ No almacenar baseline inicial
-- ❌ Notificar por cambios triviales
-- ❌ No actualizar timestamp de baseline
+- ❌ No incluir metadata en log
+- ❌ Filenames genéricos sin timestamp
+- ❌ No capturar stderr
 `,
   },
   {
-    name: "browser_scrape",
-    description: `Navigate to web pages and capture rendered content including screenshots for dynamic sites`,
-    category: "web",
+    name: "cli_safe_exec",
+    description: `Execute shell commands safely with error handling, timeouts, and output validation`,
+    category: "cli",
     version: "1.0.0",
-    tools: ["browser_navigate","browser_screenshot","web_fetch"],
-    triggers: ["capturá el contenido","scrape content","obtené la página renderizada","get rendered page","sitios dinámicos","dynamic sites","web con javascript","javascript websites","tomá screenshot y contenido","screenshot and content"],
+    tools: ["cli_exec"],
+    triggers: ["ejecutá este comando","run this command","corré el comando","execute command","terminal","bash","shell","npm","yarn","bun","git","docker","comando de sistema","system command"],
     body: `
-# Browser Scrape Skill
+# CLI Safe Exec Skill
 
 ## Cuándo se Activa
 
-Esta skill se activa para sitios web dinámicos que requieren JavaScript rendering, donde el contenido no está disponible en HTML estático.
+Para ejecutar comandos de shell de forma segura con manejo de errores y timeouts.
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`browser_navigate\` | Navega y renderiza página completa | Sitios con JavaScript/SPA |
-| \`browser_screenshot\` | Captura estado visual | Evidencia de contenido renderizado |
-| \`web_fetch\` | Extrae texto como markdown | Contenido textual de página renderizada |
+| \`exec\` | Ejecuta con validación y timeout | Comandos simples (<30s) |
+| \`terminal\` | Ejecuta con entorno completo | Comandos complejos, Git, npm |
+
+## ⚠️ ADVERTENCIA CRÍTICA
+
+**NUNCA usar para tareas programadas** — usar \`cron.create\` en su lugar.
 
 ## Workflow
 
-1. **Navegar** → \`browser_navigate({ url })\` + esperar renderizado JS
-2. **Capturar visual** → \`browser_screenshot()\`
-3. **Extraer texto** → \`web_fetch()\`
-4. **Combinar** → screenshot + texto para scrape completo
+1. **Validar** → Comando es seguro, no destructivo
+2. **Ejecutar** → \`exec\` o \`terminal\` con timeout apropiado
+3. **Parsear** → Check exitCode, stdout, stderr
+4. **Manejar error** → Si falló, analizar y sugerir fixes
 
-## Mejores Prácticas
+## Timeouts Apropiados
 
-- Esperar renderizado completo de JavaScript
-- Para infinite scroll: hacer scroll y múltiples screenshots
-- Capturar antes y después de interacciones si es dinámico
+| Tipo | Timeout |
+|------|---------|
+| Listar archivos | 10s |
+| Git operations | 30s |
+| npm install | 120s |
+| npm run build | 120s |
+| npm test | 180s |
+| Docker builds | 300s |
 
 ## Errores a Evitar
 
-- ❌ No esperar renderizado JavaScript
-- ❌ Solo capturar HTML estático para sitios SPA
-- ❌ Ignorar términos de servicio del sitio
+- ❌ Usar para cron (usar cron.create)
+- ❌ Sin timeout apropiado
+- ❌ Ignorar exitCode
+- ❌ Comandos destructivos sin confirmar
 `,
   },
   {
-    name: "browser_automate",
-    description: `Automate web workflows with navigation, clicks, form filling, and visual verification`,
-    category: "web",
+    name: "software_engineering",
+    description: `Implement, debug, and verify scoped software changes in an existing repository`,
+    category: "cli",
     version: "1.0.0",
-    tools: ["browser_navigate","browser_click","browser_type","browser_screenshot"],
-    triggers: ["automatizá el navegador","automate browser","completá el formulario","fill form","hacé clic en","click on","iniciá sesión","login","registrate","sign up","interactuá con la web","interact with website","flujo web","web workflow"],
+    tools: ["fs_read","fs_write","fs_edit","fs_list","fs_glob","fs_exists","cli_exec"],
+    triggers: ["implementar código","corregir bug","ejecutar tests","implement code","fix bug"],
     body: `
-# Browser Automate Skill
-
-## Cuándo se Activa
-
-Esta skill se activa para automatizar flujos de interacción con aplicaciones web: logins, formularios, navegación programática.
-
-## Herramientas Disponibles
-
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`browser_navigate\` | Navega a URL | Inicio de flujo |
-| \`browser_click\` | Click en elementos | Botones, enlaces, triggers |
-| \`browser_type\` | Escribe en inputs | Formularios, búsquedas |
-| \`browser_screenshot\` | Captura estado | Verificación visual |
+# Ingeniería de software
 
-## Workflow Típico
-
-1. **Navegar** → URL inicial
-2. **Interactuar** → click/type según flujo
-3. **Verificar** → screenshot después de acciones críticas
-4. **Repetir** → para flujos multi-paso
-
-## Mejores Prácticas
+1. Inspecciona estructura, convenciones y cambios existentes.
+2. Determina la causa o el cambio mínimo antes de editar.
+3. Conserva cambios ajenos y limita el diff al objetivo.
+4. Ejecuta tests, typecheck o build proporcionales al riesgo.
+5. Entrega archivos cambiados, comandos ejecutados, resultados y riesgos.
 
-- Selectores estables (IDs > classes > XPath)
-- Esperar carga después de navegación
-- Verificar estado visual con screenshots
-- Manejar errores de elementos no encontrados
-
-## Errores a Evitar
-
-- ❌ Selectores frágiles que cambian
-- ❌ No esperar carga de página
-- ❌ Ignorar errores de elementos
-- ❌ No verificar estado después de acciones
+No publiques, no delegues y no uses comandos destructivos sin autorización explícita.
 `,
   },
   {
-    name: "web_browser_research",
-    description: `Search the web and navigate results with a real browser to extract content from dynamic or JavaScript-heavy sites`,
-    category: "web",
-    version: "1.0.0",
-    tools: ["web_search","browser_navigate","browser_extract","web_fetch"],
-    triggers: ["investigá en web con navegador","web browser research","buscá y navegá","search and browse","research with browser","navegá los resultados","browse search results","contenido dinámico","dynamic content research","sitios con javascript","javascript sites research"],
+    name: "cron_manager",
+    description: `Manage Hive scheduled automations. Create, list, update, pause, resume, delete, trigger, and inspect recurring or one-shot jobs.`,
+    category: "cron",
+    version: "2.0.0",
+    tools: ["cron.create","cron.list","cron.update","cron.delete","cron.pause","cron.resume","cron.trigger","cron.history"],
+    triggers: ["programá una tarea","schedule task","creá un cron","create cron","editá el cron","edit cron","eliminá el cron","remove cron","lista las tareas","list cron jobs","modificá el cron","modify cron","tarea recurrente","recurring task","todos los días","daily","cada semana","weekly"],
     body: `
-# Web Browser Research Skill
+# Cron Manager Skill
 
 ## Cuándo se Activa
 
-Esta skill se activa cuando el usuario necesita investigación web profunda, especialmente cuando:
-- Los resultados de búsqueda pueden requerir navegación real por sitios dinámicos.
-- El contenido objetivo está renderizado con JavaScript (SPAs, dashboards, etc.).
-- Se necesita extraer datos estructurados de páginas web.
+Para gestionar tareas programadas (cron jobs): crear, listar, actualizar, pausar, reanudar, eliminar, ejecutar y ver historial.
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`web_search\` | Busca en internet y devuelve resultados | Encontrar URLs relevantes |
-| \`browser_navigate\` | Navega y renderiza la página completa | Sitios dinámicos con JavaScript |
-| \`browser_extract\` | Extrae datos con selectores CSS/XPath | Obtener contenido estructurado |
-| \`web_fetch\` | Descarga contenido estático | Páginas simples o respaldo |
+| \`cron.create\` | Crear cron job | Nueva tarea |
+| \`cron.list\` | Listar todos | Ver existentes |
+| \`cron.update\` | Actualizar existente | Cambiar horario/instrucción |
+| \`cron.pause\` | Pausar temporalmente | Sin eliminar |
+| \`cron.resume\` | Reanudar pausado | Continuar ejecución |
+| \`cron.delete\` | Eliminar permanentemente | Cancelar para siempre |
+| \`cron.trigger\` | Ejecutar ahora | Forzar ejecución |
+| \`cron.history\` | Ver historial | Ver logs de ejecuciones |
 
-## Workflow
+## Campos Principales
 
-1. **Buscar** → \`web_search({ query, numResults: 5 })\`
-2. **Seleccionar fuentes** → Elegir 2-3 URLs relevantes y confiables.
-3. **Navegar** → \`browser_navigate({ url })\` para cada fuente dinámica.
-4. **Extraer** → \`browser_extract({ selector: "article, .content, main" })\` o similar.
-5. **Respaldo estático** → Si el browser falla, usar \`web_fetch({ url })\`.
-6. **Sintetizar** → Responder con puntos clave y citas con URLs completas.
+| Campo | Tipo | Descripción |
+|-------|------|-------------|
+| \`name\` | string | Identificador corto (e.g., 'daily-report') |
+| \`task\` | string | **REQUERIDO** - Instrucciones para el agente al ejecutarse |
+| \`task_type\` | string | 'recurring' (repite) o 'one_shot' (una vez) |
+| \`cron_expression\` | string | Expresión cron (solo para recurring) |
+| \`fire_at\` | string | Datetime ISO (solo para one_shot) |
+| \`channel\` | string | Canal de notificación |
+| \`start_at\` | string | Inicio de ventana opcional (Croner startAt) |
+| \`stop_at\` | string | Fin de ventana opcional (Croner stopAt) |
+| \`dom_and_dow\` | number | 0=OR (default), 1=AND (día mes + día semana) |
 
-## Mejores Prácticas
+## Cron Expression Format
 
-- Priorizar sitios oficiales, documentación y fuentes primarias.
-- Usar selectores estables (etiquetas semánticas como \`article\`, \`main\`).
-- Si el contenido es largo, extraer por secciones.
-- Siempre incluir URLs de fuentes en la respuesta final.
+\`\`\`
+* * * * *
+│ │ │ │ │
+│ │ │ │ └── Día semana (0-6, 0=Domingo)
+│ │ │ └──── Mes (1-12)
+│ │ └────── Día del mes (1-31)
+│ └──────── Hora (0-23)
+└────────── Minuto (0-59)
+\`\`\`
 
-## Errores a Evitar
+## Ejemplos Comunes
 
-- ❌ Usar solo \`web_fetch\` para SPAs sin probar el browser primero.
-- ❌ Seleccionar selectores frágiles basados en clases aleatorias.
-- ❌ No citar las fuentes usadas.
-- ❌ Confundir snippets de búsqueda con contenido completo verificado.
-`,
-  },
-  {
-    name: "project_planner",
-    description: `Create comprehensive projects with structured tasks and worker assignments`,
-    category: "projects",
-    version: "1.0.0",
-    tools: ["project_create","task_create"],
-    triggers: ["creá un proyecto","create project","planificá","plan","organizá este trabajo","organize this work","estructurá el proyecto","structure project","descomponé en tareas","break down into tasks"],
-    body: `
-# Project Planner Skill
+| Expresión | Significado |
+|-----------|-------------|
+| \`0 9 * * *\` | Diario 9:00 AM |
+| \`0 7 * * 1-5\` | Lun-Vie 7:00 AM |
+| \`0 */2 * * *\` | Cada 2 horas |
+| \`0 0 * * 0\` | Domingos medianoche |
+| \`0 0 1 * *\` | Día 1 de cada mes |
 
-## Cuándo se Activa
+## Cómo Usar start_at / stop_at
 
-Para planificar y estructurar proyectos complejos que requieren coordinación de múltiples workers.
+- \`start_at\`: La tarea no ejecuta antes de esta fecha
+- \`stop_at\`: La tarea no ejecuta después de esta fecha
+- Formato ISO: \`'2026-04-01T00:00:00'\`
 
-## Herramientas Disponibles
+## Cómo Usar dom_and_dow
 
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`project_create\` | Crea proyecto con tasks | Estructura inicial |
-| \`task_create\` | Agrega tasks adicionales | Expandir proyecto |
+- \`0\` (default): Se ejecuta si es el día del mes O el día de semana
+- \`1\`: Se ejecuta solo si es EL MISMO día del mes Y el día de semana
 
-## Workflow
+Ejemplo: \`0 9 15 * *\` con dom_and_dow=1 significa "los 15 de cada mes QUE SEA domingo"
+
+## Workflow para Crear
 
-1. **Clarificar** → Entender objetivos y deliverables
-2. **Descomponer** → Dividir en tareas atómicas
-3. **Crear proyecto** → \`project_create({ name, description, tasks })\`
-4. **Asignar** → agent_id en tasks (o null si hay que crear workers)
+1. **Preguntar** → ¿one_shot o recurring?
+2. **Obtener** → Hora y canal de notificación
+3. **Crear** → \`cron.create\` con campo \`task\` obligatorio
+4. **Confirmar** → \`cron.list\` mostrar next runs
 
 ## Errores a Evitar
 
-- ❌ Crear proyecto para tareas simples
-- ❌ Tasks muy grandes o vagas
-- ❌ No definir criterios de aceptación
+- ❌ Olvidar el campo \`task\` — es obligatorio
+- ❌ Usar exec para tareas programadas
+- ❌ No preguntar si es one_shot o recurring
+- ❌ No mostrar próximos horarios al crear
+- ❌ Llamar \`cron.update\` sin \`task_id\` — siempre hacer \`cron.list\` primero
 `,
   },
   {
-    name: "project_tracker",
-    description: `Track project progress and update task status with real-time monitoring`,
-    category: "projects",
-    version: "1.0.0",
-    tools: ["project_list","project_update","task_update"],
-    triggers: ["cómo va el proyecto","project status","actualizá el progreso","update progress","seguimiento del proyecto","project tracking","lista los proyectos","list projects","qué tareas están en curso","tasks in progress","avance del proyecto","project progress"],
+    name: "cron_reminder",
+    description: `Schedule a reminder for yourself at a specific time. Creates a one_shot cron job that sends a notification message via your preferred channel.`,
+    category: "cron",
+    version: "2.0.0",
+    tools: ["cron.create","notify"],
+    triggers: ["recordame","remind me","recordatorio","reminder","alerta","alert","avísame","notify me","programá","schedule","para mañana","for tomorrow","en 30 minutos","in 30 minutes"],
     body: `
-# Project Tracker Skill
+# Cron Reminder Skill
 
 ## Cuándo se Activa
 
-Para monitorear y actualizar el progreso de proyectos y tareas en curso.
+Para crear recordatorios de una sola ejecución (one_shot): "recuerdame a las 3pm", "avísame en 30 minutos", etc.
 
-## Herramientas Disponibles
+## Herramientas
 
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`project_list\` | Lista proyectos | Ver todos o filtrar por estado |
-| \`task_update\` | Actualiza estado de tarea | Worker completa o cambia estado |
-| \`project_update\` | Actualiza progreso general | Milestones del proyecto |
+| Tool | Qué hace |
+|------|----------|
+| \`cron.create\` | Crear recordatorio one_shot |
+| \`notify\` | Enviar notificación directa |
 
-## Workflow
+## Cómo Funciona
 
-1. **Listar** → \`project_list()\` para encontrar proyecto
-2. **Actualizar tasks** → \`task_update()\` cuando workers entregan
-3. **Actualizar proyecto** → \`project_update()\` con progreso calculado
+1. **Preguntar** → ¿De qué te aviso? ¿A qué hora? ¿Por qué canal?
+2. **Crear** → \`cron.create\` con \`task_type: 'one_shot'\` y \`fire_at\` en formato ISO
+3. **Confirmar** → Mostrar hora programada
 
-## Mejores Prácticas
+## Parámetros
 
-- Actualizar inmediatamente cuando worker entrega
-- Calcular progreso como promedio de tasks completadas
-- Notificar milestones (25%, 50%, 75%, 100%)
-- Marcar 'at_risk' si task crítica está bloqueada
+| Campo | Descripción |
+|-------|-------------|
+| \`task\` | **REQUERIDO** - Mensaje del recordatorio |
+| \`task_type\` | Siempre \`'one_shot'\` |
+| \`fire_at\` | Fecha/hora ISO (ej: \`'2026-04-20T15:00:00'\`) |
+| \`channel\` | Canal (telegram, discord, whatsapp, webchat) |
 
-## Errores a Evitar
+## Errores Comunes
 
-- ❌ Dejar estado desactualizado
-- ❌ No notificar blockers
-- ❌ Progreso incorrecto vs realidad
+- ❌ Olvidar el campo \`task\` — obligatorio para que el agente sepa qué enviar
+- ❌ Usar expresiones cron para recordatorios (usar \`fire_at\` en vez de \`cron_expression\`)
+- ❌ Poner \`fire_at\` en el pasado
 `,
   },
   {
-    name: "project_closer",
-    description: `Evaluate task results and close projects with comprehensive summaries or failure analysis`,
-    category: "projects",
+    name: "file_manager",
+    description: `Explore project structure and locate files using glob patterns and directory listing`,
+    category: "filesystem",
     version: "1.0.0",
-    tools: ["task_evaluate","project_done","project_fail"],
-    triggers: ["cerrá el proyecto","close project","proyecto terminado","project done","proyecto fallido","project failed","evaluá la tarea","evaluate task","resumen final","final summary","lecciones aprendidas","lessons learned"],
+    tools: ["fs_list","fs_glob","fs_exists"],
+    triggers: ["lista los archivos","list files","buscá archivos","find files","explorá el proyecto","explore project","qué archivos hay","what files exist","buscá por patrón","search by pattern","existe este archivo","file exists","dónde está","where is"],
     body: `
-# Project Closer Skill
+# File Manager Skill
 
 ## Cuándo se Activa
 
-Para evaluar resultados y cerrar proyectos completados o fallidos.
+Esta skill se activa cuando el usuario necesita:
+- Explorar la estructura del proyecto
+- Buscar archivos por extensión o patrón
+- Verificar si existe un archivo o directorio
+- Encontrar la ubicación de un archivo
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`task_evaluate\` | Evalúa tarea con criterios | Validar calidad antes de cerrar |
-| \`project_done\` | Marca proyecto completado | Todas las tasks passing |
-| \`project_fail\` | Marca proyecto fallido | Error irrecuperable |
+| \`fs_list\` | Lista directorios y archivos | Exploración inicial |
+| \`fs_glob\` | Busca archivos por patrón wildcard | Búsqueda por extensión/patrón |
+| \`fs_exists\` | Verifica existencia | Pre-check antes de operaciones |
 
 ## Workflow
 
-### Cierre Exitoso
-1. **Evaluar tasks** → \`task_evaluate({ criteria })\`
-2. **Verificar todas** → Todas completadas
-3. **Cerrar** → \`project_done({ summary })\`
-
-### Cierre por Fallo
-1. **Identificar fallo** → Task crítica falló
-2. **Analizar causa** → Root cause
-3. **Cerrar** → \`project_fail({ reason, lessons })\`
+1. **Explorar** → \`fs_list({ path })\` para estructura general
+2. **Buscar por patrón** → \`fs_glob({ pattern })\` para tipos específicos
+3. **Verificar** → \`fs_exists({ path })\` para confirmación
 
-## Mejores Prácticas
+## Patrones Glob Comunes
 
-- Criterios de aceptación medibles y específicos
-- Resumen ejecutivo con outcomes medibles
-- Lecciones aprendidas accionables en failure
+| Patrón | Encuentra |
+|--------|-----------|
+| \`**/*.ts\` | Todos los TypeScript |
+| \`**/*.test.ts\` | Solo tests |
+| \`**/*.md\` | Documentación |
+| \`**/package.json\` | Todos los package.json |
+| \`src/**/*.tsx\` | React components en src |
 
 ## Errores a Evitar
 
-- ❌ Cerrar sin evaluar todas las tasks
-- ❌ project_fail sin análisis de causa raíz
-- ❌ Resúmenes vagos sin datos concretos
+- ❌ No verificar existencia antes de leer/editar
+- ❌ Usar fs_list cuando se conoce el patrón (usar glob)
+- ❌ Patrones muy amplios sin filtrado
 `,
   },
   {
-    name: "cli_safe_exec",
-    description: `Execute shell commands safely with error handling, timeouts, and output validation`,
-    category: "cli",
+    name: "file_read_and_summarize",
+    description: `Read and understand file content with automatic summarization for large files`,
+    category: "filesystem",
     version: "1.0.0",
-    tools: ["exec","terminal"],
-    triggers: ["ejecutá este comando","run this command","corré el comando","execute command","terminal","bash","shell","npm","yarn","bun","git","docker","comando de sistema","system command"],
+    tools: ["fs_read","fs_exists"],
+    triggers: ["leé este archivo","read this file","mostrame el contenido","show content","qué dice este archivo","resumí este archivo","summarize this file","entendé este código","understand this code"],
     body: `
-# CLI Safe Exec Skill
+# File Read and Summarize Skill
 
 ## Cuándo se Activa
 
-Para ejecutar comandos de shell de forma segura con manejo de errores y timeouts.
+Esta skill se activa cuando el usuario necesita leer y entender el contenido de un archivo, especialmente cuando:
+- El archivo es grande y necesita resumen
+- Se requiere comprensión del contenido (no solo lectura)
+- El usuario pide "qué dice", "resumí", "entendé"
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`exec\` | Ejecuta con validación y timeout | Comandos simples (<30s) |
-| \`terminal\` | Ejecuta con entorno completo | Comandos complejos, Git, npm |
-
-## ⚠️ ADVERTENCIA CRÍTICA
-
-**NUNCA usar para tareas programadas** — usar \`cron.create\` en su lugar.
+| \`fs_exists\` | Comprueba que el path exista | Antes de leer |
+| \`fs_read\` | Lee contenido de archivo del workspace | Lectura de cualquier archivo |
 
 ## Workflow
 
-1. **Validar** → Comando es seguro, no destructivo
-2. **Ejecutar** → \`exec\` o \`terminal\` con timeout apropiado
-3. **Parsear** → Check exitCode, stdout, stderr
-4. **Manejar error** → Si falló, analizar y sugerir fixes
+1. **Verificar existencia** → \`fs_exists({ path })\`
+2. **Leer contenido** → \`fs_read({ path, offset, limit })\`
+3. **Sintetizar** → Resumir si es grande, extraer puntos clave
 
-## Timeouts Apropiados
+## Mejores Prácticas
 
-| Tipo | Timeout |
-|------|---------|
-| Listar archivos | 10s |
-| Git operations | 30s |
-| npm install | 120s |
-| npm run build | 120s |
-| npm test | 180s |
-| Docker builds | 300s |
+- Para archivos >1000 líneas, usar \`offset\` y \`limit\`
+- Identificar tipo de archivo por extensión y adaptar formato de resumen
+- Para código: identificar funciones, clases, exports principales
+- Para config: explicar settings clave en lenguaje simple
+- Para texto: extraer ideas principales
 
 ## Errores a Evitar
 
-- ❌ Usar para cron (usar cron.create)
-- ❌ Sin timeout apropiado
-- ❌ Ignorar exitCode
-- ❌ Comandos destructivos sin confirmar
+- ❌ Leer sin verificar existencia
+- ❌ Retornar archivo completo sin resumir si es muy grande
+- ❌ No identificar tipo de archivo para adaptar resumen
 `,
   },
   {
-    name: "cli_pipeline",
-    description: `Execute shell commands and pipe output to files for logging and further processing`,
-    category: "cli",
+    name: "file_writer",
+    description: `Create, modify, and delete files with safe edit operations after required authorization`,
+    category: "filesystem",
     version: "1.0.0",
-    tools: ["exec","terminal","project_write"],
-    triggers: ["guardá el output","save output","pipeline","pipe to file","redireccioná el output","redirect output","log del comando","command log","ejecutá y guardá","run and save","resultado en archivo","result to file"],
+    tools: ["fs_read","fs_write","fs_edit","fs_exists"],
+    triggers: ["creá un archivo","create a file","escribí en","write to","editá este archivo","edit this file","modificá","modify","eliminá el archivo","delete file","guardá esto","save this","actualizá el archivo","update file"],
     body: `
-# CLI Pipeline Skill
+# File Writer Skill
 
 ## Cuándo se Activa
 
-Para ejecutar comandos y guardar el output en archivos para logging o procesamiento posterior.
+Esta skill se activa cuando el usuario necesita:
+- Crear nuevos archivos
+- Modificar contenido existente
+- Eliminar archivos
+- Guardar cambios
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`exec\` | Ejecuta comando | Comandos simples |
-| \`terminal\` | Ejecuta con entorno | Comandos complejos |
-| \`project_write\` | Escribe archivo | Guardar output |
+| \`fs_read\` | Lee archivo existente | Antes de editar para entender estructura |
+| \`fs_write\` | Crea o sobreescribe archivo | Archivos nuevos o reescritura completa |
+| \`fs_edit\` | Edita secciones específicas | Cambios puntuales (find/replace) |
+| \`fs_exists\` | Verifica existencia | Para decidir crear vs editar |
 
 ## Workflow
 
-1. **Validar comando** → Seguro para ejecución
-2. **Ejecutar** → Capturar stdout + stderr
-3. **Formatear** → Agregar timestamp, comando, metadata
-4. **Escribir** → \`project_write({ path, content })\`
-
-## Formato de Log
-
-\`\`\`markdown
-# Command Log
-
-**Command**: npm install
-**Timestamp**: 2025-03-09 14:30:00
-**Exit Code**: 0
-**Execution Time**: 45.2s
-
----
+### Crear Archivo Nuevo
+1. \`fs_exists({ path })\` → verificar no existe
+2. \`fs_write({ path, content })\` → crear
 
-## Output
+### Editar Archivo Existente
+1. \`fs_exists({ path })\` → verificar existe
+2. \`fs_read({ path })\` → entender estructura
+3. \`fs_edit({ path, old_string, new_string })\` → modificar
+4. Ejecutar únicamente dentro del alcance autorizado por el coordinador
 
-[stdout content...]
-[stderr if any...]
-\`\`\`
+### Eliminar Archivo
+1. \`fs_exists({ path })\` → verificar existe
+2. Verificar que el coordinador ya obtuvo autorización explícita
+3. \`fs_delete({ path })\`
 
 ## Mejores Prácticas
 
-- Filenames con timestamp para tracking
-- Incluir metadata completa (exitCode, tiempo)
-- Capturar stdout y stderr
-- Para outputs grandes, escribir incrementalmente
+- **Leer antes de editar**: Nunca modificar sin entender estructura
+- **Edit vs Write**: Usar edit para cambios pequeños, write para nuevos archivos
+- **Respetar autorización**: las confirmaciones se gestionan previamente desde el panel interactivo
+- **Paths seguros**: Trabajar dentro del workspace por defecto
 
 ## Errores a Evitar
 
-- ❌ No incluir metadata en log
-- ❌ Filenames genéricos sin timestamp
-- ❌ No capturar stderr
+- ❌ Editar sin leer primero
+- ❌ Ampliar el alcance autorizado
+- ❌ Eliminar sin autorización explícita previa
+- ❌ Usar write cuando edit es suficiente
 `,
   },
   {
-    name: "memory_manager",
-    description: `Complete management of persistent memory including write, read, search, list, and delete operations`,
-    category: "agents",
+    name: "workspace_file_operator",
+    description: `Safely create, read, edit, organize, and verify files or folders inside an authorized workspace`,
+    category: "filesystem",
     version: "1.0.0",
-    tools: ["memory_write","memory_read","memory_list","memory_search","memory_delete"],
-    triggers: ["guardá en memoria","save to memory","recordá esto","remember this","leé la memoria","read memory","qué hay en memoria","what's in memory","buscá en memoria","search memory","lista las memorias","list memories","eliminá de memoria","delete from memory","preferencias","preferences","datos persistentes","persistent data"],
+    tools: ["fs_read","fs_write","fs_edit","fs_delete","fs_list","fs_glob","fs_exists"],
+    triggers: ["crear carpeta","organizar archivos","editar archivo","create folder","manage files"],
     body: `
-# Memory Manager Skill
+# Operación segura del workspace
+
+1. Resuelve todas las rutas contra el workspace asignado.
+2. Comprueba el estado inicial con \`fs_exists\`, \`fs_list\` o \`fs_read\`.
+3. Aplica la operación mínima solicitada.
+4. Verifica el estado final mediante readback.
+
+Nunca accedas fuera del workspace ni declares éxito basándote solo en el resultado de una escritura.
+`,
+  },
+  {
+    name: "office_document_manager",
+    description: `Leer, crear y manipular archivos Office (PDF, Word, Excel, PowerPoint) desde el workspace`,
+    category: "office",
+    version: "1.0.0",
+    tools: ["office_leer_pdf","office_escribir_pdf","office_leer_docx","office_escribir_docx","office_leer_xlsx","office_escribir_xlsx","office_leer_pptx","office_escribir_pptx"],
+    triggers: ["leer pdf","abrir pdf","extraer texto de pdf","pdf a texto","crear pdf","generar pdf","exportar a pdf","leer word","abrir docx","extraer texto de word","crear word","generar docx","documento word","leer excel","abrir xlsx","datos de excel","crear excel","generar xlsx","exportar a excel","leer powerpoint","abrir pptx","presentacion","diapositivas","crear presentacion","generar pptx","read pdf","open pdf","create pdf","read excel","create excel","read word","create word","read powerpoint","create presentation"],
+    body: `
+# Office Document Manager Skill
 
 ## Cuándo se Activa
 
-Para guardar, recuperar, buscar, listar o eliminar información persistente entre sesiones.
+Esta skill se activa cuando el usuario necesita:
+- **Leer** archivos PDF, Word (.docx), Excel (.xlsx) o PowerPoint (.pptx)
+- **Generar** nuevos archivos en cualquiera de esos formatos
+- **Convertir** contenido entre formatos (ej: texto → PDF, JSON → Excel)
+- **Extraer** datos estructurados de documentos (tablas de Excel, slides de presentación)
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`memory_write\` | Almacena con título único | Guardar preferencias, datos |
-| \`memory_read\` | Recupera por título exacto | Cuando conocés el título |
-| \`memory_list\` | Lista todos los títulos | Explorar qué hay guardado |
-| \`memory_search\` | Busca por keywords | Cuando no recordás título exacto |
-| \`memory_delete\` | Elimina entrada | Limpiar datos obsoletos |
+| \`office_leer_pdf\` | Extrae texto + metadata de PDF | Leer informes, contratos, libros en PDF |
+| \`office_escribir_pdf\` | Genera PDF desde texto | Crear reportes, resúmenes, documentación |
+| \`office_leer_docx\` | Extrae texto y tablas de Word | Leer documentos, contratos, informes Word |
+| \`office_escribir_docx\` | Genera Word con estructura | Crear documentos formales con títulos/tablas |
+| \`office_leer_xlsx\` | Lee hojas de Excel como JSON | Procesar datos, tablas, inventarios |
+| \`office_escribir_xlsx\` | Genera Excel desde JSON | Exportar datos, crear reportes tabulares |
+| \`office_leer_pptx\` | Extrae texto de cada slide | Resumir presentaciones, extraer contenido |
+| \`office_escribir_pptx\` | Genera presentación PowerPoint | Crear slides desde datos o resúmenes |
 
-## Workflow
+## Workflow por Caso de Uso
 
-### Write
-\`\`\`javascript
-memory_write({ 
-  title: "Preferencias de Desarrollo",
-  content: "TypeScript, VS Code, Prettier single quotes"
-})
-\`\`\`
+### Leer y resumir un documento
+1. \`office_leer_pdf/docx/xlsx/pptx\` → extraer contenido
+2. Procesar y resumir el texto
+3. \`notify\` → enviar resumen al usuario
 
-### Read/Search
-\`\`\`javascript
-memory_read({ title: "Preferencias" })  // Título exacto
-memory_search({ query: "preferencias" })  // Fuzzy match
-\`\`\`
+### Transformar datos a Excel
+1. Obtener datos (de memoria, herramienta o cálculo)
+2. Estructurar en \`hojas\` con \`datos\` como array de objetos
+3. \`office_escribir_xlsx\` → generar archivo
+4. Confirmar ruta al usuario
 
-### List
-\`\`\`javascript
-memory_list({})  // Todos los títulos
-\`\`\`
+### Crear un informe PDF
+1. Compilar el contenido del informe como texto
+2. \`office_escribir_pdf\` → generar con título y márgenes
+3. Confirmar que el archivo quedó en la ruta esperada
 
-### Delete
-\`\`\`javascript
-memory_delete({ title: "Datos Temporales" })
+### Generar una presentación
+1. Definir estructura: título + array de slides (título + puntos)
+2. \`office_escribir_pptx\` → generar .pptx
+3. Opcional: incluir notas del presentador en cada slide
+
+## Parámetros Clave
+
+### \`parrafos\` para DOCX
+\`\`\`json
+[
+  { "texto": "Capítulo 1", "tipo": "titulo1" },
+  { "texto": "Subtítulo", "tipo": "titulo2" },
+  { "texto": "Contenido normal", "tipo": "parrafo" },
+  { "texto": "Ítem de lista", "tipo": "lista" },
+  { "texto": "Texto importante", "tipo": "parrafo", "negrita": true }
+]
 \`\`\`
 
-## Mejores Prácticas
+### \`hojas\` para XLSX
+\`\`\`json
+[
+  {
+    "nombre": "Ventas",
+    "datos": [
+      { "Mes": "Enero", "Total": 5000 },
+      { "Mes": "Febrero", "Total": 6200 }
+    ]
+  }
+]
+\`\`\`
 
-- Títulos descriptivos y únicos
-- Agrupar datos relacionados en misma entrada
-- Confirmar antes de sobrescribir
-- No guardar datos sensibles
+### \`diapositivas\` para PPTX
+\`\`\`json
+[
+  {
+    "titulo": "¿Qué es Machine Learning?",
+    "puntos": ["Subcampo de IA", "Aprende de datos", "Hace predicciones"],
+    "notas": "Mencionar el enfoque supervisado y no supervisado"
+  }
+]
+\`\`\`
 
 ## Errores a Evitar
 
-- ❌ Datos sensibles (passwords, API keys)
-- ❌ Títulos genéricos ("Config", "Datos")
-- ❌ Sobrescribir sin confirmar
-- ❌ Entradas gigantes (split por tema)
+- ❌ Intentar leer un archivo que no existe (verifica con \`fs_exists\` primero)
+- ❌ Sobrescribir sin confirmar cuando el archivo destino ya existe
+- ❌ Usar \`contenido\` y \`puntos\` a la vez en PPTX — \`puntos\` tiene prioridad
+- ❌ Pasar un array de arrays como \`datos\` de XLSX cuando se esperan objetos con claves
+- ❌ Intentar leer PDF de más de 100 páginas sin especificar rango (usar \`pagina_inicio\`/\`pagina_fin\`)
 `,
   },
   {
-    name: "research_and_remember",
-    description: `Research information from web sources and save findings to persistent memory`,
-    category: "agents",
+    name: "browser_automate",
+    description: `Automate web workflows with navigation, clicks, form filling, and visual verification`,
+    category: "web",
     version: "1.0.0",
-    tools: ["web_search","web_fetch","memory_write"],
-    triggers: ["investigá y guardá","research and save","buscá y recordá","find and remember","aprendé sobre","learn about","estudiá esto","study this","documentate y guardá","research and store"],
+    tools: ["browser_navigate","browser_click","browser_type","browser_screenshot"],
+    triggers: ["automatizá el navegador","automate browser","completá el formulario","fill form","hacé clic en","click on","iniciá sesión","login","registrate","sign up","interactuá con la web","interact with website","flujo web","web workflow"],
     body: `
-# Research and Remember Skill
+# Browser Automate Skill
 
 ## Cuándo se Activa
 
-Para investigar temas en la web y guardar el conocimiento sintetizado en memoria persistente.
+Esta skill se activa para automatizar flujos de interacción con aplicaciones web: logins, formularios, navegación programática.
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`web_search\` | Busca en internet | Encontrar fuentes |
-| \`web_fetch\` | Descarga contenido | Obtener detalles |
-| \`memory_write\` | Guarda conocimiento | Almacenar para futuro |
+| \`browser_navigate\` | Navega a URL | Inicio de flujo |
+| \`browser_click\` | Click en elementos | Botones, enlaces, triggers |
+| \`browser_type\` | Escribe en inputs | Formularios, búsquedas |
+| \`browser_screenshot\` | Captura estado | Verificación visual |
 
-## Workflow
+## Workflow Típico
 
-1. **Buscar** → \`web_search({ query, numResults: 8 })\`
-2. **Fetch** → \`web_fetch({ urls: top 2-3 })\`
-3. **Sintetizar** → Compilar hallazgos con estructura clara
-4. **Guardar** → \`memory_write({ title, content })\`
-
-## Estructura de Conocimiento
-
-\`\`\`markdown
-# {Topic}
-
-## Summary
-2-3 oración resumen
-
-## Key Findings
-- Punto clave 1
-- Punto clave 2
-- ...
-
-## Sources
-- [Source 1](url)
-- [Source 2](url)
-\`\`\`
+1. **Navegar** → URL inicial
+2. **Interactuar** → click/type según flujo
+3. **Verificar** → screenshot después de acciones críticas
+4. **Repetir** → para flujos multi-paso
 
 ## Mejores Prácticas
 
-- Mínimo 2 searches para cobertura completa
-- Cruzar información entre fuentes múltiples
-- Incluir URLs para verificación
-- Estructura clara con headings
-- Flaggear información incierta
+- Selectores estables (IDs > classes > XPath)
+- Esperar carga después de navegación
+- Verificar estado visual con screenshots
+- Manejar errores de elementos no encontrados
 
 ## Errores a Evitar
 
-- ❌ Una sola búsqueda (insuficiente)
-- ❌ Sin fuentes (no verificable)
-- ❌ Títulos vagos para memoria
-- ❌ No flaggear información conflictiva
+- ❌ Selectores frágiles que cambian
+- ❌ No esperar carga de página
+- ❌ Ignorar errores de elementos
+- ❌ No verificar estado después de acciones
 `,
   },
   {
-    name: "agent_spawner",
-    description: `Create and manage specialized worker agents with optimal tool assignments and lifecycle control`,
-    category: "agents",
-    version: "1.1.0",
-    tools: ["get_available_models","find_agent","create_agent","archive_agent"],
-    triggers: ["creá un agente","create agent","creá un worker","create worker","nuevo agente","new agent","agente especializado","specialized agent","buscá un agente","find agent","archivá agente","archive agent","worker inactivo","inactive worker"],
+    name: "browser_scrape",
+    description: `Navigate to web pages and capture rendered content including screenshots for dynamic sites`,
+    category: "web",
+    version: "1.0.0",
+    tools: ["browser_navigate","browser_screenshot","web_fetch"],
+    triggers: ["capturá el contenido","scrape content","obtené la página renderizada","get rendered page","sitios dinámicos","dynamic sites","web con javascript","javascript websites","tomá screenshot y contenido","screenshot and content"],
     body: `
-# Agent Spawner Skill
+# Browser Scrape Skill
 
 ## Cuándo se Activa
 
-Para crear nuevos workers especializados o gestionar el ciclo de vida de agents existentes.
+Esta skill se activa para sitios web dinámicos que requieren JavaScript rendering, donde el contenido no está disponible en HTML estático.
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`get_available_models\` | Consulta providers y modelos activos de la BD | **ANTES de crear** — seleccionar modelo óptimo |
-| \`find_agent\` | Busca agents existentes | **PRIMERO** — antes de crear |
-| \`create_agent\` | Crea nuevo worker | Si no existe apto |
-| \`archive_agent\` | Archiva worker | Limpieza, inactivos |
+| \`browser_navigate\` | Navega y renderiza página completa | Sitios con JavaScript/SPA |
+| \`browser_screenshot\` | Captura estado visual | Evidencia de contenido renderizado |
+| \`web_fetch\` | Extrae texto como markdown | Contenido textual de página renderizada |
 
 ## Workflow
 
-### Crear Agent
-1. **Buscar** → \`find_agent({ search })\` — ¿existe?
-2. **Si existe** → Reutilizar
-3. **Si no existe** → \`get_available_models({ capabilities })\` — seleccionar modelo óptimo
-4. **Crear** → \`create_agent({...})\` con providerId y modelId seleccionados
-
-### Create Agent Config
-\`\`\`javascript
-// 1. Consultar modelos disponibles para coding
-get_available_models({ capabilities: "coding" })
-// → [{ providerId: "openai", modelId: "gpt-4o", contextWindow: 128000 }, ...]
-
-// 2. Crear agente con modelo óptimo (providerId y modelId son OBLIGATORIOS)
-create_agent({
-  name: "ai_coder",
-  description: "Especialista en código y refactorización",
-  system_prompt: \`
-    Sos desarrollador experto. Tu rol:
-    1. Escribir código limpio y testeable
-    2. Refactorizar código existente
-    3. Revisar PRs y sugerir mejoras
-  \`,
-  tools_json: ["fs_read", "fs_write", "fs_edit", "cli_exec"],
-  providerId: "openai",  // OBLIGATORIO - seleccionado de get_available_models
-  modelId: "gpt-4o",     // OBLIGATORIO - seleccionado de get_available_models
-  tone: "professional",
-  max_iterations: 15
-})
-\`\`\`
+1. **Navegar** → \`browser_navigate({ url })\` + esperar renderizado JS
+2. **Capturar visual** → \`browser_screenshot()\`
+3. **Extraer texto** → \`web_fetch()\`
+4. **Combinar** → screenshot + texto para scrape completo
 
 ## Mejores Prácticas
 
-- **Buscar primero**: Nunca duplicar workers
-- **Consultar modelos**: Usar \`get_available_models\` ANTES de crear para seleccionar provider/model óptimo
-- **System prompt específico**: Enfocado en especialidad
-- **Mínimo privilegio**: Solo tools necesarias
-- **Nombres descriptivos**: Que indiquen propósito
-- **Modelo adecuado**: Seleccionar según capacidad requerida (coding, chat, analysis, vision)
+- Esperar renderizado completo de JavaScript
+- Para infinite scroll: hacer scroll y múltiples screenshots
+- Capturar antes y después de interacciones si es dinámico
 
 ## Errores a Evitar
 
-- ❌ Crear sin buscar primero
-- ❌ Crear sin consultar modelos disponibles (\`get_available_models\`)
-- ❌ Usar modelo inadecuado para la tarea (ej: modelo pequeño para coding complejo)
-- ❌ Tools en exceso ("por las dudas")
-- ❌ System prompt genérico
-- ❌ Nombres vagos ("worker1", "agent1")
+- ❌ No esperar renderizado JavaScript
+- ❌ Solo capturar HTML estático para sitios SPA
+- ❌ Ignorar términos de servicio del sitio
 `,
   },
   {
-    name: "task_orchestrator",
-    description: `Orchestrate tasks across multiple workers with delegation, status tracking, and bus communication`,
-    category: "agents",
-    version: "1.1.0",
-    tools: ["get_available_models","task_delegate","task_status","agent_find","agent_create","bus_publish","bus_read"],
-    triggers: ["delegá esta tarea","delegate task","orquestá los workers","orchestrate workers","coordiná el equipo","coordinate team","estado de las tareas","task status","comunicá los workers","communicate workers","mensaje al bus","bus message","tarea en paralelo","parallel tasks"],
+    name: "web_monitor",
+    description: `Monitor changes in web sources and track updates over time with persistent memory`,
+    category: "web",
+    version: "1.0.0",
+    tools: ["web_search","web_fetch","memory_write","memory_read"],
+    triggers: ["monitoreá","monitor","seguí los cambios","track changes","avisame si cambia","notify if changes","actualización de","update on","novedades de","news about","cambios en","changes in"],
     body: `
-# Task Orchestrator Skill
+# Web Monitor Skill
 
 ## Cuándo se Activa
 
-Para coordinar múltiples workers, delegar tareas, monitorear progreso, y facilitar comunicación worker-to-worker.
+Esta skill se activa cuando el usuario necesita:
+- Monitorear cambios en una URL específica
+- Recibir notificaciones de actualizaciones
+- Seguir novedades sobre un tema
+- Trackear evolución de contenido
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`get_available_models\` | Consulta providers y modelos activos | Al crear workers — seleccionar modelo óptimo |
-| \`agent_find\` | Busca workers disponibles | Antes de delegar |
-| \`agent_create\` | Crea nuevo worker | Si no hay uno adecuado |
-| \`task_delegate\` | Asigna y EJECUTA tarea | Delegar con ejecución inmediata |
-| \`task_status\` | Verifica estado de tareas | Monitorear progreso |
-| \`bus_publish\` | Publica mensaje | Coordinación worker-to-worker |
-| \`bus_read\` | Lee mensajes del bus | Ver solicitudes de workers |
+| \`web_fetch\` | Descarga contenido de URL | Obtener contenido actual |
+| \`web_search\` | Busca novedades | Monitoreo por tema (no URL fija) |
+| \`memory_write\` | Guarda baseline | Almacenar contenido para comparación |
+| \`memory_read\` | Recupera baseline anterior | Comparar con contenido actual |
 
 ## Workflow
 
-### Delegación
-1. **Consultar modelos** → \`get_available_models({ capabilities })\` — si necesita crear workers
-2. **Buscar worker** → \`agent_find({ search })\`
-3. **Si no existe** → \`agent_create({...})\` — con providerId y modelId OBLIGATORIOS
-4. **Delegar** → \`task_delegate({ worker_id, task_description, task_id?, project_id? })\` — **BLOQUEANTE**
-5. **Resultado retornado** → Worker ejecuta inmediatamente y devuelve resultado
-
-### Create Agent Config (providerId y modelId son OBLIGATORIOS)
-\`\`\`javascript
-// 1. Consultar modelos disponibles
-get_available_models({ capabilities: "analysis" })
-// → [{ providerId: "anthropic", modelId: "claude-sonnet-4-6", contextWindow: 200000 }, ...]
-
-// 2. Crear worker con modelo óptimo
-agent_create({
-  name: "data_analyst",
-  description: "Especialista en análisis de datos y visualización",
-  system_prompt: "Sos analista de datos experto...",
-  tools_json: ["web_search", "web_fetch", "save_note"],
-  providerId: "anthropic",  // OBLIGATORIO
-  modelId: "claude-sonnet-4-6",  // OBLIGATORIO
-  tone: "analytical"
-})
-\`\`\`
-
-### Monitoreo
-1. **Check estado** → \`task_status({ task_ids })\`
-2. **Publicar coordinación** → \`bus_publish()\` si needed
-3. **Leer bus** → \`bus_read()\` para respuestas
-
-## Agent Bus Communication
-
-\`\`\`javascript
-// Worker notifica completado:
-bus_publish({
-  event_type: "task_complete",
-  to_worker_id: "next_worker",
-  content: "Research done. Found 7 trends. Ready for content generation."
-})
-
-// Worker solicita contexto:
-bus_read() → [{ from: "writer", content: "Need research results" }]
-\`\`\`
+1. **Primera ejecución**: \`web_fetch\` → \`memory_write\` (baseline)
+2. **Chequeos siguientes**: \`memory_read\` → \`web_fetch\` → comparar → \`notify\` si cambia
+3. **Actualizar baseline**: \`memory_write\` con nuevo contenido
 
 ## Mejores Prácticas
 
-- \`task_delegate\` es bloqueante — el resultado llega en el retorno de la tool
-- Consultar modelos disponibles antes de crear workers (\`get_available_models\`)
-- Asignar workers por especialidad (\`agent_find\`)
-- Usar \`bus_publish\` / \`bus_read\` para coordinación entre workers
-- Pasar \`task_id\` y \`project_id\` a \`task_delegate\` para auto-tracking de progreso
-- Seleccionar modelo según capacidad: coding → modelos grandes, chat → modelos rápidos
+- Ignorar cambios menores (timestamps, ads, contenido dinámico irrelevante)
+- Notificar solo cambios significativos
+- Para monitoreo periódico, combinar con \`cron.create\`
 
 ## Errores a Evitar
 
-- ❌ Usar \`delegate_task\` (no existe) — usar \`task_delegate\`
-- ❌ Usar \`find_agent\` (no existe) — usar \`agent_find\`
-- ❌ Usar \`publish_to_bus\` / \`get_bus_messages\` (no existen) — usar \`bus_publish\` / \`bus_read\`
-- ❌ Usar \`get_task_status\` (no existe) — usar \`task_status\`
-- ❌ No consultar modelos disponibles antes de crear workers
-- ❌ No monitorear estado de tasks
-- ❌ No coordinar workers cuando hay dependencias
+- ❌ No almacenar baseline inicial
+- ❌ Notificar por cambios triviales
+- ❌ No actualizar timestamp de baseline
 `,
   },
   {
-    name: "code_delegator",
-    description: `Delegate coding tasks to CLI subagents (Qwen, Claude, Gemini, OpenCode) via Code Bridge and monitor execution`,
-    category: "agents",
+    name: "web_research",
+    description: `Search and synthesize information from multiple web sources into structured reports`,
+    category: "web",
     version: "1.0.0",
-    tools: ["task_delegate_code","task_status","codebridge_launch","codebridge_status"],
-    triggers: ["delegá el código","delegate code","que lo haga un subagente","let subagent do it","programá esto","code this","implementá con CLI","implement with CLI","usá Qwen","use Qwen","usá Claude Code","use Claude Code","subagente de código","coding subagent"],
+    tools: ["web_search","web_fetch"],
+    triggers: ["investigá sobre","research","buscá información de","find information about","qué es","what is","explicame","explain","últimos avances","latest advances","tendencias de","trends in","información actualizada","current information"],
     body: `
-# Code Delegator Skill
+# Web Research Skill
 
 ## Cuándo se Activa
 
-Esta skill se activa cuando el usuario necesita delegar tareas de programación a subagentes CLI especializados (Qwen CLI, Claude Code, Gemini CLI, OpenCode).
+Esta skill se activa cuando el usuario necesita información actualizada de internet, verificar datos, o investigar temas específicos.
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`task_delegate_code\` | Delega tarea de código simple | Tasks pequeños/medianos |
-| \`codebridge_launch\` | Lanza subagente CLI externo | Tasks complejos que requieren CLI completo |
-| \`codebridge_status\` | Verifica estado de ejecución | Monitoreo de progreso |
-| \`task_status\` | Obtiene estado de tarea delegada | Verificación final |
+| \`web_search\` | Busca en internet, devuelve títulos, URLs, snippets | Búsqueda inicial, encontrar fuentes |
+| \`web_fetch\` | Descarga contenido completo de URL (HTML→Markdown) | Profundizar en resultados específicos |
 
 ## Workflow
 
-### Delegación Simple
-\`\`\`javascript
-task_delegate_code({
-  description: "Implementar función de autenticación",
-  acceptance_criteria: "Funciona con JWT, maneja errores"
-})
-\`\`\`
-
-### Delegación Completa (CLI Subagent)
-\`\`\`javascript
-// 1. Lanzar subagente
-const { process_id } = codebridge_launch({
-  agent: "qwen",  // o "claude", "gemini", "opencode"
-  prompt: \`
-    Implementar endpoint REST para usuarios:
-    - GET /users - listar usuarios
-    - POST /users - crear usuario
-    - Validación con Zod
-    - Tests con Jest
-  \`
-})
-
-// 2. Monitorear
-const status = codebridge_status({ process_id })
-
-// 3. Verificar resultado
-const result = task_status({ task_id })
-\`\`\`
-
-## Subagentes Disponibles
-
-| Agente | Comando | Especialidad |
-|--------|---------|--------------|
-| Qwen CLI | \`qwen\` | Código general, rápido |
-| Claude Code | \`claude\` | Código complejo, refactor |
-| Gemini CLI | \`gemini\` | Código + documentación |
-| OpenCode | \`opencode\` | Open source, multi-lenguaje |
+1. **Búsqueda inicial** → \`web_search({ query, numResults: 8 })\`
+2. **Fetch contenido** → \`web_fetch({ urls: top 2-3 })\`
+3. **Búsqueda complementaria** → Segundo search si hay gaps
+4. **Síntesis** → summary + key points + sources
 
 ## Mejores Prácticas
 
-- Prompts claros con requisitos específicos
-- Criterios de aceptación explícitos
-- Monitoreo periódico (30-60s para tasks largos)
-- Verificación de output antes de cerrar
+- Queries específicos (máx 6 palabras)
+- Mínimo 2-3 fuentes independientes
+- Priorizar contenido reciente (<1 año)
+- Citas con URLs completas
 
 ## Errores a Evitar
 
-- ❌ Prompts vagos sin criterios claros
-- ❌ No monitorear ejecución larga
-- ❌ Ignorar errores del subagente
-- ❌ No verificar que el código cumple requisitos
+- ❌ Inventar datos no encontrados
+- ❌ Concluir con una sola búsqueda
+- ❌ No verificar fecha de fuentes
+- ❌ Copiar contenido literal (usar paráfrasis)
 `,
   },
   {
-    name: "canvas_report",
-    description: `Display structured results to users using cards, lists, and progress indicators`,
-    category: "canvas",
+    name: "api_client",
+    description: `Make HTTP requests to REST APIs using curl-like methods (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS)`,
+    category: "api",
     version: "1.0.0",
-    tools: ["canvas_show_card","canvas_show_list","canvas_show_progress"],
-    triggers: ["mostrame en el canvas","show on canvas","mostrá los resultados","show results","tarjeta informativa","info card","lista los resultados","list results","barra de progreso","progress bar","dashboard","estado visual","visual status"],
+    tools: ["api_request"],
+    triggers: ["llama a la api","llama al api","consume la api","haz una petición","haz un request","envía un post","envía un put","envía un delete","curl","api request","rest api","endpoint","webhook","integrar con api","conectar con api","obtener datos de api","enviar datos a api"],
     body: `
-# Canvas Report Skill
+# API Client Skill
 
 ## Cuándo se Activa
 
-Para mostrar resultados estructurados visualmente en el canvas del usuario.
+Esta skill se activa cuando el usuario necesita interactuar con una API REST: consultar datos, crear recursos, actualizar, eliminar, o cualquier operación HTTP.
 
 ## Herramientas Disponibles
 
 | Tool | Qué hace | Cuándo usarla |
 |------|----------|---------------|
-| \`canvas_show_card\` | Muestra información estructurada | Resultados con items etiquetados |
-| \`canvas_show_list\` | Lista clave-valor | Configuraciones, datos simples |
-| \`canvas_show_progress\` | Barras de progreso | Estado de tasks múltiples |
+| \`api_request\` | Realiza peticiones HTTP completas (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS) con headers, body, query params y timeout | Siempre que necesites llamar un endpoint REST, webhook, o servicio externo |
 
-## Workflow
+## Parámetros de api_request
 
-1. **Determinar formato** → Card vs List vs Progress
-2. **Renderizar** → \`canvas_show_*\` apropiado
-3. **Clear** → Si cambio de contexto significativo
+- \`method\` (requerido): GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS
+- \`url\` (requerido): URL completa del endpoint
+- \`headers\` (opcional): objeto con headers HTTP. Ej: \`{ "Authorization": "Bearer TOKEN", "Content-Type": "application/json" }\`
+- \`body\` (opcional): cuerpo de la petición como string. Para JSON, enviar JSON.stringify(objeto)
+- \`query_params\` (opcional): parámetros de query que se codificarán automáticamente en la URL
+- \`timeout_ms\` (opcional): timeout en ms. Default: 30000. Máx: 120000
 
-## Formatos
+## Diferencia con web_fetch
 
-### Card
-\`\`\`javascript
-canvas_show_card({
-  title: "Research Results",
-  items: [
-    { label: "Trends Found", value: "7" },
-    { label: "Sources", value: "5 URLs" },
-    { label: "Time", value: "2.5 min" }
-  ]
-})
+- \`web_fetch\`: solo GET, sin headers custom, ideal para scraping de páginas web
+- \`api_request\`: cualquier método HTTP, headers custom, body, query params — ideal para APIs REST
 
-// Full-width card (ocupa todo el ancho del canvas):
-canvas_show_card({
-  title: "Full Report",
-  span: "full",
-  items: [...]
-})
-\`\`\`
+## Workflow
 
-### List
-\`\`\`javascript
-canvas_show_list({
-  items: {
-    "Language": "Spanish",
-    "Timezone": "UTC-3",
-    "Channel": "Telegram"
-  }
-})
-\`\`\`
+1. **Identificar endpoint y método** → Determinar URL, método, headers necesarios
+2. **Construir request** → \`api_request({ method, url, headers, body })\`
+3. **Validar respuesta** → Si 2xx: extraer datos. Si error: analizar y sugerir fix
+4. **Presentar resultados** → JSON parseado en formato legible, no crudo a menos que se pida
 
-### Progress
-\`\`\`javascript
-canvas_show_progress({
-  bars: [
-    { label: "Research", value: 100 },
-    { label: "Content", value: 60 },
-    { label: "Email", value: 0 }
-  ]
-})
-\`\`\`
+## Mejores Prácticas
+
+- Siempre enviar \`Content-Type: application/json\` cuando el body es JSON
+- Usar \`query_params\` en lugar de append manual a la URL
+- No exponer tokens/secrets en la respuesta final al usuario
+- Si la API requiere auth, pedirla al usuario o usar variables de entorno
+- Para errores 4xx, revisar: auth, formato del body, campos requeridos, rate limits
 
 ## Errores a Evitar
 
-- ❌ Cards con demasiados items (>7)
-- ❌ Labels vagos sin contexto
-- ❌ No clear entre contextos diferentes
+- ❌ Usar web_fetch para POST/PUT/DELETE con headers
+- ❌ Enviar objetos directamente en body (debe ser string)
+- ❌ Olvidar Content-Type al enviar JSON
+- ❌ Exponer API keys en la respuesta visible
 `,
   },
   {
-    name: "canvas_interact",
-    description: `Collect user input and confirmations through interactive forms and dialogs`,
-    category: "canvas",
-    version: "1.0.0",
-    tools: ["canvas_ask","canvas_confirm"],
-    triggers: ["preguntame","ask me","formulario","form","confirmame","confirm","necesito ingresar datos","need to enter data","dialogo","dialog","input del usuario","user input","seleccionar opcion","select option"],
+    name: "capability_discovery",
+    description: `Core discovery skill - find any capability with a single keyword`,
+    category: "core",
+    version: "1.2.0",
+    tools: ["search_knowledge"],
+    triggers: ["cómo busco herramientas","cómo encuentro skills","how to find tools","search knowledge","discovery","buscar en la base","encontrar herramientas"],
     body: `
-# Canvas Interact Skill
-
-## Cuándo se Activa
-
-Para recoger input del usuario mediante formularios interactivos o confirmaciones.
-
-## Herramientas Disponibles
+# capability_discovery — Sistema de Discovery
 
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`canvas_ask\` | Muestra formulario | Input multi-campo |
-| \`canvas_confirm\` | Diálogo confirmación | Yes/No decisions |
+Arrancás con 7 herramientas esenciales. Todo lo demás se descubre con **search_knowledge**.
 
-## Workflow
+## Regla de oro: UNA PALABRA, busca TODO
 
-### Confirmación Simple
-\`\`\`javascript
-canvas_confirm({
-  message: "¿Eliminar archivo?",
-  confirmLabel: "Sí, eliminar",
-  cancelLabel: "Cancelar"
-})
 \`\`\`
-
-### Formulario Complejo
-\`\`\`javascript
-canvas_ask({
-  title: "User Registration",
-  fields: [
-    { name: "email", label: "Email", type: "email", required: true },
-    { name: "password", label: "Password", type: "password", required: true },
-    { 
-      name: "role", 
-      label: "Role", 
-      type: "select", 
-      options: [
-        { label: "Admin", value: "admin" },
-        { label: "User", value: "user" }
-      ]
-    }
-  ]
-})
+search_knowledge(query="email")
 \`\`\`
 
-## Tipos de Campo
+Eso solo — sin type, sin frases largas — devuelve tools, skills, MCP y playbook relacionados con "email".
 
-| Type | Uso |
-|------|-----|
-| \`text\` | Texto libre |
-| \`email\` | Email con validación |
-| \`password\` | Contraseña (oculto) |
-| \`number\` | Números |
-| \`select\` | Dropdown con opciones |
-| \`checkbox\` | Booleano |
-| \`textarea\` | Texto multilínea |
+**Evitá esto:** \`search_knowledge(type="tools", query="enviar correo electrónico")\` — el motor rankea por relevancia (BM25), así que una frase larga no falla, pero diluye el resultado: cada palabra de más sesga el ranking hacia coincidencias parciales y mezcla resultados menos relevantes.
 
-## Mejores Prácticas
-
-- Labels claros y descriptivos
-- Placeholders con ejemplos
-- Marcar required explícitamente
-- Validar tipos (email, number)
-- Manejar cancel gracefully
+**Preferí esto:** \`search_knowledge(query="email")\` — una palabra precisa da el resultado más ajustado y encuentra todo lo relacionado.
 
-## Errores a Evitar
+## Cuándo especificar type
 
-- ❌ Labels vagos sin contexto
-- ❌ No marcar required fields
-- ❌ Sin validación de tipo
-- ❌ No manejar cancel
-`,
-  },
-  {
-    name: "canvas_dashboard",
-    description: `Real-time visual dashboard for monitoring task status, progress, and system state`,
-    category: "canvas",
-    version: "1.0.0",
-    tools: ["canvas_render","canvas_show_progress","canvas_clear"],
-    triggers: ["mostrá el dashboard","show dashboard","estado en tiempo real","real-time status","monitoreo visual","visual monitoring","panel de control","control panel","limpiá el canvas","clear canvas","actualizá el dashboard","update dashboard"],
-    body: `
-# Canvas Dashboard Skill
+Solo si querés filtrar resultados que ya son muchos:
 
-## Cuándo se Activa
+\`\`\`
+search_knowledge(query="email", type="mcp")   → solo herramientas externas de email
+search_knowledge(query="email", type="tools") → solo herramientas nativas de email
+\`\`\`
 
-Para mostrar dashboards visuales de monitoreo en tiempo real de tareas, proyectos, o estado del sistema.
+Por defecto type="all" — no hace falta especificarlo.
 
-## Herramientas Disponibles
+## Regla de prioridad
 
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`canvas_render\` | Renderiza componentes | Layout del dashboard |
-| \`canvas_show_progress\` | Barras de progreso | Estado de tasks |
-| \`canvas_clear\` | Limpia canvas | Antes de nuevo dashboard |
+**Preferí herramientas nativas sobre MCP** cuando ambas sirven.
+- Nativas: más rápidas, sin red, siempre disponibles
+- MCP: cuando no hay equivalente nativo
 
-## Workflow
+## Flujo de uso
 
-1. **Clear** → \`canvas_clear()\` — limpiar previo
-2. **Render layout** → \`canvas_render({ sections })\`
-3. **Update progress** → \`canvas_show_progress()\` en tiempo real
-4. **Refresh** → \`canvas_render({ updates })\` para cambios
+1. Identificá la palabra clave de lo que necesitás
+2. \`search_knowledge(query="<palabra>")\` → resultados de todos los tipos
+3. Cada resultado MCP incluye \`server_id\`; usalo para identificar la integración y buscar un especialista existente
+4. Antes del primer uso de un servidor sin especialista, seguí el flujo de consentimiento del system prompt
+5. Las tools encontradas se inyectan automáticamente en tu contexto para una ejecución directa solo cuando corresponda
 
-## Estructura de Dashboard
+---
 
-\`\`\`javascript
-canvas_render({
-  component: {
-    id: "dashboard-main",
-    type: "markdown",
-    props: { content: "## Dashboard\\n..." },
-    span: "full"   // ← ancho completo del canvas
-  }
-})
+## Ejemplos
 
-// O con tarjetas individuales:
-canvas_show_card({ title: "Métricas", span: "full", items: [...] })
-canvas_show_progress({ tasks: [...], span: "full" })
 \`\`\`
-
-## Color Coding
-
-| Color | Estado |
-|-------|--------|
-| 🟢 Verde | Complete |
-| 🔵 Azul | In Progress |
-| 🔴 Rojo | Error/Blocked |
-| 🟡 Amarillo | Pending |
-
-## Mejores Prácticas
-
-- Clear antes de renderizar nuevo dashboard
-- Layout consistente (header, progress, status, metrics)
-- Update en tiempo real con progreso
-- Solo información crítica (no sobrecargar)
-
-## Errores a Evitar
-
-- ❌ No clear entre dashboards (clutter)
-- ❌ Demasiada información (sobrecarga visual)
-- ❌ No actualizar en tiempo real
-- ❌ Sin color coding para estados
+search_knowledge(query="pdf")       → tools para leer/escribir PDFs
+search_knowledge(query="browser")   → tools de navegación web
+search_knowledge(query="github")    → tools MCP de GitHub si están configuradas
+search_knowledge(query="calendar")  → tools de Google Calendar
+search_knowledge(query="A2UI")      → skills del panel interactivo
+search_knowledge(query="slack")     → tools de Slack si están configuradas
+\`\`\`
 `,
   },
   {
     name: "a2ui_form",
     description: `Create rich interactive forms using A2UI v0.9 protocol with validation, data binding, and multi-step flows`,
-    category: "canvas",
+    category: "a2ui",
     version: "1.0.0",
     tools: ["a2ui_create_surface","a2ui_update_components","a2ui_update_data_model","a2ui_delete_surface"],
     triggers: ["crear formulario A2UI","create A2UI form","formulario interactivo A2UI","A2UI form","pedir datos con A2UI","collect data A2UI","formulario con validación","form with validation","formulario multi-paso","multi-step form A2UI","form dinámico A2UI","dynamic form A2UI"],
@@ -1341,12 +1240,13 @@ a2ui_update_data_model(surfaceId: "contact_form", path: "/form", value: {name: "
 - Agregar \`checks\` para validación de campos obligatorios
 - Usar \`variant: "primary"\` para botones principales
 - Eliminar surfaces con \`a2ui_delete_surface\` al terminar
-- Preferir A2UI forms sobre \`canvas_ask\` para formularios complejos con validación`,
+- Usar formularios A2UI para toda captura estructurada de datos
+`,
   },
   {
     name: "a2ui_dashboard",
     description: `Create real-time interactive dashboards using A2UI v0.9 protocol with dynamic data binding and live updates`,
-    category: "canvas",
+    category: "a2ui",
     version: "1.0.0",
     tools: ["a2ui_create_surface","a2ui_update_components","a2ui_update_data_model","a2ui_delete_surface"],
     triggers: ["dashboard A2UI","panel de control A2UI","A2UI dashboard","mostrar métricas A2UI","A2UI metrics","dashboard interactivo A2UI","interactive dashboard","A2UI dashboard en tiempo real","real-time dashboard A2UI","mostrar datos A2UI","visualizar datos con A2UI"],
@@ -1421,12 +1321,13 @@ a2ui_update_data_model(surfaceId: "dash", path: "/", value: {metrics: {completio
 - Usar \`usageHint: "caption"\` para labels, \`"h1"/"h2"\` para valores
 - Bind todos los valores dinámicos con \`{ path: "/..." }\`
 - Actualizar métricas con \`a2ui_update_data_model\` path específico
-- Eliminar surfaces al terminar para evitar memory leaks`,
+- Eliminar surfaces al terminar para evitar memory leaks
+`,
   },
   {
     name: "a2ui_interactive",
     description: `Create multi-step interactive workflows using A2UI v0.9 protocol with tabs, modals, choice pickers, and dynamic updates based on user actions`,
-    category: "canvas",
+    category: "a2ui",
     version: "1.0.0",
     tools: ["a2ui_create_surface","a2ui_update_components","a2ui_update_data_model","a2ui_delete_surface"],
     triggers: ["interfaz interactiva A2UI","A2UI interactive UI","flujo A2UI","A2UI workflow","asistente A2UI","A2UI assistant","wizard A2UI","flujo multi-paso A2UI","multi-step flow A2UI","workflow interactivo","interactive workflow","asistente paso a paso","step-by-step assistant","A2UI con tabs y modales"],
@@ -1509,7 +1410,7 @@ Para crear flujos interactivos multi-paso usando A2UI v0.9. Usar cuando se neces
     variant: "mutuallyExclusive",
     options: [
       {label: "Consulta General", value: "general"},
-      {label: "Especializada", value: "specialist"},
+      {label: "Especializada", value: "specialized"},
       {label: "Urgencia", value: "urgent"}
     ],
     value: {path: "/data/serviceType"},
@@ -1528,1855 +1429,7 @@ Para crear flujos interactivos multi-paso usando A2UI v0.9. Usar cuando se neces
 - Usar \`a2ui_update_components\` para cambiar la UI entre pasos
 - Agregar validación con \`checks\` en TextField
 - Mantener el estado del flujo en el data model (\`/data/step\`, \`/data/serviceType\`, etc.)
-- Eliminar surfaces con \`a2ui_delete_surface\` al completar o cancelar`,
-  },
-  {
-    name: "code_generate",
-    description: `Generate new code using external CLI subagents (Claude Code, Qwen, Gemini, OpenCode) via Code Bridge`,
-    category: "codebridge",
-    version: "1.0.0",
-    tools: ["codebridge_launch","codebridge_status","fs_write","fs_read"],
-    triggers: ["generá código","generate code","creá el código","create code","escribí el código","write code","implementá desde cero","implement from scratch","nuevo archivo","new file","crear módulo","create module","código nuevo","new code"],
-    body: `
-# Code Generate Skill
-
-## Cuándo se Activa
-
-Esta skill se activa cuando el usuario necesita crear código nuevo desde cero: archivos, módulos, funciones, componentes, endpoints, etc.
-
-## Herramientas Disponibles
-
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`codebridge_launch\` | Lanza subagente CLI para generar código | Generación de código nuevo |
-| \`codebridge_status\` | Verifica estado de generación | Monitoreo de progreso |
-| \`fs_read\` | Lee archivos generados | Verificación de calidad |
-| \`fs_write\` | Guarda código en workspace | Si el subagente no lo hace automáticamente |
-
-## Workflow
-
-### Generación de Código
-\`\`\`javascript
-// 1. Clarificar requisitos
-// - Lenguaje: TypeScript, Python, etc.
-// - Framework: React, Express, FastAPI, etc.
-// - Funcionalidad específica
-// - Constraints: estilo, patrones, etc.
-
-// 2. Lanzar subagente
-const { process_id } = codebridge_launch({
-  cli: "qwen",
-  prompt: \`
-    Generate TypeScript function for email validation:
-    - Use regex pattern
-    - Handle edge cases
-    - Include JSDoc comments
-    - Export as named function
-  \`
-})
-
-// 3. Monitorear
-const status = codebridge_status({ process_id })
-
-// 4. Verificar código generado
-const code = fs_read({ path: "src/utils/validateEmail.ts" })
-
-// 5. Reportar resultado
-\`\`\`
-
-## Subagentes Disponibles - Configuración por CLI
-
-### Qwen CLI (Rápido)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "gen-001",
-  config: {
-    role: "development",
-    cli: "qwen",
-    args: ["--non-interactive"],  // Flag por defecto
-    cwd: "/path/to/project",      // Carpeta del proyecto
-    timeoutSeconds: 180,          // 3 minutos
-  },
-  prompt: \`Generate a utility function to...\`
-})
-\`\`\`
-**Ideal para:** Funciones utilitarias, código rápido, bug fixes
-
-### Claude Code (Complejo)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "gen-002",
-  config: {
-    role: "development",
-    cli: "claude",
-    args: ["--no-approve", "--output-format", "stream"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 300,  // 5 minutos - análisis profundo
-  },
-  prompt: \`Design and implement a complete authentication module with JWT...\`
-})
-\`\`\`
-**Ideal para:** Arquitectura compleja, refactorización, security review
-
-### Gemini CLI (Docs + Código)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "gen-003",
-  config: {
-    role: "development",
-    cli: "gemini",
-    args: ["-y", "--quiet"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 240,
-  },
-  prompt: \`Create a REST API endpoint with full JSDoc documentation...\`
-})
-\`\`\`
-**Ideal para:** Código + documentación, multi-lenguaje, tests
-
-### OpenCode (Open Source)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "gen-004",
-  config: {
-    role: "development",
-    cli: "opencode",
-    args: ["--headless", "--auto-accept"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 200,
-  },
-  prompt: \`Scaffold an open source library structure with...\`
-})
-\`\`\`
-**Ideal para:** Scaffolding, prototipado rápido, patrones community-driven
-
-## Tabla Comparativa de CLIs
-
-| CLI | Timeout | stdin Close | Approval Flag | Mejor Caso de Uso |
-|-----|---------|-------------|---------------|-------------------|
-| **qwen** | 180s | ✅ Sí | N/A | Código rápido |
-| **claude** | 300s | ❌ No | \`--no-approve\` | Arquitectura compleja |
-| **gemini** | 240s | ❌ No | \`-y\` | Código + docs |
-| **opencode** | 200s | ❌ No | \`--auto-accept\` | Open source |
-
-## Ejemplos Detallados
-
-### Ejemplo 1: Función Utilitaria con Qwen
-\`\`\`typescript
-// Usuario: "generá una función para validar emails"
-codebridge_launch({
-  taskId: "validate-email-001",
-  config: {
-    role: "development",
-    cli: "qwen",
-    cwd: process.cwd(),
-    timeoutSeconds: 120,
-  },
-  prompt: \`
-    Generate TypeScript function for email validation.
-    Requirements:
-    - Use regex pattern matching
-    - Handle edge cases (null, undefined, empty)
-    - Include JSDoc comments
-    - Export as named function: validateEmail
-    
-    Expected behavior:
-    validateEmail("test@example.com") → true
-    validateEmail("") → false
-    validateEmail(null) → false
-  \`
-})
-\`\`\`
-
-### Ejemplo 2: Componente React con Claude
-\`\`\`typescript
-// Usuario: "creá un componente Button con TypeScript"
-codebridge_launch({
-  taskId: "button-component-002",
-  config: {
-    role: "development",
-    cli: "claude",
-    cwd: "/path/to/react-project",
-    timeoutSeconds: 300,
-  },
-  prompt: \`
-    Create a reusable Button component in React with TypeScript.
-    
-    Requirements:
-    - Props: label, onClick, variant (primary|secondary), disabled, loading
-    - Use Tailwind CSS for styling
-    - Include loading spinner animation
-    - Accessible (ARIA attributes)
-    - Unit test example with Jest
-    
-    File: src/components/Button.tsx
-  \`
-})
-\`\`\`
-
-### Ejemplo 3: API Endpoint con Gemini
-\`\`\`typescript
-// Usuario: "creá un endpoint de registro de usuarios"
-codebridge_launch({
-  taskId: "register-endpoint-003",
-  config: {
-    role: "development",
-    cli: "gemini",
-    cwd: "/path/to/api-project",
-    timeoutSeconds: 240,
-  },
-  prompt: \`
-    Create Express.js REST endpoint for user registration.
-    
-    Requirements:
-    - POST /api/auth/register
-    - Input validation (email, password min 8 chars)
-    - Password hashing with bcrypt
-    - JWT token generation
-    - Error handling
-    - Full JSDoc documentation
-    - Example curl request
-    
-    File: src/routes/auth.ts
-  \`
-})
-\`\`\`
-
-## Variables de Entorno Requeridas
-
-| CLI | Variable | Cómo obtener |
-|-----|----------|--------------|
-| claude | \`ANTHROPIC_API_KEY\` | https://console.anthropic.com |
-| gemini | \`GOOGLE_API_KEY\` | https://makersuite.google.com/app/apikey |
-| qwen | — | No requiere |
-| opencode | — | No requiere |
-
-## Mejores Prácticas
-
-### ✅ DOs
-- Especificar lenguaje y framework explícitamente
-- Incluir ejemplos de input/output esperado
-- Definir constraints (estilo, patrones, convenciones)
-- Verificar código generado con \`fs_read\`
-- Proveer instrucciones de uso claras
-
-### ❌ DON'Ts
-- ❌ Prompts vagos ("hacé código")
-- ❌ No especificar lenguaje/framework
-- ❌ Olidar verificar calidad del código
-- ❌ Entregar sin instrucciones de uso
-- ❌ Ignorar errores de compilación/lint
-
-## Manejo de Errores
-
-### Error: "Missing environment variables"
-\`\`\`typescript
-// Verificar antes de lanzar
-if (!process.env.ANTHROPIC_API_KEY) {
-  throw new Error("ANTHROPIC_API_KEY required for Claude Code");
-}
-\`\`\`
-
-### Error: "Process exited with code 1"
-- Verificar stdout/stderr en busca de mensajes de error
-- Reintentar con otro CLI si corresponde
-- Simplificar el prompt y reintentar
-
-### Error: Timeout
-- Aumentar \`timeoutSeconds\` en config
-- Dividir tarea en subtareas más pequeñas
-- Usar CLI más rápido (Qwen para tareas simples)
-
-## Errores a Evitar
-
-- ❌ Prompts vagos ("hacé código")
-- ❌ No especificar lenguaje/framework
-- ❌ No verificar calidad del código
-- ❌ Entregar sin instrucciones de uso
-- ❌ Ignorar variables de entorno requeridas
-`,
-  },
-  {
-    name: "code_refactor",
-    description: `Refactor existing code to improve structure, performance, and maintainability using CLI subagents`,
-    category: "codebridge",
-    version: "1.0.0",
-    tools: ["codebridge_launch","codebridge_status","fs_read","fs_edit","fs_write"],
-    triggers: ["refactorizá el código","refactor code","mejorá el código","improve code","optimizá este archivo","optimize this file","hacé el código más limpio","make code cleaner","reestructurá","restructure","mejorá la performance","improve performance","limpieza de código","code cleanup"],
-    body: `
-# Code Refactor Skill
-
-## Cuándo se Activa
-
-Esta skill se activa cuando el usuario necesita mejorar código existente: limpiar, optimizar, reestructurar, o hacer más mantenible.
-
-## Herramientas Disponibles
-
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`fs_read\` | Lee código existente | Análisis inicial |
-| \`codebridge_launch\` | Lanza subagente para refactorizar | Refactorización real |
-| \`codebridge_status\` | Verifica estado | Monitoreo |
-| \`fs_edit\` | Aplica cambios específicos | Cambios puntuales |
-| \`fs_write\` | Guarda código refactorizado | Si hay nuevos archivos |
-
-## Workflow
-
-### Refactorización
-\`\`\`javascript
-// 1. Leer código existente
-const code = fs_read({ path: "src/legacy.ts" })
-
-// 2. Analizar áreas de mejora
-// - Funciones muy largas (>50 líneas)
-// - Duplicación de lógica
-// - Nombres poco claros
-// - Complejidad ciclomática alta
-// - Performance issues
-
-// 3. Lanzar subagente con foco específico
-const { process_id } = codebridge_launch({
-  cli: "claude",
-  prompt: \`
-    Refactor this TypeScript code:
-    - Extract functions longer than 30 lines
-    - Rename variables for clarity
-    - Apply DRY principle
-    - Add JSDoc comments
-    - Maintain exact functionality
-  \`
-})
-
-// 4. Verificar resultado
-const refactored = fs_read({ path: "src/refactored.ts" })
-
-// 5. Comparar y resumir cambios
-\`\`\`
-
-## Áreas Comunes de Refactorización
-
-| Área | Técnicas |
-|------|----------|
-| Legibilidad | Nombres claros, funciones cortas, comentarios |
-| DRY | Extraer funciones, eliminar duplicación |
-| Performance | Algoritmos eficientes, caching, lazy loading |
-| Mantenibilidad | Interfaces claras, separación de concerns |
-| Testing | Hacer código testable, inyección de dependencias |
-
-## Configuración por CLI para Refactorización
-
-### Claude Code (Refactorización Compleja)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "refactor-001",
-  config: {
-    role: "development",
-    cli: "claude",
-    args: ["--no-approve", "--output-format", "stream"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 300,  // 5 minutos - análisis profundo
-  },
-  prompt: \`
-    Refactor this authentication module:
-    - Current: 400 lines, single file
-    - Issues: No separation of concerns, hard to test
-    - Goal: Split into controller, service, repository
-    - Add dependency injection for testability
-    - Maintain backward compatible API
-  \`
-})
-\`\`\`
-**Ideal para:** Refactorización arquitectónica, patrones de diseño, gran escala
-
-### Qwen CLI (Limpieza Rápida)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "refactor-002",
-  config: {
-    role: "development",
-    cli: "qwen",
-    args: ["--non-interactive"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 120,  // 2 minutos
-  },
-  prompt: \`
-    Clean up this function:
-    - Rename variables: x, y, z → descriptive names
-    - Extract helper functions (lines 45-89)
-    - Add early returns to reduce nesting
-    - Keep same functionality
-  \`
-})
-\`\`\`
-**Ideal para:** Limpieza rápida, rename variables, funciones cortas
-
-### Gemini CLI (Refactor + Docs)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "refactor-003",
-  config: {
-    role: "development",
-    cli: "gemini",
-    args: ["-y", "--quiet"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 240,
-  },
-  prompt: \`
-    Refactor this API client with full documentation:
-    - Add retry logic with exponential backoff
-    - Implement request/response interceptors
-    - Add comprehensive JSDoc comments
-    - Include usage examples in docs
-  \`
-})
-\`\`\`
-**Ideal para:** Refactor + documentación, API clients
-
-### OpenCode (Patrones Open Source)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "refactor-004",
-  config: {
-    role: "development",
-    cli: "opencode",
-    args: ["--headless", "--auto-accept"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 200,
-  },
-  prompt: \`
-    Refactor to follow open source best practices:
-    - Add input validation at module boundaries
-    - Implement error codes for programmatic handling
-    - Add logging hooks for debugging
-    - Follow community conventions
-  \`
-})
-\`\`\`
-**Ideal para:** Patrones community-driven, librerías públicas
-
-## Tabla Comparativa de CLIs para Refactor
-
-| CLI | Timeout | Mejor Para | Ejemplo |
-|-----|---------|------------|---------|
-| **claude** | 300s | Arquitectura, patrones | Split monolith |
-| **qwen** | 120s | Limpieza rápida | Rename, extract |
-| **gemini** | 240s | Refactor + docs | API client |
-| **opencode** | 200s | Open source patterns | Public libraries |
-
-## Ejemplos Detallados
-
-### Ejemplo 1: Extraer Funciones con Qwen
-\`\`\`typescript
-// Usuario: "hacé esta función más legible"
-codebridge_launch({
-  taskId: "refactor-legible-001",
-  config: {
-    role: "development",
-    cli: "qwen",
-    cwd: process.cwd(),
-    timeoutSeconds: 120,
-  },
-  prompt: \`
-    Refactor this 80-line function to improve readability:
-    
-    File: src/orderProcessor.ts
-    
-    Tasks:
-    1. Extract validation logic (lines 5-25)
-    2. Extract pricing calculation (lines 30-60)
-    3. Extract notification sending (lines 65-80)
-    4. Add descriptive function names
-    5. Maintain exact same behavior
-    
-    Each extracted function should be < 25 lines.
-  \`
-})
-\`\`\`
-
-### Ejemplo 2: Separación de Concerns con Claude
-\`\`\`typescript
-// Usuario: "separá la lógica de negocio del controller"
-codebridge_launch({
-  taskId: "refactor-soc-002",
-  config: {
-    role: "development",
-    cli: "claude",
-    cwd: "/path/to/project",
-    timeoutSeconds: 300,
-  },
-  prompt: \`
-    Refactor this Express controller to follow clean architecture:
-    
-    Current issues:
-    - Business logic mixed with HTTP handling
-    - Direct database calls in controller
-    - Hard to test (requires HTTP server)
-    
-    Goal:
-    1. Create UserService class (business logic)
-    2. Create UserRepository (data access)
-    3. Keep controller thin (HTTP only)
-    4. Add dependency injection
-    5. Maintain same API endpoints
-    
-    Files to create:
-    - src/services/UserService.ts
-    - src/repositories/UserRepository.ts
-    - src/controllers/UserController.ts (refactored)
-  \`
-})
-\`\`\`
-
-### Ejemplo 3: Optimización de Performance con Gemini
-\`\`\`typescript
-// Usuario: "optimizá esta función que es lenta"
-codebridge_launch({
-  taskId: "refactor-perf-003",
-  config: {
-    role: "development",
-    cli: "gemini",
-    cwd: "/path/to/project",
-    timeoutSeconds: 240,
-  },
-  prompt: \`
-    Optimize this function for performance:
-    
-    File: src/dataProcessor.ts
-    Current issues:
-    - O(n²) nested loop (lines 15-40)
-    - Repeated array filtering
-    - No caching of computed values
-    
-    Requirements:
-    1. Reduce to O(n) or O(n log n)
-    2. Add memoization for expensive calculations
-    3. Use Map/Set for O(1) lookups
-    4. Add JSDoc with complexity analysis
-    5. Include before/after benchmark example
-  \`
-})
-\`\`\`
-
-## Mejores Prácticas
-
-### ✅ DOs
-- Entender código antes de tocar
-- Cambios incrementales, no rewrites completos
-- Mantener tests pasando
-- Documentar cambios estructurales grandes
-- Preservar backward compatibility
-- Medir mejora (performance, líneas, complejidad)
-
-### ❌ DON'Ts
-- ❌ Refactorizar sin entender funcionalidad
-- ❌ Cambiar comportamiento sin avisar
-- ❌ Hacer cambios muy grandes de una vez
-- ❌ No verificar tests después de refactorizar
-- ❌ Romper API pública sin versión mayor
-
-## Métricas de Refactorización
-
-| Métrica | Antes | Después | Mejora |
-|---------|-------|---------|--------|
-| Líneas de código | 400 | 250 | -37% |
-| Funciones > 30 líneas | 8 | 2 | -75% |
-| Complejidad ciclomática | 45 | 22 | -51% |
-| Tiempo de tests | 120s | 85s | -29% |
-| Coverage | 65% | 82% | +26% |
-
-## Manejo de Errores
-
-### Error: "Functionality changed after refactor"
-- Siempre verificar tests después de refactorizar
-- Usar \`fs_read\` para comparar before/after
-- Mantener backup del código original
-
-### Error: "Timeout during large refactor"
-- Dividir en múltiples tareas más pequeñas
-- Usar Claude con timeout extendido (600s)
-- Refactorizar por módulos, no todo junto
-
-## Errores a Evitar
-
-- ❌ Refactorizar sin entender funcionalidad
-- ❌ Cambiar comportamiento sin avisar
-- ❌ Hacer cambios muy grandes de una vez
-- ❌ No verificar tests después de refactorizar
-- ❌ No documentar cambios estructurales
-`,
-  },
-  {
-    name: "code_review",
-    description: `Review code quality, identify issues, and provide actionable feedback using CLI subagents`,
-    category: "codebridge",
-    version: "1.0.0",
-    tools: ["codebridge_launch","codebridge_status","fs_read","canvas_show_card"],
-    triggers: ["revisá el código","review code","hacé un code review","do a code review","encontrá problemas en el código","find issues in code","verificá la calidad","check quality","buscá bugs","find bugs","análisis de código","code analysis","mejores prácticas","best practices"],
-    body: `
-# Code Review Skill
-
-## Cuándo se Activa
-
-Esta skill se activa cuando el usuario necesita revisión de código: encontrar bugs, verificar calidad, seguridad, performance, o adherence a best practices.
-
-## Herramientas Disponibles
-
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`fs_read\` | Lee archivos de código | Cargar código a revisar |
-| \`codebridge_launch\` | Lanza subagente para review | Análisis profundo |
-| \`codebridge_status\` | Obtiene resultado del review | Completado del análisis |
-| \`canvas_show_card\` | Muestra resultados estructurados | Presentar feedback |
-
-## Workflow
-
-### Code Review
-\`\`\`javascript
-// 1. Leer código
-const files = fs_read({ path: "src/*.ts" })
-
-// 2. Lanzar review con subagente
-const { process_id } = codebridge_launch({
-  cli: "claude",
-  prompt: \`
-    Code Review Checklist:
-    1. Bugs potenciales (null checks, edge cases)
-    2. Security issues (XSS, injection, auth)
-    3. Performance (loops, queries, memory)
-    4. Readability (naming, structure)
-    5. TypeScript best practices
-    6. Testing coverage
-
-    Proporcionar línea específica para cada issue.
-  \`
-})
-
-// 3. Obtener resultado
-const review = codebridge_status({ process_id })
-
-// 4. Organizar por severidad
-// Critical: Bugs, security
-// Major: Performance, anti-patterns
-// Minor: Naming, style
-// Nitpick: Suggestions
-
-// 5. Mostrar resultados
-canvas_show_card({
-  title: "Code Review",
-  items: [
-    { label: "Critical", value: "2 issues" },
-    { label: "Major", value: "5 issues" },
-    { label: "Minor", value: "8 issues" }
-  ]
-})
-\`\`\`
-
-## Categorías de Review
-
-| Categoría | Qué buscar |
-|-----------|------------|
-| Bugs | Null dereference, off-by-one, race conditions |
-| Security | XSS, SQL injection, auth bypass, secrets |
-| Performance | N+1 queries, O(n²) loops, memory leaks |
-| Readability | Nombres confusos, funciones largas |
-| Best Practices | Linting, patterns, conventions |
-| Testing | Coverage, edge cases, mocks |
-
-## Niveles de Severidad
-
-| Nivel | Ejemplo | Acción |
-|-------|---------|--------|
-| Critical | Bug de seguridad, crash | Fix inmediato |
-| Major | Performance issue, anti-pattern | Fix antes de merge |
-| Minor | Naming, style | Fix cuando sea posible |
-| Nitpick | Sugerencia opcional | Considerar |
-
-## Configuración por CLI para Code Review
-
-### Claude Code (Review Exhaustivo)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "review-001",
-  config: {
-    role: "development",
-    cli: "claude",
-    args: ["--no-approve", "--output-format", "stream"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 300,  // 5 minutos - review profundo
-  },
-  prompt: \`
-    Comprehensive code review for PR #42:
-    
-    Files: src/auth/*.ts (5 files, ~600 lines)
-    
-    Review checklist:
-    1. Security vulnerabilities (OWASP Top 10)
-    2. Authentication/authorization bugs
-    3. Input validation gaps
-    4. Error handling completeness
-    5. TypeScript type safety
-    6. Test coverage gaps
-    
-    For each issue:
-    - Line number
-    - Severity (Critical/Major/Minor)
-    - Description
-    - Suggested fix
-  \`
-})
-\`\`\`
-**Ideal para:** Security review, PRs críticos, auditorías
-
-### Qwen CLI (Review Rápido)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "review-002",
-  config: {
-    role: "development",
-    cli: "qwen",
-    args: ["--non-interactive"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 120,  // 2 minutos
-  },
-  prompt: \`
-    Quick review of this utility function:
-    
-    File: src/utils/formatDate.ts (45 lines)
-    
-    Check for:
-    - Edge cases (null, undefined, invalid input)
-    - TypeScript types
-    - Performance issues
-    - Code style consistency
-    
-    Return issues with line numbers.
-  \`
-})
-\`\`\`
-**Ideal para:** Funciones pequeñas, cambios rápidos, style check
-
-### Gemini CLI (Review + Docs)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "review-003",
-  config: {
-    role: "development",
-    cli: "gemini",
-    args: ["-y", "--quiet"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 240,
-  },
-  prompt: \`
-    Review this API module and suggest documentation improvements:
-    
-    File: src/api/users.ts
-    
-    Review:
-    1. JSDoc completeness
-    2. Parameter documentation
-    3. Return type descriptions
-    4. Example usage
-    5. Error documentation
-    
-    Also check for:
-    - Bugs
-    - Type safety
-    - Error handling
-  \`
-})
-\`\`\`
-**Ideal para:** Review + documentación, APIs públicas
-
-## Tabla Comparativa de CLIs para Review
-
-| CLI | Timeout | Mejor Para | Ejemplo |
-|-----|---------|------------|---------|
-| **claude** | 300s | Security, auditorías | OWASP checklist |
-| **qwen** | 120s | Review rápido | Functions < 50 lines |
-| **gemini** | 240s | Review + docs | API documentation |
-
-## Ejemplos Detallados
-
-### Ejemplo 1: Security Review con Claude
-\`\`\`typescript
-// Usuario: "revisá este código en busca de vulnerabilidades"
-codebridge_launch({
-  taskId: "security-review-001",
-  config: {
-    role: "development",
-    cli: "claude",
-    cwd: "/path/to/project",
-    timeoutSeconds: 300,
-  },
-  prompt: \`
-    Security-focused code review:
-    
-    Files: 
-    - src/auth/login.ts
-    - src/auth/register.ts
-    - src/middleware/auth.ts
-    
-    Check for OWASP Top 10 vulnerabilities:
-    1. SQL Injection (raw queries?)
-    2. XSS (unescaped output?)
-    3. CSRF (missing tokens?)
-    4. Authentication flaws
-    5. Sensitive data exposure
-    6. XXE, SSRF, etc.
-    
-    For each finding:
-    - Severity: Critical/High/Medium/Low
-    - CWE reference if applicable
-    - Exploit scenario
-    - Remediation with code example
-  \`
-})
-\`\`\`
-
-### Ejemplo 2: Quick Review con Qwen
-\`\`\`typescript
-// Usuario: "revisá esta función rápida"
-codebridge_launch({
-  taskId: "quick-review-002",
-  config: {
-    role: "development",
-    cli: "qwen",
-    cwd: process.cwd(),
-    timeoutSeconds: 90,
-  },
-  prompt: \`
-    Quick code review:
-    
-    File: src/helpers/parseJson.ts
-    
-    Function: parseJson safely handles JSON parsing
-    
-    Check:
-    - Try/catch for invalid JSON
-    - Type guards for parsed result
-    - Null/undefined handling
-    - TypeScript types
-    
-    Return any issues with specific line numbers.
-  \`
-})
-\`\`\`
-
-### Ejemplo 3: PR Review con Gemini
-\`\`\`typescript
-// Usuario: "revisá este PR antes de merge"
-codebridge_launch({
-  taskId: "pr-review-003",
-  config: {
-    role: "development",
-    cli: "gemini",
-    cwd: "/path/to/project",
-    timeoutSeconds: 240,
-  },
-  prompt: \`
-    Pre-merge code review for PR #156:
-    
-    Changes:
-    - Added user profile endpoint
-    - Modified database schema
-    - Updated validation logic
-    
-    Review criteria:
-    1. Does it work? (logic correctness)
-    2. Is it safe? (security, validation)
-    3. Is it clean? (readability, DRY)
-    4. Is it tested? (unit tests, edge cases)
-    5. Is it documented? (JSDoc, comments)
-    
-    Format output as GitHub review comment.
-  \`
-})
-\`\`\`
-
-## Checklist de Review por Categoría
-
-### Security Checklist
-- [ ] Input validation en todos los endpoints
-- [ ] Output encoding para prevenir XSS
-- [ ] Prepared statements (no SQL injection)
-- [ ] CSRF tokens en forms
-- [ ] Rate limiting en APIs sensibles
-- [ ] No secrets en código/logs
-- [ ] Authentication checks en rutas protegidas
-
-### Performance Checklist
-- [ ] No N+1 queries
-- [ ] Indexes en DB queries
-- [ ] Caching donde aplica
-- [ ] No blocking operations en event loop
-- [ ] Memory leaks (listeners, intervals)
-- [ ] Efficient data structures
-
-### TypeScript Checklist
-- [ ] No \`any\` types (usar interfaces)
-- [ ] Union types para valores nullable
-- [ ] Type guards para runtime checks
-- [ ] Generic types donde aplica
-- [ ] Strict mode habilitado
-
-### Testing Checklist
-- [ ] Unit tests para lógica crítica
-- [ ] Edge cases cubiertos
-- [ ] Error scenarios testeados
-- [ ] Mock de dependencias externas
-- [ ] Coverage > 80%
-
-## Mejores Prácticas
-
-### ✅ DOs
-- Feedback específico con líneas
-- Sugerencias accionables
-- Balance: issues + aspectos positivos
-- Contexto: prod vs prototype
-- Priorizar por severidad
-
-### ❌ DON'Ts
-- ❌ Crítica sin sugerencias
-- ❌ Issues vagos sin línea específica
-- ❌ Ignorar contexto del proyecto
-- ❌ Solo criticar, no destacar lo bueno
-- ❌ No priorizar issues
-
-## Manejo de Errores
-
-### Error: "Review too large for single prompt"
-- Dividir por archivos
-- Usar Claude con contexto extendido
-- Hacer review por categorías (security, performance, etc.)
-
-### Error: "False positive in review"
-- Verificar contexto completo del código
-- Considerar trade-offs del diseño
-- Ajustar prompt para ser más específico
-
-## Errores a Evitar
-
-- ❌ Crítica sin sugerencias
-- ❌ Issues vagos sin línea específica
-- ❌ Ignorar contexto del proyecto
-- ❌ Solo criticar, no destacar lo bueno
-- ❌ No priorizar por severidad
-`,
-  },
-  {
-    name: "code_debug",
-    description: `Debug and fix code errors by analyzing stack traces, identifying root causes, and applying fixes using CLI subagents`,
-    category: "codebridge",
-    version: "1.0.0",
-    tools: ["codebridge_launch","codebridge_status","fs_read","fs_edit","cli_exec"],
-    triggers: ["debugueá el código","debug code","arreglá el error","fix error","encontrá el bug","find bug","por qué falla","why it fails","stack trace","error en el código","code error","no funciona","not working","excepción","exception"],
-    body: `
-# Code Debug Skill
-
-## Cuándo se Activa
-
-Esta skill se activa cuando hay errores en el código: exceptions, bugs, tests fallando, comportamientos inesperados.
-
-## Herramientas Disponibles
-
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`fs_read\` | Lee código con errores | Análisis inicial |
-| \`cli_exec\` | Ejecuta tests, reproduce error | Confirmar bug |
-| \`codebridge_launch\` | Lanza subagente para debug | Análisis profundo |
-| \`codebridge_status\` | Obtiene diagnóstico | Resultado del análisis |
-| \`fs_edit\` | Aplica fix al código | Corrección |
-
-## Workflow
-
-### Debugging
-\`\`\`javascript
-// 1. Recopilar contexto
-// - Error message completo
-// - Stack trace
-// - Archivos afectados
-// - Steps para reproducir
-
-// 2. Leer código relevante
-const code = fs_read({ path: "src/failing.ts" })
-
-// 3. Reproducir error (opcional)
-const result = cli_exec({ command: "npm test -- failing.test.ts" })
-
-// 4. Analizar con subagente
-const { process_id } = codebridge_launch({
-  cli: "claude",
-  prompt: \`
-    Error: TypeError: Cannot read property 'id' of undefined
-    Stack trace:
-      at getUser (src/user.ts:15)
-      at handler (src/handler.ts:42)
-
-    Analizar:
-    1. ¿Qué variable es undefined?
-    2. ¿Por qué no está inicializada?
-    3. ¿Cómo fixear?
-  \`
-})
-
-// 5. Obtener diagnóstico
-const analysis = codebridge_status({ process_id })
-
-// 6. Aplicar fix
-fs_edit({
-  path: "src/user.ts",
-  changes: "Add null check before accessing .id"
-})
-
-// 7. Verificar
-cli_exec({ command: "npm test" })
-\`\`\`
-
-## Tipos Comunes de Errores
-
-| Error | Causa común | Fix típico |
-|-------|-------------|------------|
-| TypeError undefined | Null/undefined access | Add null check |
-| ReferenceError | Variable no declarada | Declarar/importar |
-| SyntaxError | Typos, missing chars | Fix syntax |
-| AssertionError | Lógica incorrecta | Fix condition |
-| Timeout | Async no resuelve | Add timeout handling |
-
-## Estrategia de Debug
-
-1. **Reproducir**: Confirmar que el error existe
-2. **Localizar**: Stack trace → archivo → línea
-3. **Entender**: ¿Por qué pasa aquí?
-4. **Fixear**: Mínimo cambio que resuelve root cause
-5. **Verificar**: Tests pasan, no hay regresiones
-
-## Configuración por CLI para Debug
-
-### Qwen CLI (Debug Rápido)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "debug-001",
-  config: {
-    role: "development",
-    cli: "qwen",
-    args: ["--non-interactive"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 120,  // 2 minutos - rápido
-  },
-  prompt: \`
-    Error: TypeError: Cannot read property 'id' of undefined
-    File: src/user.ts:15
-    Stack trace:
-      at getUser (src/user.ts:15)
-      at handler (src/handler.ts:42)
-    
-    Identify the root cause and propose a minimal fix.
-  \`
-})
-\`\`\`
-**Ideal para:** Errores simples, null checks, bugs rápidos
-
-### Claude Code (Debug Complejo)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "debug-002",
-  config: {
-    role: "development",
-    cli: "claude",
-    args: ["--no-approve", "--output-format", "stream"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 300,  // 5 minutos - análisis profundo
-  },
-  prompt: \`
-    Analyze this intermittent race condition:
-    - Error occurs in 10% of requests
-    - Affects async database operations
-    - Stack trace shows Promise.all() in src/batch.ts
-    
-    Provide:
-    1. Root cause analysis
-    2. Fix with proper Promise handling
-    3. Test to reproduce the race condition
-  \`
-})
-\`\`\`
-**Ideal para:** Race conditions, bugs intermitentes, análisis profundo
-
-### Gemini CLI (Debug + Docs)
-\`\`\`typescript
-codebridge_launch({
-  taskId: "debug-003",
-  config: {
-    role: "development",
-    cli: "gemini",
-    args: ["-y", "--quiet"],
-    cwd: "/path/to/project",
-    timeoutSeconds: 240,
-  },
-  prompt: \`
-    Fix this TypeScript type error and add documentation:
-    
-    Error: Type 'X' is not assignable to type 'Y'
-    File: src/types.ts:45
-    
-    Provide:
-    1. Type fix
-    2. JSDoc explaining the type constraint
-    3. Example of correct usage
-  \`
-})
-\`\`\`
-**Ideal para:** Errores de tipo + documentación
-
-## Tabla Comparativa de CLIs para Debug
-
-| CLI | Timeout | Mejor Para | Ejemplo |
-|-----|---------|------------|---------|
-| **qwen** | 120s | Bugs rápidos, null checks | TypeError, ReferenceError |
-| **claude** | 300s | Race conditions, análisis profundo | Intermittent bugs |
-| **gemini** | 240s | Type errors + docs | TypeScript errors |
-
-## Ejemplos Detallados
-
-### Ejemplo 1: TypeError Simple con Qwen
-\`\`\`typescript
-// Usuario: "arreglá este error: Cannot read property 'name' of undefined"
-codebridge_launch({
-  taskId: "typeerror-001",
-  config: {
-    role: "development",
-    cli: "qwen",
-    cwd: process.cwd(),
-    timeoutSeconds: 120,
-  },
-  prompt: \`
-    Error: TypeError: Cannot read property 'name' of undefined
-    File: src/components/UserCard.tsx:23
-    Code: const userName = user.name;
-    
-    The 'user' prop can be undefined. Add proper null check.
-    Provide minimal fix.
-  \`
-})
-\`\`\`
-
-### Ejemplo 2: Race Condition con Claude
-\`\`\`typescript
-// Usuario: "la app crashea intermitentemente en producción"
-codebridge_launch({
-  taskId: "racecondition-002",
-  config: {
-    role: "development",
-    cli: "claude",
-    cwd: "/path/to/project",
-    timeoutSeconds: 300,
-  },
-  prompt: \`
-    Intermittent crash in production (10% of requests):
-    
-    Error: Cannot read properties of undefined (reading 'map')
-    File: src/dashboard/Dashboard.tsx:89
-    
-    Context:
-    - Dashboard fetches data from 3 APIs in parallel
-    - Uses Promise.all() without error handling
-    - One API sometimes returns empty response
-    
-    Analyze:
-    1. Root cause of race condition
-    2. Fix with proper error handling
-    3. Add retry logic for flaky API
-  \`
-})
-\`\`\`
-
-### Ejemplo 3: Error de Tipo con Gemini
-\`\`\`typescript
-// Usuario: "TypeScript no compila, error de tipos"
-codebridge_launch({
-  taskId: "typeerror-003",
-  config: {
-    role: "development",
-    cli: "gemini",
-    cwd: "/path/to/project",
-    timeoutSeconds: 240,
-  },
-  prompt: \`
-    TypeScript Error:
-    Type '(user: User) => Promise<User>' is not assignable to type '(user: User) => User'
-    
-    File: src/services/userService.ts:34
-    Function: updateUser
-    
-    Current code returns Promise<User> but interface expects User.
-    Fix the type mismatch and add JSDoc explaining the async behavior.
-  \`
-})
-\`\`\`
-
-## Mejores Prácticas
-
-### ✅ DOs
-- Leer error completo y stack trace
-- Identificar archivo y línea exactos
-- Entender root cause, no solo síntomas
-- Fix minimalista que aborda causa raíz
-- Agregar test de regresión
-- Verificar con tests existentes
-
-### ❌ DON'Ts
-- ❌ Fixear síntomas sin entender causa
-- ❌ Cambios grandes sin necesidad
-- ❌ No verificar que el fix funciona
-- ❌ Ignorar tests que ahora fallan
-- ❌ Olvidar casos edge (null, undefined)
-
-## Manejo de Errores
-
-### Error: "Missing environment variables"
-\`\`\`typescript
-// Verificar antes de lanzar
-if (!process.env.ANTHROPIC_API_KEY && cli === "claude") {
-  throw new Error("ANTHROPIC_API_KEY required for Claude Code");
-}
-\`\`\`
-
-### Error: "Process exited with code 1"
-- Leer stdout/stderr para mensaje de error específico
-- El CLI puede haber rechazado el prompt (muy vago)
-- Reintentar con prompt más detallado
-
-### Error: Timeout
-- Aumentar \`timeoutSeconds\` para análisis complejos
-- Dividir debug en pasos más pequeños
-- Usar Qwen para bugs simples (más rápido)
-
-## Errores a Evitar
-
-- ❌ Fixear síntomas sin entender causa
-- ❌ Cambios grandes sin necesidad
-- ❌ No verificar que el fix funciona
-- ❌ Ignorar tests que ahora fallan
-- ❌ No agregar test de regresión
-`,
-  },
-  {
-    name: "voice_input",
-    description: `Transcribe audio input to text using STT (Speech-to-Text) providers like Groq Whisper or OpenAI Whisper`,
-    category: "voice",
-    version: "1.0.0",
-    tools: ["voice_transcribe"],
-    triggers: ["transcribí este audio","transcribe audio","convertí voz a texto","convert voice to text","qué dice el audio","what does audio say","escuchá esto","listen to this","audio a texto","audio to text","reconocimiento de voz","speech recognition","nota de voz","voice note"],
-    body: `
-# Voice Input Skill
-
-## Cuándo se Activa
-
-Esta skill se activa cuando el usuario envía audio y necesita transcripción a texto: notas de voz, grabaciones, comandos de voz.
-
-## Herramientas Disponibles
-
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`voice_transcribe\` | Convierte audio → texto | Transcripción de cualquier audio |
-
-## Workflow
-
-### Transcripción
-\`\`\`javascript
-// 1. Recibir audio
-// - File upload
-// - Voice message (Telegram, WhatsApp)
-// - Stream en vivo
-
-// 2. Transcribir
-const result = voice_transcribe({
-  audio: audioBuffer,
-  language: "es"  // o "auto" para detectar
-})
-
-// 3. Formatear
-// - Agregar puntuación
-// - Capitalizar
-// - Marcar speakers si hay múltiples
-
-// 4. Entregar resultado
-\`\`\`
-
-## Proveedores STT Soportados
-
-| Provider | Modelos | Idiomas |
-|----------|---------|---------|
-| Groq | whisper-large-v3, turbo | Multi |
-| OpenAI | whisper-1 | Multi |
-
-## Configuración por Canal
-
-Cada canal puede configurar su proveedor STT preferido:
-- \`stt_provider\`: "groq-whisper" | "openai-whisper"
-
-## Mejores Prácticas
-
-- Detectar idioma automáticamente
-- Agregar puntuación para legibilidad
-- Marcar segmentos inaudibles
-- Preservar idioma original
-
-## Errores a Evitar
-
-- ❌ Traducir sin pedir (mantener idioma)
-- ❌ Omitir puntuación
-- ❌ No indicar baja confianza
-- ❌ Ignorar ruido de fondo que afecta calidad
-`,
-  },
-  {
-    name: "voice_output",
-    description: `Convert text to synthesized speech using TTS (Text-to-Speech) providers like ElevenLabs, OpenAI TTS, or Gemini TTS`,
-    category: "voice",
-    version: "1.0.0",
-    tools: ["voice_speak"],
-    triggers: ["leé esto en voz alta","read this aloud","convertí a voz","convert to speech","hablá este texto","speak this text","texto a voz","text to speech","generá audio","generate audio","síntesis de voz","voice synthesis","escuchá la respuesta","listen to response"],
-    body: `
-# Voice Output Skill
-
-## Cuándo se Activa
-
-Esta skill se activa cuando el usuario necesita convertir texto a voz: leer respuestas, generar audio, síntesis de voz.
-
-## Herramientas Disponibles
-
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`voice_speak\` | Convierte texto → audio | Síntesis de voz |
-
-## Workflow
-
-### Text-to-Speech
-\`\`\`javascript
-// 1. Recibir texto
-const text = "Hola, ¿cómo estás?"
-
-// 2. Preprocesar
-// - Expandir números: "5" → "cinco"
-// - Expandir fechas: "01/01" → "primero de enero"
-// - Expandir abbreviaturas: "Dr." → "Doctor"
-
-// 3. Sintetizar
-const audio = voice_speak({
-  text: optimizedText,
-  voice_id: "eleven_flash_v2_5",  // o configured voice
-  language: "es"
-})
-
-// 4. Entregar audio
-// - Enviar como archivo
-// - Streaming si el canal lo soporta
-\`\`\`
-
-## Proveedores TTS Soportados
-
-| Provider | Modelos | Voces |
-|----------|---------|-------|
-| ElevenLabs | Flash V2.5, Turbo V2.5, Multilingual V2, V3 | 1000+ |
-| OpenAI | tts-1, tts-1-hd, gpt-4o-mini-tts | 6+ |
-| Gemini | 2.5 Flash TTS, 2.5 Pro TTS | Multi |
-| Qwen | Qwen TTS Flash, Instruct | Multi |
-
-## Configuración por Canal
-
-Cada canal configura su proveedor TTS:
-- \`tts_provider\`: "elevenlabs" | "openai-tts" | "gemini-tts"
-- \`tts_voice_id\`: ID específico de voz (ej. ElevenLabs voice ID)
-
-## Mejores Prácticas
-
-- Preprocesar texto para naturalidad
-- Usar voz configurada por usuario
-- Cachear respuestas frecuentes
-- Split de textos largos
-
-## Errores a Evitar
-
-- ❌ Enviar texto crudo sin preprocesar
-- ❌ Ignorar preferencia de voz
-- ❌ No manejar límites de longitud
-- ❌ No cachear (costo API)
-`,
-  },
-  {
-    name: "voice_assistant",
-    description: `Full voice-to-voice interaction: transcribe user speech, process request, and respond with synthesized speech`,
-    category: "voice",
-    version: "1.0.0",
-    tools: ["voice_transcribe","voice_speak"],
-    triggers: ["modo voz","voice mode","asistente de voz","voice assistant","hablá conmigo","talk to me","interacción por voz","voice interaction","respuesta hablada","spoken response","comando de voz","voice command","diálogo por voz","voice dialogue"],
-    body: `
-# Voice Assistant Skill
-
-## Cuándo se Activa
-
-Esta skill se activa para interacción completa voz a voz: el usuario habla, el asistente procesa y responde con voz.
-
-## Herramientas Disponibles
-
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`voice_transcribe\` | Audio → texto | Input del usuario |
-| \`voice_speak\` | Texto → audio | Respuesta del asistente |
-
-## Workflow
-
-### Voice-to-Voice
-\`\`\`javascript
-// 1. Usuario habla
-const userAudio = receiveAudio()
-
-// 2. Transcribir
-const userText = voice_transcribe({
-  audio: userAudio,
-  language: "auto"
-})
-// → "¿Cuál es el clima hoy?"
-
-// 3. Procesar request
-// - Entender intención
-// - Ejecutar acción (ej. consultar API clima)
-// - Generar respuesta
-const responseText = "Hoy hay 25 grados y soleado en Buenos Aires"
-
-// 4. Sintetizar respuesta
-const responseAudio = voice_speak({
-  text: responseText,
-  voice_id: "eleven_flash_v2_5",
-  language: "es"
-})
-
-// 5. Enviar audio
-sendAudio(responseAudio)
-\`\`\`
-
-## Casos de Uso
-
-| Caso | Flujo |
-|------|-------|
-| Pregunta simple | Transcribe → responde → sintetiza |
-| Comando | Transcribe → ejecuta → confirma por voz |
-| Diálogo | Mantener contexto entre exchanges |
-| Wake word | Escuchar "hey bee" → activar → procesar |
-
-## Configuración
-
-### Wake Word
-\`\`\`json
-{
-  "voice_wake_word": "hey bee",
-  "voice_wake_enabled": true
-}
-\`\`\`
-
-### Canal Voice
-\`\`\`json
-{
-  "voice_enabled": true,
-  "tts_enabled": true,
-  "stt_provider": "groq-whisper",
-  "tts_provider": "elevenlabs",
-  "tts_voice_id": "eleven_flash_v2_5"
-}
-\`\`\`
-
-## Mejores Prácticas
-
-- Respuestas cortas y naturales (<60s)
-- Mantener contexto conversacional
-- Indicadores de procesamiento
-- Fallback a texto si falla voz
-
-## Errores a Evitar
-
-- ❌ Respuestas muy largas para audio
-- ❌ Perder contexto entre exchanges
-- ❌ No indicar que está procesando
-- ❌ No tener fallback si falla TTS/STT
-`,
-  },
-  {
-    name: "office_document_manager",
-    description: `Leer, crear y manipular archivos Office (PDF, Word, Excel, PowerPoint) desde el workspace`,
-    category: "office",
-    version: "1.0.0",
-    tools: ["office_leer_pdf","office_escribir_pdf","office_leer_docx","office_escribir_docx","office_leer_xlsx","office_escribir_xlsx","office_leer_pptx","office_escribir_pptx"],
-    triggers: ["leer pdf","abrir pdf","extraer texto de pdf","pdf a texto","crear pdf","generar pdf","exportar a pdf","leer word","abrir docx","extraer texto de word","crear word","generar docx","documento word","leer excel","abrir xlsx","datos de excel","crear excel","generar xlsx","exportar a excel","leer powerpoint","abrir pptx","presentacion","diapositivas","crear presentacion","generar pptx","read pdf","open pdf","create pdf","read excel","create excel","read word","create word","read powerpoint","create presentation"],
-    body: `
-# Office Document Manager Skill
-
-## Cuándo se Activa
-
-Esta skill se activa cuando el usuario necesita:
-- **Leer** archivos PDF, Word (.docx), Excel (.xlsx) o PowerPoint (.pptx)
-- **Generar** nuevos archivos en cualquiera de esos formatos
-- **Convertir** contenido entre formatos (ej: texto → PDF, JSON → Excel)
-- **Extraer** datos estructurados de documentos (tablas de Excel, slides de presentación)
-
-## Herramientas Disponibles
-
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`office_leer_pdf\` | Extrae texto + metadata de PDF | Leer informes, contratos, libros en PDF |
-| \`office_escribir_pdf\` | Genera PDF desde texto | Crear reportes, resúmenes, documentación |
-| \`office_leer_docx\` | Extrae texto y tablas de Word | Leer documentos, contratos, informes Word |
-| \`office_escribir_docx\` | Genera Word con estructura | Crear documentos formales con títulos/tablas |
-| \`office_leer_xlsx\` | Lee hojas de Excel como JSON | Procesar datos, tablas, inventarios |
-| \`office_escribir_xlsx\` | Genera Excel desde JSON | Exportar datos, crear reportes tabulares |
-| \`office_leer_pptx\` | Extrae texto de cada slide | Resumir presentaciones, extraer contenido |
-| \`office_escribir_pptx\` | Genera presentación PowerPoint | Crear slides desde datos o resúmenes |
-
-## Workflow por Caso de Uso
-
-### Leer y resumir un documento
-1. \`office_leer_pdf/docx/xlsx/pptx\` → extraer contenido
-2. Procesar y resumir el texto
-3. \`notify\` → enviar resumen al usuario
-
-### Transformar datos a Excel
-1. Obtener datos (de memoria, herramienta o cálculo)
-2. Estructurar en \`hojas\` con \`datos\` como array de objetos
-3. \`office_escribir_xlsx\` → generar archivo
-4. Confirmar ruta al usuario
-
-### Crear un informe PDF
-1. Compilar el contenido del informe como texto
-2. \`office_escribir_pdf\` → generar con título y márgenes
-3. Confirmar que el archivo quedó en la ruta esperada
-
-### Generar una presentación
-1. Definir estructura: título + array de slides (título + puntos)
-2. \`office_escribir_pptx\` → generar .pptx
-3. Opcional: incluir notas del presentador en cada slide
-
-## Parámetros Clave
-
-### \`parrafos\` para DOCX
-\`\`\`json
-[
-  { "texto": "Capítulo 1", "tipo": "titulo1" },
-  { "texto": "Subtítulo", "tipo": "titulo2" },
-  { "texto": "Contenido normal", "tipo": "parrafo" },
-  { "texto": "Ítem de lista", "tipo": "lista" },
-  { "texto": "Texto importante", "tipo": "parrafo", "negrita": true }
-]
-\`\`\`
-
-### \`hojas\` para XLSX
-\`\`\`json
-[
-  {
-    "nombre": "Ventas",
-    "datos": [
-      { "Mes": "Enero", "Total": 5000 },
-      { "Mes": "Febrero", "Total": 6200 }
-    ]
-  }
-]
-\`\`\`
-
-### \`diapositivas\` para PPTX
-\`\`\`json
-[
-  {
-    "titulo": "¿Qué es Machine Learning?",
-    "puntos": ["Subcampo de IA", "Aprende de datos", "Hace predicciones"],
-    "notas": "Mencionar el enfoque supervisado y no supervisado"
-  }
-]
-\`\`\`
-
-## Errores a Evitar
-
-- ❌ Intentar leer un archivo que no existe (verifica con \`fs_exists\` primero)
-- ❌ Sobrescribir sin confirmar cuando el archivo destino ya existe
-- ❌ Usar \`contenido\` y \`puntos\` a la vez en PPTX — \`puntos\` tiene prioridad
-- ❌ Pasar un array de arrays como \`datos\` de XLSX cuando se esperan objetos con claves
-- ❌ Intentar leer PDF de más de 100 páginas sin especificar rango (usar \`pagina_inicio\`/\`pagina_fin\`)
-`,
-  },
-  {
-    name: "cron_manager",
-    description: `Complete management of cron jobs with cron expressions. Create, list, update, pause, resume, delete, trigger, and view history. Use for reminders, automated reports, periodic checks.`,
-    category: "cron",
-    version: "2.0.0",
-    tools: ["cron.create","cron.list","cron.update","cron.delete","cron.pause","cron.resume","cron.trigger","cron.history"],
-    triggers: ["programá una tarea","schedule task","creá un cron","create cron","editá el cron","edit cron","eliminá el cron","remove cron","lista las tareas","list cron jobs","modificá el cron","modify cron","tarea recurrente","recurring task","todos los días","daily","cada semana","weekly"],
-    body: `
-# Cron Manager Skill
-
-## Cuándo se Activa
-
-Para gestionar tareas programadas (cron jobs): crear, listar, actualizar, pausar, reanudar, eliminar, ejecutar y ver historial.
-
-## Herramientas Disponibles
-
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`cron.create\` | Crear cron job | Nueva tarea |
-| \`cron.list\` | Listar todos | Ver existentes |
-| \`cron.update\` | Actualizar existente | Cambiar horario/instrucción |
-| \`cron.pause\` | Pausar temporalmente | Sin eliminar |
-| \`cron.resume\` | Reanudar pausado | Continuar ejecución |
-| \`cron.delete\` | Eliminar permanentemente | Cancelar para siempre |
-| \`cron.trigger\` | Ejecutar ahora | Forzar ejecución |
-| \`cron.history\` | Ver historial | Ver logs de ejecuciones |
-
-## Campos Principales
-
-| Campo | Tipo | Descripción |
-|-------|------|-------------|
-| \`name\` | string | Identificador corto (e.g., 'daily-report') |
-| \`task\` | string | **REQUERIDO** - Instrucciones para el agente al ejecutarse |
-| \`task_type\` | string | 'recurring' (repite) o 'one_shot' (una vez) |
-| \`cron_expression\` | string | Expresión cron (solo para recurring) |
-| \`fire_at\` | string | Datetime ISO (solo para one_shot) |
-| \`channel\` | string | Canal de notificación |
-| \`start_at\` | string | Inicio de ventana opcional (Croner startAt) |
-| \`stop_at\` | string | Fin de ventana opcional (Croner stopAt) |
-| \`dom_and_dow\` | number | 0=OR (default), 1=AND (día mes + día semana) |
-
-## Cron Expression Format
-
-\`\`\`
-* * * * *
-│ │ │ │ │
-│ │ │ │ └── Día semana (0-6, 0=Domingo)
-│ │ │ └──── Mes (1-12)
-│ │ └────── Día del mes (1-31)
-│ └──────── Hora (0-23)
-└────────── Minuto (0-59)
-\`\`\`
-
-## Ejemplos Comunes
-
-| Expresión | Significado |
-|-----------|-------------|
-| \`0 9 * * *\` | Diario 9:00 AM |
-| \`0 7 * * 1-5\` | Lun-Vie 7:00 AM |
-| \`0 */2 * * *\` | Cada 2 horas |
-| \`0 0 * * 0\` | Domingos medianoche |
-| \`0 0 1 * *\` | Día 1 de cada mes |
-
-## Cómo Usar start_at / stop_at
-
-- \`start_at\`: La tarea no ejecuta antes de esta fecha
-- \`stop_at\`: La tarea no ejecuta después de esta fecha
-- Formato ISO: \`'2026-04-01T00:00:00'\`
-
-## Cómo Usar dom_and_dow
-
-- \`0\` (default): Se ejecuta si es el día del mes O el día de semana
-- \`1\`: Se ejecuta solo si es EL MISMO día del mes Y el día de semana
-
-Ejemplo: \`0 9 15 * *\` con dom_and_dow=1 significa "los 15 de cada mes QUE SEA domingo"
-
-## Workflow para Crear
-
-1. **Preguntar** → ¿one_shot o recurring?
-2. **Obtener** → Hora y canal de notificación
-3. **Crear** → \`cron.create\` con campo \`task\` obligatorio
-4. **Confirmar** → \`cron.list\` mostrar next runs
-
-## Errores a Evitar
-
-- ❌ Olvidar el campo \`task\` — es obligatorio
-- ❌ Usar exec para tareas programadas
-- ❌ No preguntar si es one_shot o recurring
-- ❌ No mostrar próximos horarios al crear
-- ❌ Llamar \`cron.update\` sin \`task_id\` — siempre hacer \`cron.list\` primero`,
-  },
-  {
-    name: "cron_reminder",
-    description: `Schedule a reminder for yourself at a specific time. Creates a one_shot cron job that sends a notification message via your preferred channel.`,
-    category: "cron",
-    version: "2.0.0",
-    tools: ["cron.create","notify"],
-    triggers: ["recordame","remind me","recordatorio","reminder","alerta","alert","avísame","notify me","programá","schedule","para mañana","for tomorrow","en 30 minutos","in 30 minutes"],
-    body: `
-# Cron Reminder Skill
-
-## Cuándo se Activa
-
-Para crear recordatorios de una sola ejecución (one_shot): "recuerdame a las 3pm", "avísame en 30 minutos", etc.
-
-## Herramientas
-
-| Tool | Qué hace |
-|------|----------|
-| \`cron.create\` | Crear recordatorio one_shot |
-| \`notify\` | Enviar notificación directa |
-
-## Cómo Funciona
-
-1. **Preguntar** → ¿De qué te aviso? ¿A qué hora? ¿Por qué canal?
-2. **Crear** → \`cron.create\` con \`task_type: 'one_shot'\` y \`fire_at\` en formato ISO
-3. **Confirmar** → Mostrar hora programada
-
-## Parámetros
-
-| Campo | Descripción |
-|-------|-------------|
-| \`task\` | **REQUERIDO** - Mensaje del recordatorio |
-| \`task_type\` | Siempre \`'one_shot'\` |
-| \`fire_at\` | Fecha/hora ISO (ej: \`'2026-04-20T15:00:00'\`) |
-| \`channel\` | Canal (telegram, discord, whatsapp, webchat) |
-
-## Errores Comunes
-
-- ❌ Olvidar el campo \`task\` — obligatorio para que el agente sepa qué enviar
-- ❌ Usar expresiones cron para recordatorios (usar \`fire_at\` en vez de \`cron_expression\`)
-- ❌ Poner \`fire_at\` en el pasado`,
-  },
-  {
-    name: "busqueda_fts5",
-    description: `Core discovery skill - learn how to find any capability using search_knowledge`,
-    category: "core",
-    version: "1.0.0",
-    tools: ["search_knowledge"],
-    triggers: ["cómo busco herramientas","cómo encuentro skills","how to find tools","search knowledge","discovery","buscar en la base","encontrar herramientas"],
-    body: `
-# busqueda_fts5 — Discovery System
-
-This skill teaches you how to find any capability in Hive using **search_knowledge**.
-
-## Por qué Discovery?
-
-You start with only 4 basic tools. All other capabilities (tools, skills, MCP tools, playbook rules) must be discovered dynamically.
-
-## Cómo Buscar
-
-\`search_knowledge(type, query)\`
-
-### Type Options:
-
-| type | What it finds | Example |
-|------|---------------|---------|
-| **tools** | Native Hive tools | \`search_knowledge(type="tools", query="leer archivo")\` |
-| **skills** | Task instructions | \`search_knowledge(type="skills", query="generar código")\` |
-| **mcp** | External MCP tools (Airtable, GitHub) | \`search_knowledge(type="mcp", query="crear registro")\` |
-| **playbook** | Best practices rules | \`search_knowledge(type="playbook", query="seguridad")\` |
-| **all** | Everything | \`search_knowledge(type="all", query="buscar web")\` |
-
-## Query Tips
-
-- **Be specific**: \`search_knowledge(type="tools", query="leer archivo markdown")\` not just "file"
-- **Bilingual**: Search in Spanish, the system retries in English if few results
-- **Use task context**: "debuggear código" finds code_debug skill
-- **Tool format**: MCP tools are \`{serverName}__{toolName}\` (e.g., \`airtable_crm_datos___AIRTABLE_LIST_BASES\`)
-
-## Discovery Flow
-
-1. User asks for something you don't have → \`search_knowledge(query, type)\`
-2. Results come back with tool names and descriptions
-3. Tools are automatically injected into your context
-4. Use the injected tools immediately
-
-## Examples
-
-**Find a tool to read files:**
-\`\`\`
-search_knowledge({type: "tools", query: "leer archivo", limit: 5})
-→ Returns fs_read, fs_list, etc.
-\`\`\`
-
-**Find Airtable tools:**
-\`\`\`
-search_knowledge({type: "mcp", query: "crear registro airtable", limit: 5})
-→ Returns AIRTABLE_CREATE_RECORD, etc.
-\`\`\`
-
-**Find skill to generate code:**
-\`\`\`
-search_knowledge({type: "skills", query: "generar código", limit: 3})
-→ Returns code_generate, code_delegator, etc.
-\`\`\`
-
-## Priority Rule
-
-**ALWAYS prefer native tools over MCP tools** when both do the task.
-- Native tools: faster, no network, always available
-- MCP tools: fallback when no native tool exists
-
-## Remember
-
-- No tool in your startup context? → **search_knowledge**
-- Don't know how to do something? → **search_knowledge**
-- Need external capabilities (Airtable, GitHub)? → **search_knowledge(type="mcp")**`,
-  },
-  {
-    name: "meeting_transcription",
-    description: `Transcribir reuniones en tiempo real y generar informes gerenciales con decisiones, action items y próximos pasos`,
-    category: "meeting",
-    version: "1.0.0",
-    tools: ["meeting_start","meeting_add_segment","meeting_stop","meeting_report","office_escribir_docx","notify","report_progress"],
-    triggers: ["transcribir reunión","iniciar transcripción","meeting transcription","grabar reunión","iniciar reunión","start meeting","detener reunión","stop meeting","reporte de reunión","generar reporte reunión","informe de reunión","acta de reunión","transcripción de reunión","meeting report"],
-    body: `
-# Meeting Transcription Skill
-
-## Cuándo se Activa
-
-Esta skill se activa para gestión completa del ciclo de vida de una reunión: inicio, transcripción en tiempo real, detención y generación de informe gerencial.
-
-## Herramientas Disponibles
-
-| Tool | Qué hace | Cuándo usarla |
-|------|----------|---------------|
-| \`meeting_start\` | Crea una sesión en DB → devuelve session_id | Al iniciar la reunión |
-| \`meeting_add_segment\` | Transcribe un chunk de audio y lo persiste | Por cada audio recibido |
-| \`meeting_stop\` | Marca la sesión como detenida | Cuando termina la reunión |
-| \`meeting_report\` | Lee todos los segmentos y arma el transcript | Para generar el reporte |
-| \`office_escribir_docx\` | Guarda el reporte como archivo Word | Al finalizar el análisis |
-| \`notify\` | Envía mensajes en tiempo real al canal | Para mostrar transcripciones y el reporte |
-| \`report_progress\` | Muestra progreso en barra | Durante transcripción larga |
-
-## Workflow Completo
-
-\`\`\`
-Usuario: "transcribir reunión"
-  → Agente pregunta título
-  → meeting_start(title) → session_id: "abc123"
-  → Agente: "✅ Sesión abc123 iniciada. Habla cuando quieras."
-
-[Usuario graba audio en la UI]
-  → meeting_add_segment(session_id, audio_base64)
-  → notify: "[Speaker]: Texto transcrito..."
-
-Usuario: "detener reunión"
-  → meeting_stop(session_id)
-  → Agente: "⏹️ 47 segmentos transcritos. ¿Genero el reporte?"
-
-Usuario: "sí"
-  → meeting_report(session_id) → transcript completo
-  → LLM analiza → secciones estructuradas
-  → office_escribir_docx → informe_reunion_abc123.docx
-  → notify: [Markdown del informe completo]
-  → Agente: "✅ DOCX guardado en workspace."
-\`\`\`
-
-## Formato del Informe Gerencial
-
-El informe generado incluye:
-
-1. **Resumen Ejecutivo** — Captura la esencia en 3-5 oraciones
-2. **Participantes** — Detectados automáticamente del transcript
-3. **Decisiones Tomadas** — Lista numerada de cada decisión
-4. **Action Items** — Tabla con Tarea / Responsable / Fecha
-5. **Próximos Pasos** — Acciones inmediatas
-6. **Temas de Seguimiento** — Pendientes para futuras reuniones
-
-## Consideraciones
-
-- El informe se entrega en dos formatos: **Markdown en chat** + **DOCX descargable**
-- El idioma del informe es siempre **español**
-- La latencia de transcripción es ~4s por chunk de 3s de audio (normal para Whisper)
-- El session_id debe conservarse durante toda la reunión
+- Eliminar surfaces con \`a2ui_delete_surface\` al completar o cancelar
 `,
   },
 ];