# Skills para agentes > Paquetes de instrucciones listos para que un agente use el MCP de Tilopay en tareas concretas, como el cierre de caja, cobrar por WhatsApp o recuperar pagos rechazados. - kind: guide - status: stable - last_verified: 2026-10-07 - url: https://tilopay.com/developers/agentes/mcp/skills ## Qué es una skill [#que-es] Una skill es un paquete de instrucciones (un `SKILL.md` más sus referencias) que el agente carga sólo cuando el comercio le pide algo de ese tema. No requiere código ni credenciales: usa el MCP de Tilopay que ya está conectado, y las instrucciones le dicen qué herramientas llamar, en qué orden y cómo validar los números antes de responder. La diferencia con las [recetas](/developers/agentes/mcp/recetas) es que la receta es el ejemplo de prompt; la skill lo deja empaquetado y repetible, con reglas de cálculo y de seguridad. ## Antes de empezar [#antes] Necesitás una cuenta de Tilopay. Si instalás el plugin (opción 2 de abajo), el conector del MCP viene incluido y solo tenés que autorizarlo con tu cuenta la primera vez. Para las demás opciones, primero [conectá el MCP en tu cliente](/developers/agentes/mcp/conectar). Las skills no piden ni guardan credenciales. ## Skills disponibles [#skills] ### Todas las skills en un plugin Las seis skills y el conector del MCP de Tilopay en un solo plugin para Cowork, el chat de claude.ai y Claude Code. Instalalo desde el marketplace de Tilopay con los comandos de abajo. ```text /plugin marketplace add tilopay/claude-plugins /plugin install tilopay-mcp-skills@tilopay ``` - [Ver en GitHub](https://github.com/tilopay/claude-plugins) - Versión: 1.0.1 - Copiar prompt para Claude Code: «Lee el índice de skills de Tilopay en https://tilopay.com/developers/skills/index.md, crea una carpeta por skill dentro de ~/.claude/skills/ con el nombre de la skill, guarda el SKILL.md de cada una dentro de su carpeta y luego dime qué skills quedaron instaladas.» ### cierre-de-caja Cierre de caja del día, la semana o el mes por moneda: aprobadas, rechazadas, reembolsos, desglose exacto de comisiones y retenciones, neto a liquidar y próximo depósito, con validación de que los números cuadran contra el balance oficial de Tilopay. - Prompt de ejemplo: «Dame el cierre de caja de hoy» - Herramientas del MCP: `tilopay_list_transactions`, `tilopay_sales_summary`, `tilopay_settlement_balance`, `tilopay_settlements_list`, `tilopay_switch_commerce` - Grupos: [Ventas y transacciones](https://tilopay.com/developers/agentes/mcp/ventas) - Versión: 1.0.1 - [SKILL.md](https://tilopay.com/developers/skills/cierre-de-caja/SKILL.md) - Prompt para usarla sin instalar: «Lee https://tilopay.com/developers/skills/cierre-de-caja/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. Dame el cierre de caja de hoy» ### cobrar-por-whatsapp Convierte una frase en un cobro real y en el mensaje de WhatsApp listo para enviar; genera el QR si se pide y verifica después si el cliente ya pagó. - Prompt de ejemplo: «Cóbrale 25 mil colones a Ana por el curso de fotografía» - Herramientas del MCP: `tilopay_create_charge`, `tilopay_send_payment_link_whatsapp`, `tilopay_send_payment_link_email`, `tilopay_payment_link_qr`, `tilopay_list_receipts`, `tilopay_find_payment`, `tilopay_list_contacts` - Grupos: [Enlaces de pago](https://tilopay.com/developers/agentes/mcp/enlaces-de-pago), [Comprobantes](https://tilopay.com/developers/agentes/mcp/comprobantes), [Contactos](https://tilopay.com/developers/agentes/mcp/contactos) - Versión: 1.0.1 - [SKILL.md](https://tilopay.com/developers/skills/cobrar-por-whatsapp/SKILL.md) - Prompt para usarla sin instalar: «Lee https://tilopay.com/developers/skills/cobrar-por-whatsapp/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. Cóbrale 25 mil colones a Ana por el curso de fotografía» ### rechazos-y-recuperacion Analiza los pagos rechazados, los agrupa por motivo con las etiquetas de la guía oficial «Motivos de rechazo», detecta patrones (mismo cliente reintentando, misma orden recuperada después, canal, horario) y propone acciones concretas, incluido el mensaje al cliente y un enlace nuevo. - Prompt de ejemplo: «¿Por qué me rechazaron pagos este mes y cuáles puedo recuperar?» - Herramientas del MCP: `tilopay_list_transactions`, `tilopay_sales_summary`, `tilopay_create_charge`, `tilopay_send_payment_link_whatsapp`, `tilopay_help_guides` - Grupos: [Ventas y transacciones](https://tilopay.com/developers/agentes/mcp/ventas), [Enlaces de pago](https://tilopay.com/developers/agentes/mcp/enlaces-de-pago), [Soporte y diagnóstico](https://tilopay.com/developers/agentes/mcp/soporte) - Versión: 1.0.1 - [SKILL.md](https://tilopay.com/developers/skills/rechazos-y-recuperacion/SKILL.md) - Prompt para usarla sin instalar: «Lee https://tilopay.com/developers/skills/rechazos-y-recuperacion/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. ¿Por qué me rechazaron pagos este mes y cuáles puedo recuperar?» - [Guía «Motivos de rechazo»](https://tilopay.com/guias/panel-transacciones/motivos-de-rechazo) ### conciliacion-mensual Conciliación contable de un mes, quincena o rango: cruza ventas aprobadas, reembolsos y liquidaciones depositadas, con los seis campos de costo etiquetados, y entrega un CSV o Excel para el contador más un resumen de diferencias. - Prompt de ejemplo: «Concíliame septiembre para el contador» - Herramientas del MCP: `tilopay_list_transactions`, `tilopay_refunds_list`, `tilopay_settlements_list`, `tilopay_settlement_transactions`, `tilopay_settlement_balance`, `tilopay_billing_list`, `tilopay_switch_commerce` - Grupos: [Ventas y transacciones](https://tilopay.com/developers/agentes/mcp/ventas), [Liquidaciones, depósitos y facturación](https://tilopay.com/developers/agentes/mcp/liquidaciones), [Cuenta, comercio y equipo](https://tilopay.com/developers/agentes/mcp/cuenta) - Versión: 1.0.0 - [SKILL.md](https://tilopay.com/developers/skills/conciliacion-mensual/SKILL.md) - Prompt para usarla sin instalar: «Lee https://tilopay.com/developers/skills/conciliacion-mensual/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. Concíliame septiembre para el contador» ### cfo-de-bolsillo Análisis financiero de ventas: compara períodos del mismo largo, ticket promedio, mejores días y horas, concentración de clientes, costo efectivo de Tilopay como porcentaje de la venta y una proyección simple de cierre de mes y flujo con el próximo depósito, siempre etiquetada como estimación. - Prompt de ejemplo: «¿Cómo voy este mes comparado con el anterior?» - Herramientas del MCP: `tilopay_list_transactions`, `tilopay_sales_summary`, `tilopay_settlement_balance`, `tilopay_settlements_list`, `tilopay_get_business_profile` - Grupos: [Ventas y transacciones](https://tilopay.com/developers/agentes/mcp/ventas), [Liquidaciones, depósitos y facturación](https://tilopay.com/developers/agentes/mcp/liquidaciones), [Perfil del comercio](https://tilopay.com/developers/agentes/mcp/perfil) - Versión: 1.0.0 - [SKILL.md](https://tilopay.com/developers/skills/cfo-de-bolsillo/SKILL.md) - Prompt para usarla sin instalar: «Lee https://tilopay.com/developers/skills/cfo-de-bolsillo/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. ¿Cómo voy este mes comparado con el anterior?» ### catalogo-y-cobros-fijos Gestiona el catálogo de productos y servicios: busca productos con su enlace de pago, crea o edita desde una frase o una lista, entrega el QR de un producto o el QR permanente de mostrador, y conecta el catálogo a Facebook/Instagram, Google Shopping, TikTok o Pinterest. - Prompt de ejemplo: «Agregá al catálogo Clase de yoga a 8 mil colones» - Herramientas del MCP: `tilopay_catalog_list_items`, `tilopay_catalog_get_item`, `tilopay_catalog_create_item`, `tilopay_catalog_update_item`, `tilopay_catalog_delete_item`, `tilopay_payment_link_qr`, `tilopay_static_payment_qr`, `tilopay_catalog_feed`, `tilopay_store_list`, `tilopay_send_payment_link_whatsapp` - Grupos: [Catálogo](https://tilopay.com/developers/agentes/mcp/catalogo), [Enlaces de pago](https://tilopay.com/developers/agentes/mcp/enlaces-de-pago), [Microtienda](https://tilopay.com/developers/agentes/mcp/microtienda) - Versión: 1.0.0 - [SKILL.md](https://tilopay.com/developers/skills/catalogo-y-cobros-fijos/SKILL.md) - Prompt para usarla sin instalar: «Lee https://tilopay.com/developers/skills/catalogo-y-cobros-fijos/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. Agregá al catálogo Clase de yoga a 8 mil colones» ## Cómo instalar [#instalar] **Opción 1 · Usarla ahora mismo, sin instalar nada (Claude, ChatGPT u otro asistente con el MCP conectado).** 1. Abrí una conversación nueva con el MCP de Tilopay conectado. 2. En la tarjeta de la skill, tocá «Copiar prompt». 3. Pegalo y enviá. El asistente lee las instrucciones desde tilopay.com y las aplica en esa conversación. La próxima vez, volvé a pegar el prompt (o usá la opción 2 para dejarla fija). Por ejemplo, el prompt del cierre de caja: ```text Lee https://tilopay.com/developers/skills/cierre-de-caja/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. Dame el cierre de caja de hoy ``` **Opción 2 · Instalar las seis de una vez en Claude (recomendada).** Tilopay publica sus skills como un plugin en GitHub. Se agrega una sola vez y queda guardado en tu cuenta: sirve en Cowork, en el chat de claude.ai y en Claude Code. El plugin incluye el conector del MCP de Tilopay: la primera vez que lo uses, Claude te pide autorizarlo con tu cuenta de Tilopay (en Cowork, desde la pestaña Connectors del plugin). En la app de Claude (Cowork): 1. Abrí la pestaña Cowork y luego Customize en la barra lateral. 2. Entrá a Plugins y hacé clic en Add → Add marketplace → Add from a repository. 3. Escribí `tilopay/claude-plugins` y confirmá. 4. Volvé a Discover, elegí tilopay-mcp-skills y hacé clic en Install. En Claude Code (terminal), dos comandos: ```text /plugin marketplace add tilopay/claude-plugins /plugin install tilopay-mcp-skills@tilopay ``` Desde ese momento, cuando pidas algo del tema («dame el cierre de caja de hoy») con el MCP de Tilopay conectado, Claude carga la skill sola. Para recibir mejoras, en el marketplace usá Check for updates o activá Sync automatically (en Claude Code: `/plugin marketplace update tilopay`).

