@johpaz/hive-sdk 0.0.14 → 0.0.15

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

@@ -0,0 +1,3332 @@
+// AUTO-GENERATED by packages/skills/scripts/generate-bundle.ts
+// Do NOT edit manually — run `bun packages/skills/scripts/generate-bundle.ts` to regenerate
+
+export interface BundledSkillEntry {
+  name: string;
+  description: string;
+  category: string;
+  version: string;
+  tools: string[];
+  triggers: string[];
+  body: string;
+}
+
+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"],
+    body: `
+# File Read and Summarize 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é"
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| \`project_read\` | Lee contenido de archivo del workspace | Lectura de cualquier archivo |
+
+## Workflow
+
+1. **Verificar existencia** → \`project_exists({ path })\`
+2. **Leer contenido** → \`project_read({ path, offset, limit })\`
+3. **Sintetizar** → Resumir si es grande, extraer puntos clave
+
+## 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
+
+## Errores a Evitar
+
+- ❌ Leer sin verificar existencia
+- ❌ Retornar archivo completo sin resumir si es muy grande
+- ❌ No identificar tipo de archivo para adaptar resumen
+`,
+  },
+  {
+    name: "file_manager",
+    description: `Explore project structure and locate files using glob patterns and directory listing`,
+    category: "filesystem",
+    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"],
+    body: `
+# File 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
+
+## 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 |
+
+## 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
+
+## Patrones Glob Comunes
+
+| 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
+
+- ❌ No verificar existencia antes de leer/editar
+- ❌ Usar project_list cuando se conoce el patrón (usar glob)
+- ❌ Patrones muy amplios sin filtrado
+`,
+  },
+  {
+    name: "file_writer",
+    description: `Create, modify, and delete files with safe edit operations and confirmation for large changes`,
+    category: "filesystem",
+    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"],
+    body: `
+# File Writer Skill
+
+## Cuándo se Activa
+
+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 |
+|------|----------|---------------|
+| \`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 |
+
+## Workflow
+
+### Crear Archivo Nuevo
+1. \`project_exists({ path })\` → verificar no existe
+2. \`project_write({ path, content })\` → crear
+
+### 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
+
+### Eliminar Archivo
+1. \`project_exists({ path })\` → verificar existe
+2. \`canvas_confirm({ message: '¿Eliminar archivo?' })\` → confirmar
+3. Operación de delete
+
+## 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
+
+## 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
+`,
+  },
+  {
+    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
+
+## Cuándo se Activa
+
+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 |
+|------|----------|---------------|
+| \`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
+
+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
+
+- 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
+
+- ❌ Inventar datos no encontrados
+- ❌ Concluir con una sola búsqueda
+- ❌ No verificar fecha de fuentes
+- ❌ Copiar contenido literal (usar paráfrasis)
+`,
+  },
+  {
+    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: `
+# Web Monitor 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
+
+## 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 |
+
+## 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
+
+## Mejores Prácticas
+
+- Ignorar cambios menores (timestamps, ads, contenido dinámico irrelevante)
+- Notificar solo cambios significativos
+- Para monitoreo periódico, combinar con \`cron.create\`
+
+## Errores a Evitar
+
+- ❌ No almacenar baseline inicial
+- ❌ Notificar por cambios triviales
+- ❌ No actualizar timestamp de baseline
+`,
+  },
+  {
+    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: `
+# Browser Scrape 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.
+
+## 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 |
+
+## 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
+
+## Mejores Prácticas
+
+- 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
+
+- ❌ No esperar renderizado JavaScript
+- ❌ Solo capturar HTML estático para sitios SPA
+- ❌ Ignorar términos de servicio del sitio
+`,
+  },
+  {
+    name: "browser_automate",
+    description: `Automate web workflows with navigation, clicks, form filling, and visual verification`,
+    category: "web",
+    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"],
+    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 |
+
+## 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
+
+- 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
+`,
+  },
+  {
+    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
+
+## Cuándo se Activa
+
+Para planificar y estructurar proyectos complejos que requieren coordinación de múltiples workers.
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| \`project_create\` | Crea proyecto con tasks | Estructura inicial |
+| \`task_create\` | Agrega tasks adicionales | Expandir proyecto |
+
+## Workflow
+
+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)
+
+## Errores a Evitar
+
+- ❌ Crear proyecto para tareas simples
+- ❌ Tasks muy grandes o vagas
+- ❌ No definir criterios de aceptación
+`,
+  },
+  {
+    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"],
+    body: `
+# Project Tracker Skill
+
+## Cuándo se Activa
+
+Para monitorear y actualizar el progreso de proyectos y tareas en curso.
+
+## Herramientas Disponibles
+
+| 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 |
+
+## Workflow
+
+1. **Listar** → \`project_list()\` para encontrar proyecto
+2. **Actualizar tasks** → \`task_update()\` cuando workers entregan
+3. **Actualizar proyecto** → \`project_update()\` con progreso calculado
+
+## Mejores Prácticas
+
+- 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
+
+## Errores a Evitar
+
+- ❌ Dejar estado desactualizado
+- ❌ No notificar blockers
+- ❌ Progreso incorrecto vs realidad
+`,
+  },
+  {
+    name: "project_closer",
+    description: `Evaluate task results and close projects with comprehensive summaries or failure analysis`,
+    category: "projects",
+    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"],
+    body: `
+# Project Closer Skill
+
+## Cuándo se Activa
+
+Para evaluar resultados y cerrar proyectos completados o fallidos.
+
+## 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 |
+
+## 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 })\`
+
+## Mejores Prácticas
+
+- Criterios de aceptación medibles y específicos
+- Resumen ejecutivo con outcomes medibles
+- Lecciones aprendidas accionables en failure
+
+## Errores a Evitar
+
+- ❌ Cerrar sin evaluar todas las tasks
+- ❌ project_fail sin análisis de causa raíz
+- ❌ Resúmenes vagos sin datos concretos
+`,
+  },
+  {
+    name: "cli_safe_exec",
+    description: `Execute shell commands safely with error handling, timeouts, and output validation`,
+    category: "cli",
+    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"],
+    body: `
+# CLI Safe Exec Skill
+
+## Cuándo se Activa
+
+Para ejecutar comandos de shell de forma segura con manejo de errores y timeouts.
+
+## 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.
+
+## 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
+
+## Timeouts Apropiados
+
+| Tipo | Timeout |
+|------|---------|
+| Listar archivos | 10s |
+| Git operations | 30s |
+| npm install | 120s |
+| npm run build | 120s |
+| npm test | 180s |
+| Docker builds | 300s |
+
+## Errores a Evitar
+
+- ❌ Usar para cron (usar cron.create)
+- ❌ Sin timeout apropiado
+- ❌ Ignorar exitCode
+- ❌ Comandos destructivos sin confirmar
+`,
+  },
+  {
+    name: "cli_pipeline",
+    description: `Execute shell commands and pipe output to files for logging and further processing`,
+    category: "cli",
+    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"],
+    body: `
+# CLI Pipeline Skill
+
+## Cuándo se Activa
+
+Para ejecutar comandos y guardar el output en archivos para logging o procesamiento posterior.
+
+## 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 |
+
+## 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
+
+---
+
+## Output
+
+[stdout content...]
+[stderr if any...]
+\`\`\`
+
+## Mejores Prácticas
+
+- Filenames con timestamp para tracking
+- Incluir metadata completa (exitCode, tiempo)
+- Capturar stdout y stderr
+- Para outputs grandes, escribir incrementalmente
+
+## Errores a Evitar
+
+- ❌ No incluir metadata en log
+- ❌ Filenames genéricos sin timestamp
+- ❌ No capturar stderr
+`,
+  },
+  {
+    name: "memory_manager",
+    description: `Complete management of persistent memory including write, read, search, list, and delete operations`,
+    category: "agents",
+    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"],
+    body: `
+# Memory Manager Skill
+
+## Cuándo se Activa
+
+Para guardar, recuperar, buscar, listar o eliminar información persistente entre sesiones.
+
+## 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 |
+
+## Workflow
+
+### 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
+\`\`\`
+
+### List
+\`\`\`javascript
+memory_list({})  // Todos los títulos
+\`\`\`
+
+### 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
+
+- ❌ Datos sensibles (passwords, API keys)
+- ❌ Títulos genéricos ("Config", "Datos")
+- ❌ Sobrescribir sin confirmar
+- ❌ Entradas gigantes (split por tema)
+`,
+  },
+  {
+    name: "research_and_remember",
+    description: `Research information from web sources and save findings to persistent memory`,
+    category: "agents",
+    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"],
+    body: `
+# Research and Remember Skill
+
+## Cuándo se Activa
+
+Para investigar temas en la web y guardar el conocimiento sintetizado en memoria persistente.
+
+## 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 |
+
+## Workflow
+
+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)
+\`\`\`
+
+## 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
+
+## Errores a Evitar
+
+- ❌ Una sola búsqueda (insuficiente)
+- ❌ Sin fuentes (no verificable)
+- ❌ Títulos vagos para memoria
+- ❌ No flaggear información conflictiva
+`,
+  },
+  {
+    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"],
+    body: `
+# Agent Spawner Skill
+
+## Cuándo se Activa
+
+Para crear nuevos workers especializados o gestionar el ciclo de vida de agents existentes.
+
+## 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 |
+
+## 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
+})
+\`\`\`
+
+## 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)
+
+## 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")
+`,
+  },
+  {
+    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"],
+    body: `
+# Task Orchestrator Skill
+
+## Cuándo se Activa
+
+Para coordinar múltiples workers, delegar tareas, monitorear progreso, y facilitar comunicación worker-to-worker.
+
+## 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 |
+
+## 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" }]
+\`\`\`
+
+## 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
+
+## 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
+`,
+  },
+  {
+    name: "code_delegator",
+    description: `Delegate coding tasks to CLI subagents (Qwen, Claude, Gemini, OpenCode) via Code Bridge and monitor execution`,
+    category: "agents",
+    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"],
+    body: `
+# Code Delegator 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).
+
+## 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 |
+
+## 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 |
+
+## 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
+
+## 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
+`,
+  },
+  {
+    name: "canvas_report",
+    description: `Display structured results to users using cards, lists, and progress indicators`,
+    category: "canvas",
+    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"],
+    body: `
+# Canvas Report Skill
+
+## Cuándo se Activa
+
+Para mostrar resultados estructurados visualmente en el canvas del usuario.
+
+## 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 |
+
+## Workflow
+
+1. **Determinar formato** → Card vs List vs Progress
+2. **Renderizar** → \`canvas_show_*\` apropiado
+3. **Clear** → Si cambio de contexto significativo
+
+## Formatos
+
+### 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" }
+  ]
+})
+
+// Full-width card (ocupa todo el ancho del canvas):
+canvas_show_card({
+  title: "Full Report",
+  span: "full",
+  items: [...]
+})
+\`\`\`
+
+### List
+\`\`\`javascript
+canvas_show_list({
+  items: {
+    "Language": "Spanish",
+    "Timezone": "UTC-3",
+    "Channel": "Telegram"
+  }
+})
+\`\`\`
+
+### Progress
+\`\`\`javascript
+canvas_show_progress({
+  bars: [
+    { label: "Research", value: 100 },
+    { label: "Content", value: 60 },
+    { label: "Email", value: 0 }
+  ]
+})
+\`\`\`
+
+## Errores a Evitar
+
+- ❌ Cards con demasiados items (>7)
+- ❌ Labels vagos sin contexto
+- ❌ No clear entre contextos diferentes
+`,
+  },
+  {
+    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"],
+    body: `
+# Canvas Interact Skill
+
+## Cuándo se Activa
+
+Para recoger input del usuario mediante formularios interactivos o confirmaciones.
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| \`canvas_ask\` | Muestra formulario | Input multi-campo |
+| \`canvas_confirm\` | Diálogo confirmación | Yes/No decisions |
+
+## Workflow
+
+### 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" }
+      ]
+    }
+  ]
+})
+\`\`\`
+
+## Tipos de Campo
+
+| 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 |
+
+## Mejores Prácticas
+
+- Labels claros y descriptivos
+- Placeholders con ejemplos
+- Marcar required explícitamente
+- Validar tipos (email, number)
+- Manejar cancel gracefully
+
+## Errores a Evitar
+
+- ❌ 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
+
+## Cuándo se Activa
+
+Para mostrar dashboards visuales de monitoreo en tiempo real de tareas, proyectos, o estado del sistema.
+
+## Herramientas Disponibles
+
+| 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 |
+
+## Workflow
+
+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
+
+## Estructura de Dashboard
+
+\`\`\`javascript
+canvas_render({
+  component: {
+    id: "dashboard-main",
+    type: "markdown",
+    props: { content: "## Dashboard\\n..." },
+    span: "full"   // ← ancho completo del canvas
+  }
+})
+
+// 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
+`,
+  },
+  {
+    name: "a2ui_form",
+    description: `Create rich interactive forms using A2UI v0.9 protocol with validation, data binding, and multi-step flows`,
+    category: "canvas",
+    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"],
+    body: `
+# A2UI Form Skill
+
+## Cuándo se Activa
+
+Para crear formularios interactivos ricos usando el protocolo A2UI v0.9. Usar cuando se necesita:
+- Validación de campos (required, email, regex)
+- Data binding dinámico
+- Formularios multi-paso
+- Choice pickers, sliders, checkboxes
+- Formularios con acciones personalizadas
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| \`a2ui_create_surface\` | Crea la superficie A2UI | Siempre primero |
+| \`a2ui_update_components\` | Envía componentes | Después de crear surface |
+| \`a2ui_update_data_model\` | Actualiza datos | Para valores iniciales o dinámicos |
+| \`a2ui_delete_surface\` | Elimina la superficie | Al terminar |
+
+## Flujo Obligatorio
+
+\`\`\`
+1. a2ui_create_surface(surfaceId, catalogId, theme)
+2. a2ui_update_components(surfaceId, components[])
+3. a2ui_update_data_model(surfaceId, path, value)  // opcional, para datos iniciales
+4. [esperar acción del usuario]
+5. a2ui_delete_surface(surfaceId)  // al terminar
+\`\`\`
+
+## Componentes Disponibles
+
+| Componente | Descripción | Props clave |
+|------------|-------------|-------------|
+| \`Column\` | Layout vertical | \`children\`, \`distribution\`, \`alignment\` |
+| \`Row\` | Layout horizontal | \`children\`, \`distribution\`, \`alignment\` |
+| \`Text\` | Texto | \`text\`, \`usageHint\` (h1-h5, body, caption, code) |
+| \`Button\` | Botón | \`child\`, \`variant\`, \`action\` |
+| \`TextField\` | Campo de texto | \`label\`, \`value\`, \`variant\` (shortText/longText/number/obscured), \`validationRegexp\`, \`checks\`, \`action\` |
+| \`CheckBox\` | Checkbox | \`label\`, \`value\` |
+| \`ChoicePicker\` | Selector múltiple | \`options\`, \`value\` (DynamicStringList), \`variant\` (mutuallyExclusive/multipleSelection), \`displayStyle\`, \`filterable\`, \`action\` |
+| \`Slider\` | Slider numérico | \`value\`, \`minValue\`, \`maxValue\` |
+| \`DateTimeInput\` | Fecha/hora | \`value\`, \`enableDate\`, \`enableTime\` |
+| \`Card\` | Tarjeta | \`child\` |
+| \`Divider\` | Separador | \`axis\` |
+| \`Image\` | Imagen | \`url\`, \`fit\` |
+| \`Tabs\` | Pestañas | \`tabItems\` |
+
+## Data Binding
+
+- Literal: \`"texto directo"\` o número
+- Path: \`{ "path": "/form/name" }\` — se resuelve contra el data model
+- Function call: \`{ "call": "formatDate", "args": {...} }\`
+
+## Cuándo disparan acciones los inputs
+
+| Componente | Cuándo dispara | Formato de action |
+|------------|---------------|-------------------|
+| \`Button\` | Al hacer click | \`{name: "...", context: {...}}\` o \`{event: {name: "...", context: {...}}}\` |
+| \`TextField\` | Al perder foco (blur) o presionar Enter (en shortText) | \`{name: "...", context: {...}}\` |
+| \`ChoicePicker\` | Inmediatamente al seleccionar/deseleccionar | \`{name: "...", context: {...}}\` |
+| \`Slider\` | Al soltar el slider (onValueCommit) | \`{name: "...", context: {...}}\` |
+| \`CheckBox\` | Al cambiar estado | — (solo two-way binding) |
+| \`DateTimeInput\` | Al cambiar valor | — (solo two-way binding) |
+
+**Nota**: Tanto \`{name: "...", context: {...}}\` (directo) como \`{event: {name: "...", context: {...}}}\` (con wrapper) son formatos válidos.
+
+**Nota**: Para ChoicePicker usa siempre \`selections: {path: "..."}\` (no \`value\`) para two-way binding.
+
+## Validación (checks)
+
+\`\`\`json
+"checks": [
+  { "call": "required", "args": { "value": { "path": "/form/email" } }, "message": "Email is required" },
+  { "call": "email", "args": { "value": { "path": "/form/email" } }, "message": "Invalid email" },
+  { "call": "regex", "args": { "value": { "path": "/form/phone" }, "pattern": "^\\\\d{10}$" }, "message": "10 digits required" }
+]
+\`\`\`
+
+## Ejemplo: Formulario de Contacto
+
+\`\`\`json
+// 1. Create surface
+a2ui_create_surface(surfaceId: "contact_form", catalogId: "https://a2ui.org/specification/v0_9/basic_catalog.json", theme: {primaryColor: "#3B82F6", agentDisplayName: "Asistente"})
+
+// 2. Send components
+a2ui_update_components(surfaceId: "contact_form", components: [
+  {"id": "root", "component": "Column", "children": ["header","name_field","email_field","msg_field","submit_btn"]},
+  {id: "header", component: "Text", text: "Contacto", variant: "h2"},
+  {id: "name_field", component: "TextField", label: "Nombre", value: {path: "/form/name"}, variant: "shortText"},
+  {id: "email_field", component: "TextField", label: "Email", value: {path: "/form/email"}, variant: "shortText", validationRegexp: "^[^@]+@[^@]+\\\\.[^@]+$", checks: [{call: "required", args: {value: {path: "/form/email"}}, message: "Email obligatorio"}, {call: "email", args: {value: {path: "/form/email"}}, message: "Email inválido"}]},
+  {id: "msg_field", component: "TextField", label: "Mensaje", value: {path: "/form/message"}, variant: "longText"},
+  {id: "submit_label", component: "Text", text: "Enviar"},
+  {id: "submit_btn", component: "Button", child: "submit_label", variant: "primary", action: {event: {name: "submit_contact", context: {name: {path: "/form/name"}, email: {path: "/form/email"}, message: {path: "/form/message"}}}}
+])
+
+// 3. Initialize data model
+a2ui_update_data_model(surfaceId: "contact_form", path: "/form", value: {name: "", email: "", message: ""})
+\`\`\`
+
+## Mejores Prácticas
+
+- Siempre incluir un componente \`root\` con id="root"
+- Usar \`{ path: "/..." }\` para data binding en TextField values
+- 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`,
+  },
+  {
+    name: "a2ui_dashboard",
+    description: `Create real-time interactive dashboards using A2UI v0.9 protocol with dynamic data binding and live updates`,
+    category: "canvas",
+    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"],
+    body: `
+# A2UI Dashboard Skill
+
+## Cuándo se Activa
+
+Para crear dashboards interactivos en tiempo real usando A2UI v0.9. Usar cuando se necesita:
+- Métricas que se actualizan dinámicamente
+- Dashboards con data binding
+- Paneles con Cards, Rows, Columns
+- Visualización de datos que cambia en tiempo real
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| \`a2ui_create_surface\` | Crea la superficie A2UI | Siempre primero |
+| \`a2ui_update_components\` | Envía componentes | Para layout del dashboard |
+| \`a2ui_update_data_model\` | Actualiza datos | Para métricas dinámicas |
+| \`a2ui_delete_surface\` | Elimina la superficie | Al cerrar dashboard |
+
+## Flujo Obligatorio
+
+\`\`\`
+1. a2ui_create_surface(surfaceId, catalogId, theme)
+2. a2ui_update_components(surfaceId, components[])
+3. a2ui_update_data_model(surfaceId, path, value)  // datos iniciales
+4. [actualizar métricas con a2ui_update_data_model según necesidad]
+5. a2ui_delete_surface(surfaceId)  // al terminar
+\`\`\`
+
+## Patrón de Dashboard Típico
+
+\`\`\`json
+[
+  {"id": "root", "component": "Column", "children": ["title", "metrics_row", "tasks_list"]},
+  {"id": "title", "component": "Text", "text": "Dashboard de Proyecto", "variant": "h1"},
+
+  {"id": "metrics_row", "component": "Row", "children": ["card1", "card2", "card3"]},
+  {"id": "card1", "component": "Card", "child": "card1_content", "weight": 1},
+  {"id": "card1_content", "component": "Column", "children": ["card1_label", "card1_value"]},
+  {"id": "card1_label", "component": "Text", "text": "Completado", "variant": "caption"},
+  {"id": "card1_value", "component": "Text", "text": {"path": "/metrics/completionRate"}, "variant": "h2"},
+
+  {"id": "tasks_list", "component": "List", "children": {"path": "/tasks", "componentId": "task_template"}},
+  {"id": "task_template", "component": "Card", "child": "task_content"},
+  {"id": "task_content", "component": "Column", "children": ["task_name", "task_status"]},
+  {"id": "task_name", "component": "Text", "text": {"path": "/name"}},
+  {"id": "task_status", "component": "Text", "text": {"path": "/status"}, "variant": "caption"}
+]
+\`\`\`
+
+## Actualización en Tiempo Real
+
+Para actualizar métricas específicas sin reenviar componentes:
+\`\`\`json
+a2ui_update_data_model(surfaceId: "dash", path: "/metrics/completionRate", value: 85)
+a2ui_update_data_model(surfaceId: "dash", path: "/metrics/totalTasks", value: 24)
+\`\`\`
+
+Para reemplazar todo el data model:
+\`\`\`json
+a2ui_update_data_model(surfaceId: "dash", path: "/", value: {metrics: {completionRate: 90, totalTasks: 25}, tasks: [...]})
+\`\`\`
+
+## Mejores Prácticas
+
+- Usar \`weight\` en Row/Column para proporciones (weight:1 vs weight:3 = 25% vs 75%)
+- Agrupar métricas en Cards para separación visual
+- 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`,
+  },
+  {
+    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",
+    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"],
+    body: `
+# A2UI Interactive Skill
+
+## Cuándo se Activa
+
+Para crear flujos interactivos multi-paso usando A2UI v0.9. Usar cuando se necesita:
+- Wizards paso a paso
+- Flujos de onboarding
+- Asistentes de reserva/configuración
+- Formularios con selections dinámicas
+- Interacciones con modales de confirmación
+- UIs que cambian según las acciones del usuario
+
+## Herramientes Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| \`a2ui_create_surface\` | Crea la superficie A2UI | Siempre primero |
+| \`a2ui_update_components\` | Envía/actualiza componentes | Para layout y cambios de UI |
+| \`a2ui_update_data_model\` | Actualiza datos | Para estado del workflow |
+| \`a2ui_delete_surface\` | Elimina la superficie | Al terminar flujo |
+
+## Flujo Obligatorio
+
+\`\`\`
+1. a2ui_create_surface(surfaceId, catalogId, theme)
+2. a2ui_update_components(surfaceId, components[])
+3. a2ui_update_data_model(surfaceId, path, value)  // estado inicial
+4. [recibir acción del usuario]
+5. a2ui_update_data_model(...)  // actualizar estado con respuesta
+6. a2ui_update_components(...)  // cambiar UI al siguiente paso
+7. ... repetir 4-6 según necesidad ...
+8. a2ui_delete_surface(surfaceId)  // al terminar
+\`\`\`
+
+## Patrones de Flujo Interactivo
+
+### Wizard con Tabs (multi-paso)
+
+\`\`\`json
+[
+  {id: "root", component: "Column", children: ["step_indicator", "tabs"]},
+  {id: "step_indicator", component: "Text", text: {path: "/stepLabel"}, variant: "caption"},
+  {id: "tabs", component: "Tabs", tabs: [
+    {title: "Servicio", child: "step1"},
+    {title: "Fecha", child: "step2"},
+    {title: "Confirmar", child: "step3"}
+  ]},
+  {id: "step1", component: "Column", children: ["svc_label", "svc_picker"]},
+  {id: "svc_label", component: "Text", text: "Seleccioná un servicio", variant: "h3"},
+  {id: "svc_picker", component: "ChoicePicker", variant: "mutuallyExclusive", options: [...], value: {path: "/data/service"}},
+  // ... más pasos
+]
+\`\`\`
+
+### Confirmación con Modal
+
+\`\`\`json
+[
+  {id: "confirm_modal", component: "Modal", trigger: "confirm_btn", content: "confirm_dialog"},
+  {id: "confirm_btn", component: "Button", child: "confirm_btn_text", action: {}},
+  {id: "confirm_btn_text", component: "Text", text: "Confirmar Reserva"},
+  {id: "confirm_dialog", component: "Column", children: ["confirm_msg", "confirm_yes", "confirm_no"]},
+  {id: "confirm_msg", component: "Text", text: "¿Confirmás tu reserva?"},
+  {id: "confirm_yes", component: "Button", child: "yes_text", variant: "primary", action: {event: {name: "confirm_booking", context: {service: {path: "/data/service"}}}}},
+  {id: "yes_text", component: "Text", text: "Sí, confirmar"},
+  {id: "confirm_no", component: "Button", child: "no_text", variant: "borderless", action: {event: {name: "cancel"}}}},
+  {id: "no_text", component: "Text", text: "Cancelar"}
+]
+\`\`\`
+
+### Selección con ChoicePicker
+
+\`\`\`json
+[
+  {id: "service_picker", component: "ChoicePicker",
+    variant: "mutuallyExclusive",
+    options: [
+      {label: "Consulta General", value: "general"},
+      {label: "Especializada", value: "specialist"},
+      {label: "Urgencia", value: "urgent"}
+    ],
+    value: {path: "/data/serviceType"},
+    action: {event: {name: "service_selected", context: {service: {path: "/data/serviceType"}}}}
+  }
+]
+\`\`\`
+
+## Mejores Prácticas
+
+- Usar Tabs para wizards multi-paso
+- Usar Modal para confirmaciones antes de acciones críticas
+- Usar ChoicePicker con \`variant: "mutuallyExclusive"\` para selección única
+- Mostrar indicador de progreso (paso X de Y)
+- Actualizar data model después de cada acción del usuario
+- 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
+`,
+  },
+];