Transcript To Workflow

Transcript to Workflow

Este skill transforma transcripciones de reuniones desordenadas en JSON técnico estructurado, listo para implementar automatizaciones.

Cuándo Usar Este Skill

Usa este skill cuando el usuario:

• Comparte una transcripción o resumen de una reunión
• Describe un proceso que quiere automatizar en lenguaje natural
• Menciona necesidades como "cuando llegue un correo...", "si pasa X entonces...", "quiero que el sistema haga..."
• Quiere convertir requisitos verbales en estructura técnica

##Qué Hace Este Skill

Entrada

Transcripción de reunión en lenguaje natural, por ejemplo:

"Hola, mira, necesitamos que cuando llegue un correo con una factura, el sistema la lea y la guarde en Drive. Si no tiene PDF, que avise por Slack."

Salida

JSON estructurado con:

• summary: Resumen técnico de 1 línea
• entities: Actores, sistemas involucrados, tipo de trigger
• workflow_data: Inputs, outputs, happy path steps, excepciones detectadas

Ejemplo de Salida

{
  "summary": "Automatización de lectura de facturas por email con almacenamiento en Drive y notificaciones Slack",
  "entities": {
    "actors": ["Sistema", "Usuario"],
    "systems_involved": ["Email", "Drive", "Slack"],
    "trigger_type": "INSTANT",
    "trigger_detail": "Webhook al recibir email con factura"
  },
  "workflow_data": {
    "inputs": ["Email entrante", "Archivo PDF adjunto"],
    "outputs": ["Archivo en Drive", "Notificación en Slack"],
    "happy_path_steps": [
      "Recibir email con adjunto",
      "Detectar si es factura (PDF)",
      "Leer contenido del PDF",
      "Guardar en carpeta de Drive",
      "Enviar confirmación por Slack"
    ],
    "detected_exceptions": [
      "Si no hay PDF -> Notificar por Slack que falta documento"
    ]
  }
}

Cómo Usar

Simplemente comparte la transcripción o descripción del proceso que quieres automatizar. El skill la procesará y devolverá la estructura JSON lista para implementar en tu herramienta de automatización favorita (n8n, Zapier, Make, etc.).

Integración

Este skill puede integrarse con:

• n8n
• Zapier
• Make (Integromat)
• Pipedream
• Cualquier herramienta que soporte webhooks y JSON

Reglas de Diseño Espacial (Grid System)

Al extraer el flujo de la transcripción y estructurar el proceso BPMN, debes asignar coordenadas matemáticas lógicas para facilitar la visualización posterior:

Carriles (Eje Y)

Asigna una coordenada Y fija para cada actor/rol:

• Comercial: Y = 100
• Operaciones: Y = 400
• Cliente: Y = 700

(Incrementos de 300 en 300 para cada nuevo rol/actor)

Secuencia de Tiempo (Eje X)

Cada paso del proceso debe avanzar en el eje X en incrementos de 300 a 400 píxeles:

• Paso 1: X = 100
• Paso 2: X = 450
• Paso 3: X = 800

(Incrementos de 300-400 entre cada paso)

Salida con Coordenadas

La estructura debe incluir la propuesta de coordenadas X e Y para cada nodo:

{
  "summary": "Automatización de lectura de facturas...",
  "entities": { ... },
  "workflow_data": {
    "inputs": [...],
    "outputs": [...],
    "happy_path_steps": [
      {
        "step": "Recibir email con adjunto",
        "x": 100,
        "y": 400,
        "actor": "Sistema"
      },
      {
        "step": "Detectar si es factura (PDF)",
        "x": 450,
        "y": 400,
        "actor": "Sistema"
      },
      {
        "step": "Guardar en carpeta de Drive",
        "x": 800,
        "y": 400,
        "actor": "Sistema"
      },
      {
        "step": "Enviar confirmación por Slack",
        "x": 1150,
        "y": 700,
        "actor": "Cliente"
      }
    ],
    "detected_exceptions": [...]
  }
}

Instalación

npx skills add JefferCB1/skill-orchestrador@transcript-to-workflow

O si ya tienes el repo clonado localmente:

npx skills add .agents/skills/transcript-to-workflow --global