Los plugins están disponibles en los planes de pago de Claude. Si tu organización limita qué marketplaces se pueden agregar, un Owner debe permitir tilopay/claude-plugins o sincronizarlo para todos desde la configuración de la organización.

**Opción 3 · Instalar una sola skill (claude.ai web y escritorio).** La forma más simple sin instalar nada: creá un Proyecto en Claude, abrí el `SKILL.md` de la skill (enlace de la tarjeta), copiá todo el contenido y pegalo en las instrucciones del proyecto. Para que el asistente la use en cualquier conversación, pegá el prompt de la opción 1 cuando lo necesites. **Opción 4 · A mano en Claude Code (sin marketplace).** Pegá este prompt en Claude Code: ```text Lee el índice de skills de Tilopay en https://tilopay.com/developers/skills/index.md, crea una carpeta por skill dentro de ~/.claude/skills/ con el nombre de la skill, guarda el SKILL.md de cada una dentro de su carpeta y luego dime qué skills quedaron instaladas. ``` El prompt le pide a Claude Code crear una carpeta por skill dentro de `~/.claude/skills/` (o en `.claude/skills/` del proyecto para compartirla con tu equipo), usando el `SKILL.md` publicado de cada una. **Otros clientes MCP.** Usá el `SKILL.md` como instrucciones del sistema o del proyecto, o pegá el prompt de la opción 1. ## Cómo funciona por dentro [#como-funciona] Con el cierre de caja como ejemplo, la secuencia es: 1. El agente convierte "hoy" a la hora local del comercio. 2. Llama `tilopay_list_transactions` con ese rango expresado en UTC. 3. Clasifica cada fila sólo por `code`: `1` es aprobada y `1101` es reembolso. 4. Suma los seis campos de costo con su nombre exacto: `commission`, `iva_commission`, `rent`, `retention_iva`, `cost` e `iva_tilopay`. 5. Valida que bruto − deducciones = neto y lo cruza con `tilopay_settlement_balance` antes de responder. Las skills nunca llaman herramientas que muevan dinero sin confirmación del comercio. ## Crear tu propia skill [#crear] La estructura mínima de un `SKILL.md` es un frontmatter con `name` y `description`, seguido del procedimiento: ```markdown --- name: mi-skill description: Qué hace la skill y cuándo debe usarla el agente. --- 1. Paso del procedimiento, con la herramienta exacta que se llama. 2. Regla de validación antes de responder. ``` Tres consejos: 1. Nombrá las herramientas exactas que el agente tiene que llamar. 2. Poné las reglas de validación de los números. 3. Decí qué NO hacer. Para conocer todas las herramientas disponibles, consultá el manifiesto [`/developers/mcp.json`](/developers/mcp.json). Si armaste una skill útil para otros comercios, enviala a [soporte@tilopay.com](mailto:soporte@tilopay.com).