@johpaz/hive-agents 0.0.35 → 0.0.37

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

@@ -0,0 +1,1964 @@
+// 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: "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: "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: "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: "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: "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
+`,
+  },
+  {
+    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: "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: "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: "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: "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: "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: "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_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_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_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: "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: "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: "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: "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: "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: "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: "busqueda_fts5",
+    description: `Core discovery skill - find any capability with a single keyword`,
+    category: "core",
+    version: "1.2.0",
+    tools: ["search_knowledge"],
+    triggers: ["cómo busco herramientas","cómo encuentro skills","how to find tools","search knowledge","discovery","buscar en la base","encontrar herramientas"],
+    body: `
+# busqueda_fts5 — Sistema de Discovery
+
+Arrancás con solo 4 herramientas. Todo lo demás se descubre con **search_knowledge**.
+
+## Regla de oro: UNA PALABRA, busca TODO
+
+\`\`\`
+search_knowledge(query="email")
+\`\`\`
+
+Eso solo — sin type, sin frases largas — devuelve tools, skills, MCP y playbook relacionados con "email".
+
+**NO hagas esto:** \`search_knowledge(type="tools", query="enviar correo electrónico")\` — AND entre palabras no encuentra nada.
+
+**SÍ hagas esto:** \`search_knowledge(query="email")\` — encuentra todo lo relacionado.
+
+## Cuándo especificar type
+
+Solo si querés filtrar resultados que ya son muchos:
+
+\`\`\`
+search_knowledge(query="email", type="mcp")   → solo herramientas externas de email
+search_knowledge(query="email", type="tools") → solo herramientas nativas de email
+\`\`\`
+
+Por defecto type="all" — no hace falta especificarlo.
+
+## Regla de prioridad
+
+**Preferí herramientas nativas sobre MCP** cuando ambas sirven.
+- Nativas: más rápidas, sin red, siempre disponibles
+- MCP: cuando no hay equivalente nativo
+
+## Flujo de uso
+
+1. Identificá la palabra clave de lo que necesitás
+2. \`search_knowledge(query="<palabra>")\` → resultados de todos los tipos
+3. Las tools encontradas se inyectan automáticamente en tu contexto
+4. Usás las tools en el siguiente paso
+
+---
+
+## Ejemplos
+
+\`\`\`
+search_knowledge(query="pdf")       → tools para leer/escribir PDFs
+search_knowledge(query="browser")   → tools de navegación web
+search_knowledge(query="github")    → tools MCP de GitHub si están configuradas
+search_knowledge(query="calendar")  → tools de Google Calendar
+search_knowledge(query="canvas")    → skills de visualización
+search_knowledge(query="slack")     → tools de Slack si están configuradas
+\`\`\`
+`,
+  },
+  {
+    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: "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: ["fs_list","fs_glob","fs_exists"],
+    triggers: ["lista los archivos","list files","buscá archivos","find files","explorá el proyecto","explore project","qué archivos hay","what files exist","buscá por patrón","search by pattern","existe este archivo","file exists","dónde está","where is"],
+    body: `
+# 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 |
+|------|----------|---------------|
+| \`fs_list\` | Lista directorios y archivos | Exploración inicial |
+| \`fs_glob\` | Busca archivos por patrón wildcard | Búsqueda por extensión/patrón |
+| \`fs_exists\` | Verifica existencia | Pre-check antes de operaciones |
+
+## Workflow
+
+1. **Explorar** → \`fs_list({ path })\` para estructura general
+2. **Buscar por patrón** → \`fs_glob({ pattern })\` para tipos específicos
+3. **Verificar** → \`fs_exists({ path })\` para confirmación
+
+## 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 fs_list cuando se conoce el patrón (usar glob)
+- ❌ Patrones muy amplios sin filtrado
+`,
+  },
+  {
+    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`,
+  },
+];