Update to Glop

{
  "description": "Usa esta skill cuando el usuario quiera preparar un informe de sus compras a proveedores en Glop para enviárselo a su asesor, gestor o contable: \"prepárame el informe de compras del mes para mi asesor\", \"necesito mandar a la gestoría lo que he comprado este trimestre\", \"haz un PDF con las compras para el contable\". Reúne las cifras con las tools glop_compras_*, compone un informe en PDF pensado para quien lleva la contabilidad (resumen, gasto por proveedor con base e IVA, artículos principales y limitaciones de los datos) y prepara el correo de envío. Si el asistente dispone de una herramienta de correo, ofrece enviarlo desde ahí tras confirmación; si no, entrega el PDF y el texto del correo listos para pegar. No sustituye a las facturas de proveedor ni a los libros registro.\n",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 267
    }
  ],
  "name": "informe-compras-asesor",
  "skill_md_contents": "---\r\nname: informe-compras-asesor\r\ndescription: >\r\n  Usa esta skill cuando el usuario quiera preparar un informe de sus compras a proveedores en\r\n  Glop para enviárselo a su asesor, gestor o contable: \"prepárame el informe de compras del\r\n  mes para mi asesor\", \"necesito mandar a la gestoría lo que he comprado este trimestre\",\r\n  \"haz un PDF con las compras para el contable\". Reúne las cifras con las tools glop_compras_*,\r\n  compone un informe en PDF pensado para quien lleva la contabilidad (resumen, gasto por\r\n  proveedor con base e IVA, artículos principales y limitaciones de los datos) y prepara el\r\n  correo de envío. Si el asistente dispone de una herramienta de correo, ofrece enviarlo\r\n  desde ahí tras confirmación; si no, entrega el PDF y el texto del correo listos para pegar.\r\n  No sustituye a las facturas de proveedor ni a los libros registro.\r\n---\r\n\r\n# Informe de compras para el asesor\r\n\r\nPrepara un documento que el dueño del negocio pueda mandar a su asesor sin tener que\r\nexplicarlo: qué ha comprado, a quién, cuánto ha sido base y cuánto IVA, y qué fiabilidad\r\ntienen esas cifras. Va en tres fases: **datos**, **PDF** y **envío**. Cada una se cierra con\r\nel usuario antes de pasar a la siguiente.\r\n\r\nLas cifras las calculan las tools de Glop. Tú no sumas ni recalculas nada: ordenas,\r\npresentas y explicas.\r\n\r\n## Lo que no se negocia\r\n\r\n1. **Nada sale del asistente sin un sí explícito del usuario.** Ni el PDF se da por bueno\r\n   ni el correo se envía sin que el usuario haya visto el contenido y el destinatario.\r\n2. **El informe no es un documento fiscal.** Lo dice en su portada y lo dices tú: el asesor\r\n   contabiliza con las facturas de proveedor, y este informe le sirve para cuadrar,\r\n   anticipar el IVA soportado y detectar facturas que faltan.\r\n3. **No inventes datos del asesor.** Nombre, correo y tratamiento se preguntan o se toman de\r\n   lo que el usuario haya dicho. Nunca se buscan en fuentes externas.\r\n4. **Manda lo justo.** Al asesor le va el PDF. No pegues las tablas en el cuerpo del correo\r\n   ni añadas datos que no se le hayan enseñado al usuario.\r\n5. Habla en el idioma del usuario. Fechas en `YYYY-MM-DD` en las tools y en formato local\r\n   en el informe (`31/08/2026`). Importes con dos decimales y símbolo de moneda.\r\n\r\n## Fase 1 — Datos\r\n\r\n1. Si es la primera llamada de la conversación, `glop_diagnostico`. Si `mcp_activa` no es\r\n   `true` o alguna tool `glop_compras_*` está en `tools_deshabilitadas`, dilo y para.\r\n2. **Fija el periodo.** Si el usuario no lo indica, propón el **mes natural anterior**\r\n   completo (es lo que suele pedir un asesor) y confírmalo antes de seguir. Para un\r\n   trimestre, usa el trimestre natural. El rango máximo es de 365 días.\r\n3. Pregunta, en un solo mensaje, lo que falte:\r\n   - Nombre del negocio como quiere que figure (razón social o nombre comercial).\r\n   - Nombre del asesor y su correo, solo si va a haber envío.\r\n   - Si quiere incluir la sección de artículos principales (por defecto sí) y la de compras\r\n     frente a ventas (por defecto **no**: tarda más de un minuto en sitios grandes y su\r\n     lectura exige matices).\r\n4. Llama a las tools, todas con el mismo `from` y `to`:\r\n   - `glop_compras_get_purchases_by_supplier` con `limit` 100. Trae por proveedor\r\n     `total_base`, `total_tax`, `total`, `num_documents`, primera y última compra y\r\n     `share_percentage`, y en `period_totals` los totales del periodo. Es la columna\r\n     vertebral del informe.\r\n   - `glop_compras_get_top_purchased_products` con `limit` 15, si el usuario la quiere.\r\n   - `glop_compras_compare_purchases_vs_sales` con `granularity` `month`, solo si la ha\r\n     pedido expresamente. Guarda su `disclaimer` tal cual.\r\n5. Anota `document_types_included` de cada respuesta: por defecto cuenta albaranes (tipo 2)\r\n   y facturas de proveedor (tipo 3), y los pedidos quedan fuera. El informe lo dirá.\r\n6. Enseña al usuario el **resumen en texto** antes de montar nada: total del periodo (base,\r\n   IVA, total), número de documentos, los cinco proveedores con más peso y cualquier cosa\r\n   que llame la atención (un proveedor con un solo documento y mucho importe, un mes sin\r\n   compras, un total que no se parece al que él espera). Si algo no le cuadra, la primera\r\n   causa es siempre la de la sección \"Limitaciones\": lo tecleado directamente en el TPV no\r\n   está aquí.\r\n\r\n## Fase 2 — El PDF\r\n\r\nGenera el PDF con la herramienta de creación de ficheros o de ejecución de código que\r\ntenga tu entorno. Si no tienes ninguna, entrega el informe en HTML o Markdown listo para\r\n\"Imprimir → Guardar como PDF\" y dilo con claridad; no prometas un PDF que no puedes crear.\r\n\r\nNombre del fichero: `compras-<negocio>-<YYYY-MM>.pdf` (o `<YYYY>-T<n>` para un trimestre),\r\nsin espacios ni acentos.\r\n\r\n### Estructura\r\n\r\n1. **Portada**: \"Informe de compras a proveedores\", nombre del negocio, periodo, fecha de\r\n   emisión, y la frase: *\"Informe informativo generado desde el TPV Glop. No sustituye a las\r\n   facturas de proveedor ni a los libros registro.\"*\r\n2. **Resumen del periodo**: base imponible, IVA soportado, total, número de documentos,\r\n   número de proveedores, tipos de documento incluidos. En una tabla de una fila o en\r\n   tarjetas.\r\n3. **Gasto por proveedor**: tabla ordenada por gasto con proveedor, número de documentos,\r\n   base, IVA, total, peso sobre el periodo, primera y última compra. Fila final de totales\r\n   que debe coincidir con `period_totals`; si la tool devolviera menos proveedores que los\r\n   que existen, dilo en una nota al pie en lugar de forzar el cuadre.\r\n4. **Artículos principales** (opcional): descripción, cantidad, gasto sin IVA, precio medio\r\n   ponderado, precio de la última compra, proveedores que lo sirven.\r\n5. **Compras frente a ventas** (solo si se pidió): la tabla mensual de la tool y su\r\n   `disclaimer` literal debajo. No lo llames margen.\r\n6. **Limitaciones de los datos**, siempre, con este contenido:\r\n   - Solo recoge las compras registradas por los canales de Glop (módulo de Compras, este\r\n     asistente y el chat de la app). Lo tecleado directamente en el TPV no aparece.\r\n   - Un documento editado o borrado en el TPV después de registrarse no se actualiza aquí.\r\n   - Los abonos figuran como importes negativos dentro de su documento.\r\n   - Un albarán (tipo 2) es mercancía recibida que puede no estar facturada todavía; el\r\n     asesor debe cotejar con las facturas reales.\r\n   - El IVA se agrupa por el tipo aplicado en cada línea.\r\n\r\n### Estilo\r\n\r\nSobrio y legible en blanco y negro: tipografía del sistema, tablas con cabecera sombreada,\r\nimportes alineados a la derecha, sin gráficos que no aporten. Pie de página con \"Generado\r\ncon Glop · página X de Y\". Sin logotipos que no te haya dado el usuario.\r\n\r\nEnseña el PDF (o su vista previa) y pide el visto bueno. Un cambio de periodo obliga a\r\nvolver a la fase 1; un cambio de formato se resuelve aquí.\r\n\r\n## Fase 3 — Envío al asesor\r\n\r\n1. **Mira qué herramientas de correo tienes disponibles** en esta conversación: un\r\n   conector de Gmail, Outlook o Microsoft 365, un servicio de envío como Brevo o SendGrid, o\r\n   cualquier tool cuyo nombre o descripción hable de enviar correo. No des por hecho que\r\n   existe ni que no existe: compruébalo en tu lista de herramientas.\r\n2. **Si la tienes**: redacta el correo, enséñalo entero al usuario (destinatario, asunto,\r\n   cuerpo y nombre del adjunto) y pide un sí explícito. Solo entonces envíalo, con el PDF\r\n   adjunto y, si el conector lo permite, con copia al propio usuario. Confirma después con\r\n   lo que devuelva la herramienta; si falla, dilo y pasa al punto 3.\r\n3. **Si no la tienes**: entrega el PDF y, en un bloque aparte, el asunto y el cuerpo del\r\n   correo listos para copiar, y explica en una línea que tiene que adjuntar el fichero desde\r\n   su cliente de correo. No intentes enviar por otros medios.\r\n4. Si el asistente dispone de una tool de notificación pero no de correo (un aviso al\r\n   propio usuario, un mensaje en un canal), úsala solo para avisarle de que el informe está\r\n   listo, nunca para hacer llegar el PDF al asesor.\r\n\r\n### Plantilla del correo\r\n\r\n- **Asunto**: `Compras a proveedores <negocio> · <periodo>`\r\n- **Cuerpo**: saludo con el nombre del asesor; una frase con el periodo y el total (base,\r\n  IVA, total); una frase que diga que el detalle por proveedor va en el PDF adjunto y que se\r\n  ha generado desde el TPV Glop a partir de los albaranes y facturas registrados; una\r\n  frase que recuerde que no sustituye a las facturas y que agradecerá aviso si detecta\r\n  alguna que falte; despedida con el nombre del usuario.\r\n\r\nSin tablas ni cifras por proveedor en el cuerpo: eso va en el adjunto.\r\n\r\n## Lo que esta skill no hace\r\n\r\n- No registra ni modifica documentos de compra (`alta-albaran-compra`).\r\n- No responde preguntas puntuales sobre compras (`analisis-compras`).\r\n- No emite libros registro de facturas recibidas ni modelos tributarios.\r\n- No busca el correo del asesor en ningún sitio ni envía nada sin confirmación.\r\n"
}